

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á.

# Criar categorias para transcrições pós-chamada
<a name="tca-categories-batch"></a>

Post-call a análise suporta a criação de categorias personalizadas, permitindo que você adapte suas análises de transcrição para melhor atender às suas necessidades comerciais específicas.

Você pode criar quantas categorias quiser para abranger uma variedade de cenários diferentes. Para cada categoria criada, você deve criar entre 1 e 20 regras. Cada regra é baseada em um destes quatro critérios: interrupções, palavras-chave, tempo sem conversa ou sentimento. Para obter mais detalhes sobre o uso desses critérios com a operação [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html), consulte a seção [Critérios de regras para categorias de análise pós-chamada](#tca-rules-batch).

Se o conteúdo da mídia corresponder a todas as regras que você especificou em determinada categoria, o Amazon Transcribe rotulará a saída com essa categoria. Consulte a [saída de categorização de chamadas](tca-output-batch.md#tca-output-categorization-batch) para ver um exemplo de correspondência de categoria na saída JSON.

Veja a seguir alguns exemplos do que você pode fazer com categorias personalizadas:
+ Isolar chamadas com características específicas, como chamadas que terminam com um sentimento negativo do cliente.
+ Identificar tendências nos problemas dos clientes sinalizando e rastreando conjuntos específicos de palavras-chave.
+ Monitorar a conformidade; por exemplo, um atendente que está falando (ou omitindo) uma frase específica durante os primeiros segundos de uma chamada.
+ Obter insights sobre a experiência do cliente sinalizando chamadas em que há muitas interrupções por parte dos atendentes e sentimentos negativos do cliente
+ Comparar várias categorias para avaliar as correlações; por exemplo, analisar se uma frase de boas-vindas usada pelo atendente se correlaciona com o sentimento positivo do cliente.

**Post-call versus categorias em tempo real**

Ao criar uma categoria, você pode especificar se deseja que ela seja criada como uma categoria de análise pós-chamada (`POST_CALL`) ou como uma categoria de análise de chamadas em tempo real (`REAL_TIME`). Se você não especificar uma opção, sua categoria será criada como uma categoria pós-chamada por padrão. Post-call as correspondências de categorias de análise estão disponíveis em sua saída após a conclusão da transcrição da análise pós-chamada.

Para criar uma categoria para análise pós-chamada, você pode usar o **Console de gerenciamento da AWS**, a **AWS CLI** ou os **AWS SDKs**. Veja os seguintes exemplos:

## Console de gerenciamento da AWS
<a name="tca-category-console-batch"></a>

1. No painel de navegação, em Amazon Transcribe, escolha **Análise de Amazon Transcribe chamadas**.

1. Escolha **Categorias de análise de chamadas**, que levará você à página **Categorias de análise de chamadas**. Selecione **Criar categoria**.  
![Amazon Transcribe captura de tela do console: a página de 'categorias' do Call Analytics.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-categories.png)

1. Agora você está na página **Criar categoria**. Insira um nome para a categoria e escolha “Análise de chamadas em lote” no menu suspenso **Tipo de categoria**.  
![Amazon Transcribe captura de tela do console: o painel de 'configurações de categoria'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-categories-type.png)

1. Você pode escolher um modelo para criar a categoria ou criar uma do zero.

   Se estiver usando um modelo: selecione **Usar um modelo (recomendado)**, escolha o modelo desejado e selecione **Criar categoria**.  
![Amazon Transcribe captura de tela do console: o painel de 'configurações de categoria' mostrando modelos opcionais.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-categories-settings-batch.png)

1. Se estiver criando uma categoria personalizada: selecione **Criar do zero**.  
![Amazon Transcribe captura de tela do console: a página “criar categoria” mostrando o painel “regras”.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-categories-custom.png)

1. Adicione regras à categoria usando o menu suspenso. Você pode adicionar até vinte regras por categoria.  
![Amazon Transcribe captura de tela do console: o painel 'regras' com a lista de tipos de regras.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-categories-custom-rules1.png)

1. Veja um exemplo de uma categoria com duas regras: um atendente que interrompe um cliente por mais de 15 segundos durante a chamada e um sentimento negativo do cliente ou do atendente nos últimos 2 minutos da chamada.  
![Amazon Transcribe captura de tela do console: o painel 'regras' com dois exemplos de regras.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-categories-custom-rules2.png)

1. Quando terminar de adicionar regras à sua categoria, escolha **Criar categoria**.

## AWS CLI
<a name="tca-category-cli-batch"></a>

Este exemplo usa o comando [create-call-analytics-category](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/create-call-analytics-category.html). Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CategoryProperties.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CategoryProperties.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Rule.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Rule.html).

O seguinte exemplo cria uma categoria com as regras:
+ O cliente foi interrompido nos primeiros 60.000 milissegundos. A duração dessas interrupções durou pelo menos 10.000 milissegundos.
+ Houve um período de silêncio que durou pelo menos 20.000 milissegundos entre 10% da chamada e 80% da chamada.
+ O atendente teve um sentimento negativo em algum momento da chamada.
+ As palavras “bem-vindo” ou “olá” não foram usadas nos primeiros 10.000 da chamada.

Este exemplo usa o comando [create-call-analytics-category](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/create-call-analytics-category.html) e um corpo de solicitação que adiciona várias regras à categoria.

```
aws transcribe create-call-analytics-category \
--cli-input-json file://{{filepath}}/{{my-first-analytics-category}}.json
```

O arquivo *my-first-analytics-category.json* contém o corpo da solicitação a seguir.

```
{
  "CategoryName": "{{my-new-category}}",
  "InputType": "{{POST_CALL}}",
  "Rules": [
        {
            "InterruptionFilter": {
                "AbsoluteTimeRange": {
                    "First": {{60000}}
                },
                "Negate": {{false}},
                "ParticipantRole": "{{CUSTOMER}}",
                "Threshold": {{10000}}
            }
        },
        {
            "NonTalkTimeFilter": {
                "Negate": {{false}},
                "RelativeTimeRange": {
                    "EndPercentage": {{80}},
                    "StartPercentage": {{10}}
                },
                "Threshold": {{20000}}
            }
        },
        {
            "SentimentFilter": {
                "ParticipantRole": "{{AGENT}}",
                "Sentiments": [
                    "{{NEGATIVE}}"                    
                ]
            }
        },
        {
            "TranscriptFilter": {
                "Negate": {{true}},
                "AbsoluteTimeRange": {
                    "First": {{10000}}
                },
                "Targets": [
                    "{{welcome}}",
                    "{{hello}}"
                ],
                "TranscriptFilterType": "{{EXACT}}"
            }
        }
    ]
}
```

## AWS SDK para Python (Boto3)
<a name="tca-category-python-batch"></a>

Este exemplo usa o AWS SDK para Python (Boto3) para criar uma categoria usando os `Rules` argumentos `CategoryName` e para o método [create\_call\_analytics\_category](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_call_analytics_category). Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CategoryProperties.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CategoryProperties.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Rule.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Rule.html).

Para ver exemplos adicionais de uso dos AWS SDKs, incluindo exemplos específicos de recursos, cenários e entre serviços, consulte o capítulo. [Exemplos de código para o Amazon Transcribe usando AWS SDKs](service_code_examples.md)

O seguinte exemplo cria uma categoria com as regras:
+ O cliente foi interrompido nos primeiros 60.000 milissegundos. A duração dessas interrupções durou pelo menos 10.000 milissegundos.
+ Houve um período de silêncio que durou pelo menos 20.000 milissegundos entre 10% da chamada e 80% da chamada.
+ O atendente teve um sentimento negativo em algum momento da chamada.
+ As palavras “bem-vindo” ou “olá” não foram usadas nos primeiros 10.000 da chamada.

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
category_name = "{{my-new-category}}"
transcribe.create_call_analytics_category(
    CategoryName = category_name,
    InputType = {{POST_CALL}},
    Rules = [
        {
            'InterruptionFilter': {
                'AbsoluteTimeRange': {
                    'First': {{60000}}
                },
                'Negate': {{False}},
                'ParticipantRole': '{{CUSTOMER}}',
                'Threshold': {{10000}}
            }
        },
        {
            'NonTalkTimeFilter': {
                'Negate': {{False}},
                'RelativeTimeRange': {
                    'EndPercentage': {{80}},
                    'StartPercentage': {{10}}
                },
                'Threshold': {{20000}}
            }
        },
        {
            'SentimentFilter': {
                'ParticipantRole': '{{AGENT}}',
                'Sentiments': [
                    '{{NEGATIVE}}'                    
                ]
            }
        },
        {
            'TranscriptFilter': {
                'Negate': {{True}},
                'AbsoluteTimeRange': {
                    'First': {{10000}}
                },
                'Targets': [
                    '{{welcome}}',
                    '{{hello}}'
                ],
                'TranscriptFilterType': '{{EXACT}}'
            }
        }
    ]
    
)

result = transcribe.get_call_analytics_category(CategoryName = category_name)    
print(result)
```

## Critérios de regras para categorias de análise pós-chamada
<a name="tca-rules-batch"></a>

Esta seção descreve os tipos de regras personalizadas `POST_CALL` que podem ser criadas usando a operação de API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html).

### Correspondência de interrupção
<a name="tca-rules-interruptions-batch"></a>

As regras que usam interrupções (tipo de dados [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_InterruptionFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_InterruptionFilter.html)) foram projetadas para corresponder a:
+ Instâncias em que um atendente interrompe um cliente
+ Situações em que um cliente interrompe um atendente
+ Interrupção de qualquer um dos participantes
+ Falta de interrupções

Veja abaixo um exemplo dos parâmetros disponíveis com [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_InterruptionFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_InterruptionFilter.html):

```
"InterruptionFilter": { 
    "AbsoluteTimeRange": { 
       {{Specify the time frame, in milliseconds, when the match should occur}}
    },
    "RelativeTimeRange": { 
       {{Specify the time frame, in percentage, when the match should occur}}
    },
    "Negate": {{Specify if you want to match the presence or absence of interruptions}},
    "ParticipantRole": {{Specify if you want to match speech from the agent, the customer, or both}},    
    "Threshold": {{Specify a threshold for the amount of time, in seconds, interruptions occurred during the call}}
},
```

Consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_InterruptionFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_InterruptionFilter.html) para obter mais informações sobre esses parâmetros e os valores válidos associados a cada um.

### Correspondência de palavras-chave
<a name="tca-rules-keywords-batch"></a>

As regras que usam palavras-chave (tipo de dados [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html)) foram criadas para corresponder a:
+ Palavras ou frases personalizadas faladas pelo atendente, pelo cliente ou por ambos
+ Palavras ou frases personalizadas **não** ditas pelo atendente, pelo cliente ou por ambos
+ Palavras ou frases personalizadas que ocorrem em um período específico

Veja abaixo um exemplo dos parâmetros disponíveis com [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html):

```
"TranscriptFilter": { 
    "AbsoluteTimeRange": { 
       {{Specify the time frame, in milliseconds, when the match should occur}}
    },
    "RelativeTimeRange": { 
       {{Specify the time frame, in percentage, when the match should occur}}
    },
    "Negate": {{Specify if you want to match the presence or absence of your custom keywords}},
    "ParticipantRole": {{Specify if you want to match speech from the agent, the customer, or both}},
    "Targets": [ {{The custom words and phrases you want to match}} ],
    "TranscriptFilterType": {{Use this parameter to specify an exact match for the specified targets}}
}
```

Consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html) para obter mais informações sobre esses parâmetros e os valores válidos associados a cada um.

### Non-talk partida de tempo
<a name="tca-rules-nontalktime-batch"></a>

As regras que usam tempo sem conversa (tipo de dados [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_NonTalkTimeFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_NonTalkTimeFilter.html)) foram projetadas para corresponder a:
+ Presença de silêncio em períodos específicos durante a chamada
+ Presença de fala em períodos específicos durante a chamada

Veja abaixo um exemplo dos parâmetros disponíveis com [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_NonTalkTimeFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_NonTalkTimeFilter.html):

```
"NonTalkTimeFilter": { 
    "AbsoluteTimeRange": { 
 {{Specify the time frame, in milliseconds, when the match should occur}}
 },
    "RelativeTimeRange": { 
 {{Specify the time frame, in percentage, when the match should occur}}
 },
    "Negate": {{Specify if you want to match the presence or absence of speech}},      
    "Threshold": {{Specify a threshold for the amount of time, in seconds, silence (or speech) occurred during the call}}
},
```

Consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_NonTalkTimeFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_NonTalkTimeFilter.html) para obter mais informações sobre esses parâmetros e os valores válidos associados a cada um.

### Correspondência de sentimentos
<a name="tca-rules-sentiment-batch"></a>

As regras que usam sentimento (tipo de dados [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_SentimentFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_SentimentFilter.html)) foram criadas para corresponder a:
+ Presença ou ausência de um sentimento positivo expresso pelo cliente, pelo atendente ou por ambos em pontos específicos da chamada
+ Presença ou ausência de um sentimento negativo expresso pelo cliente, pelo atendente ou por ambos em pontos específicos da chamada
+ Presença ou ausência de um sentimento neutro expresso pelo cliente, pelo atendente ou por ambos em pontos específicos da chamada
+ Presença ou ausência de um sentimento misto expresso pelo cliente, pelo atendente ou por ambos em pontos específicos da chamada

Veja abaixo um exemplo dos parâmetros disponíveis com [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_SentimentFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_SentimentFilter.html):

```
"SentimentFilter": { 
    "AbsoluteTimeRange": { 
    {{Specify the time frame, in milliseconds, when the match should occur}}
    },
    "RelativeTimeRange": { 
    {{Specify the time frame, in percentage, when the match should occur}}
    },
    "Negate": {{Specify if you want to match the presence or absence of your chosen sentiment}},
    "ParticipantRole": {{Specify if you want to match speech from the agent, the customer, or both}},    
    "Sentiments": [ {{The sentiments you want to match}} ]
},
```

Consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateCallAnalyticsCategory.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_SentimentFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_SentimentFilter.html) para obter mais informações sobre esses parâmetros e os valores válidos associados a cada um.