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 le`InputType` paramètre pour étiqueter la catégorie sous la forme d'une`POST_CALL` ou d'une`REAL_TIME` catégorie. `POST_CALL`les catégories ne peuvent être appliquées qu'aux transcriptions après l'appel et les`REAL_TIME` catégories ne peuvent être appliquées qu'aux transcriptions en temps réel. Si vous ne l'incluez pas`InputType`, votre catégorie est créée en tant que`POST_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 :[InterruptionFilter](API_InterruptionFilter.md)[NonTalkTimeFilter](API_NonTalkTimeFilter.md),[SentimentFilter](API_SentimentFilter.md), et[TranscriptFilter](API_TranscriptFilter.md).
Pour mettre à jour une catégorie existante, consultez[UpdateCallAnalyticsCategory](API_UpdateCallAnalyticsCategory.md).
Pour en savoir plus sur les catégories d'analyse des appels, voir [Création de catégories pour les transcriptions post-appel](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html) et [Création de catégories pour les transcriptions en temps réel](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html).
## 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](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [CategoryName](#API_CreateCallAnalyticsCategory_RequestSyntax) **
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'utiliser`sentiment-positive-last30seconds` pour une catégorie plutôt qu'un nom générique comme`test-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](#API_CreateCallAnalyticsCategory_RequestSyntax) **
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écification`POST_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écification`REAL_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 pas`InputType`, 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](#API_CreateCallAnalyticsCategory_RequestSyntax) **
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](API_Rule.md)
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](#API_CreateCallAnalyticsCategory_ResponseSyntax) **
Vous fournit les propriétés de votre nouvelle catégorie, y compris les règles associées.
Type : objet [CategoryProperties](API_CategoryProperties.md)
## Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).
** 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 exemple`IN 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 :
+ [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateCallAnalyticsCategory)
+ [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateCallAnalyticsCategory)
+ [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateCallAnalyticsCategory)
+ [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateCallAnalyticsCategory)
+ [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateCallAnalyticsCategory)
+ [AWSSDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateCallAnalyticsCategory)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateCallAnalyticsCategory)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateCallAnalyticsCategory)
+ [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateCallAnalyticsCategory)