As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
UpdateCallAnalyticsCategory
Atualiza a categoria de análise de chamadas especificada com novas regras. Observe que aUpdateCallAnalyticsCategory
operação sobrescreve todas as regras existentes contidas na categoria especificada. Você não pode acrescentar regras adicionais a uma categoria existente.
Para criar uma nova categoria, consulteCreateCallAnalyticsCategory.
Sintaxe da solicitação
{
"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
"
}
}
]
}
Parâmetros de solicitação
Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte Parâmetros comuns.
A solicitação aceita os dados a seguir no formato JSON.
- CategoryName
-
O nome da categoria de análise de chamadas que você deseja atualizar. Os nomes de categoria diferenciam letras maiúsculas.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.
Padrão:
^[0-9a-zA-Z._-]+
Obrigatório: Sim
- InputType
-
Escolha se você deseja atualizar uma categoria em tempo real ou pós-chamada. O tipo de entrada que você especificar deve corresponder ao tipo de entrada especificado quando a categoria foi criada. Por exemplo, se você criou uma categoria com o tipo
POST_CALL
de entrada, deverá usá-laPOST_CALL
como o tipo de entrada ao atualizar essa categoria.Tipo: String
Valores válidos:
REAL_TIME | POST_CALL
Obrigatório: não
- Rules
-
As regras usadas para a categoria atualizada de análise de chamadas. As regras que você fornece nesse campo substituem as que estão sendo usadas atualmente na categoria especificada.
Tipo: matriz de objetos Rule
Membros da matriz: número mínimo de 1 item. Número máximo de 20 itens.
Obrigatório: Sim
Sintaxe da resposta
{
"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"
}
}
]
}
}
Elementos de resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.
Os seguintes dados são retornados no formato JSON pelo serviço.
- CategoryProperties
-
Fornece as propriedades da categoria Call Analytics que você especificou em sua
UpdateCallAnalyticsCategory
solicitação.Tipo: objeto CategoryProperties
Erros
Para obter informações sobre os erros comuns a todas as ações, consulteErros comuns.
- BadRequestException
-
Sua solicitação não passou em um ou mais testes de validação. Isso pode ocorrer quando a entidade que você está tentando excluir não existe ou está em um estado não terminal (como
IN PROGRESS
). Consulte o campo da mensagem de exceção para obter mais informações.Código de status HTTP: 400
- ConflictException
-
Já existe um recurso com esse nome. Os nomes de recurso devem ser exclusivos dentro de umConta da AWS.
Código de status HTTP: 400
- InternalFailureException
-
Ocorreu um erro interno. Verifique a mensagem de erro, corrija o problema e tente fazer sua solicitação novamente.
Código de status HTTP: 500
- LimitExceededException
-
Você enviou muitas solicitações ou seu arquivo de entrada é muito longo. Aguarde antes de tentar novamente sua solicitação ou use um arquivo menor e tente fazer sua solicitação novamente.
Código de status HTTP: 400
- NotFoundException
-
Não conseguimos encontrar o recurso solicitado. Verifique se o nome especificado está correto e tente fazer sua solicitação novamente.
Código de status HTTP: 400
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: