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.
UpdateCallAnalyticsCategory
Met à jour la catégorie Call Analytics spécifiée avec de nouvelles règles. Notez que l'UpdateCallAnalyticsCategory
opération remplace toutes les règles existantes contenues dans la catégorie spécifiée. Vous ne pouvez pas ajouter de règles supplémentaires à une catégorie existante.
Pour créer une nouvelle catégorie, reportez-vous à la sectionCreateCallAnalyticsCategory.
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, consultez la section Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- CategoryName
-
Nom de la catégorie Call Analytics que vous souhaitez mettre à jour. 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 mettre à jour une catégorie en temps réel ou après l'appel. Le type d'entrée que vous spécifiez doit correspondre au type d'entrée spécifié lors de la création de la catégorie. Par exemple, si vous avez créé une catégorie avec le type
POST_CALL
d'entrée, vous devez l'utiliserPOST_CALL
comme type d'entrée lors de la mise à jour de cette catégorie.Type : String
Valeurs valides :
REAL_TIME | POST_CALL
Obligatoire : non
- Rules
-
Les règles utilisées pour la catégorie Call Analytics mise à jour. Les règles que vous fournissez dans ce champ remplacent celles qui sont actuellement utilisées dans la catégorie spécifiée.
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 la catégorie Call Analytics que vous avez spécifiée dans votre
UpdateCallAnalyticsCategory
demande.Type : objet CategoryProperties
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, reportez-vous à la sectionErreurs courantes.
- BadRequestException
-
Votre demande n'a pas réussi un ou plusieurs tests de validation. Cela peut se produire lorsque l'entité que vous essayez de supprimer n'existe pas ou si elle n'est pas dans un état terminal (par exemple
IN PROGRESS
). Pour plus d'informations, consultez le champ du message d'exception.Code d'état HTTP : 400
- ConflictException
-
Il existe déjà une ressource portant ce nom. Les noms des ressources 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 votre demande.
Code d'état HTTP : 500
- LimitExceededException
-
Soit vous avez envoyé trop de demandes, soit votre fichier d'entrée est trop long. Attendez avant de réessayer votre demande, ou utilisez un fichier plus petit et réessayez votre demande.
Code d'état HTTP : 400
- NotFoundException
-
Nous ne trouvons pas la ressource demandée. Vérifiez que le nom indiqué est correct et réessayez votre demande.
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 :