CreateCallAnalyticsCategory - Transcribe
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CreateCallAnalyticsCategory

Crée une nouvelle catégorie d'analyse des appels.

Toutes les catégories sont automatiquement appliquées à vos transcriptions d'Call Analytics. Notez que pour appliquer des catégories à vos transcriptions, vous devez les créer avant de soumettre votre demande de transcription, car les catégories ne peuvent pas être appliquées rétroactivement.

Lorsque vous créez une nouvelle catégorie, vous pouvez utiliser leInputType paramètre pour étiqueter la catégorie sous la forme d'unePOST_CALL ou d'uneREAL_TIME catégorie. POST_CALLles catégories ne peuvent être appliquées qu'aux transcriptions après l'appel et lesREAL_TIME catégories ne peuvent être appliquées qu'aux transcriptions en temps réel. Si vous ne l'incluez pasInputType, votre catégorie est créée en tant quePOST_CALL catégorie par défaut.

Les catégories d'analyse des appels sont composées de règles. Pour chaque catégorie, vous devez créer entre 1 et 20 règles. Les règles peuvent inclure les paramètres suivants :InterruptionFilterNonTalkTimeFilter,SentimentFilter, etTranscriptFilter.

Pour mettre à jour une catégorie existante, consultezUpdateCallAnalyticsCategory.

Pour en savoir plus sur les catégories d'analyse des appels, voir Création de catégories pour les transcriptions post-appel et Création de catégories pour les transcriptions en temps réel.

Syntaxe de la requête

{
   "CategoryName": "string",
   "InputType": "string",
   "Rules": [ 
      { 
         "InterruptionFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Threshold": number
         },
         "NonTalkTimeFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Threshold": number
         },
         "SentimentFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Sentiments": [ "string" ]
         },
         "TranscriptFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Targets": [ "string" ],
            "TranscriptFilterType": "string"
         }
      }
   ]
}

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, voir Paramètres communs.

Cette demande accepte les données suivantes au format JSON.

CategoryName

Un nom unique, que vous avez choisi, pour votre catégorie Call Analytics. Il est utile d'utiliser un système de dénomination détaillé qui vous conviendra à l'future. Par exemple, il est préférable de l'utilisersentiment-positive-last30seconds pour une catégorie plutôt qu'un nom générique commetest-category.

Les noms de catégorie sont sensibles à la casse.

Type : String

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200.

Modèle : ^[0-9a-zA-Z._-]+

Obligatoire : oui

InputType

Choisissez si vous souhaitez créer une catégorie en temps réel ou après l'appel pour la transcription de votre Call Analytics.

La spécificationPOST_CALL attribue votre catégorie aux transcriptions post-appel ; les catégories avec ce type d'entrée ne peuvent pas être appliquées aux transcriptions en continu (en temps réel).

La spécificationREAL_TIME affecte votre catégorie aux transcriptions en continu ; les catégories avec ce type d'entrée ne peuvent pas être appliquées aux transcriptions après un appel.

Si vous ne l'incluez pasInputType, votre catégorie est créée en tant que catégorie post-appel par défaut.

Type : String

Valeurs valides : REAL_TIME | POST_CALL

Obligatoire : non

Rules

Les règles définissent une catégorie d'analyse des appels. Lorsque vous créez une nouvelle catégorie, vous devez créer entre 1 et 20 règles pour cette catégorie. Pour chaque règle, vous spécifiez un filtre que vous souhaitez appliquer aux attributs d'un appel. Par exemple, vous pouvez choisir un filtre de sentiment qui détecte si le sentiment d'un client était positif au cours des 30 dernières secondes de l'appel.

Type : tableau d’objets Rule

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 20 éléments.

Obligatoire : oui

Syntaxe de la réponse

{
   "CategoryProperties": { 
      "CategoryName": "string",
      "CreateTime": number,
      "InputType": "string",
      "LastUpdateTime": number,
      "Rules": [ 
         { 
            "InterruptionFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Threshold": number
            },
            "NonTalkTimeFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Threshold": number
            },
            "SentimentFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Sentiments": [ "string" ]
            },
            "TranscriptFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Targets": [ "string" ],
               "TranscriptFilterType": "string"
            }
         }
      ]
   }
}

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

CategoryProperties

Vous fournit les propriétés de votre nouvelle catégorie, y compris les règles associées.

Type : objet CategoryProperties

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.

BadRequestException

Votre demande n'a pas passé un ou plusieurs tests de validation. Cela peut se produire lorsque l'entité que vous essayez de supprimer n'existe pas ou si elle est dans un état non terminal (par exempleIN PROGRESS). Consultez le champ du message d'exception pour plus d'informations.

Code d'état HTTP : 400

ConflictException

Il existe déjà une ressource portant ce nom. Les noms de ressource doivent être uniques dans unCompte AWS.

Code d'état HTTP : 400

InternalFailureException

Une erreur interne s'est produite. Vérifiez le message d'erreur, corrigez le problème et réessayez de répondre à votre demande.

Code d'état HTTP : 500

LimitExceededException

Vous avez envoyé trop de demandes ou votre fichier d'entrée est trop long. Patientez avant de réessayer votre demande, ou utilisez un fichier plus petit et réessayez.

Code d'état HTTP : 400

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :