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

# Iniciar uma transcrição de análise pós-chamada
<a name="tca-start-batch"></a>

Antes de iniciar uma transcrição de análise pós-chamada, você deve criar todas as [categorias](tca-categories-batch.md) que deseja Amazon Transcribe combinar em seu áudio.

**nota**  
As transcrições do Call Analytics não podem ser combinadas retroativamente com novas categorias. Somente as categorias que você cria *antes* de iniciar uma transcrição do Call Analytics podem ser aplicadas a essa saída de transcrição.

Se você criou uma ou mais categorias e seu áudio corresponde a todas as regras em pelo menos uma de suas categorias, o Amazon Transcribe sinaliza a saída com a categoria correspondente. Se você optar por não usar categorias ou se o áudio não corresponder às regras especificadas nas categorias, sua transcrição não será sinalizada.

Para iniciar uma transcrição de 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="analytics-start-console-batch"></a>

Siga o procedimento a seguir para iniciar um trabalho de análise pós-chamada. As chamadas que correspondem a todas as características definidas por uma categoria são rotuladas com essa categoria.

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

1. Escolha **Criar trabalho**.  
![Amazon Transcribe captura de tela do console: a página “Trabalhos do Call Analytics”.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start.png)

1. Na página **Especificar os detalhes da tarefa**, forneça informações sobre o trabalho de análise de chamadas, incluindo a localização dos dados de entrada.  
![Amazon Transcribe captura de tela do console: a página “especificar detalhes do trabalho”.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-settings1.png)

   Especifique a Amazon S3 localização desejada dos dados de saída e qual IAM função usar.  
![Amazon Transcribe captura de tela do console: o painel de 'permissões de acesso'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-settings2.png)

1. Escolha **Próximo**.

1. Em **Configurar tarefa**, ative os recursos opcionais que você deseja incluir no trabalho de análise de chamadas. Se você criou categorias anteriormente, elas aparecem no painel **Categorias** e são aplicadas automaticamente ao trabalho de análise de chamadas.  
![Amazon Transcribe captura de tela do console: a página 'configurar trabalho' mostrando todas as categorias personalizadas.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-configure.png)

1. Escolha **Criar trabalho**.

## AWS CLI
<a name="analytics-start-cli"></a>

Este exemplo usa o comando [start-call-analytics-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-call-analytics-job.html) e o parâmetro `channel-definitions`. Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ChannelDefinition.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ChannelDefinition.html).

```
aws transcribe start-call-analytics-job \
--region {{us-west-2}} \
--call-analytics-job-name {{my-first-call-analytics-job}} \
--media MediaFileUri=s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}} \
--output-location s3://{{amzn-s3-demo-bucket}}/{{my-output-files}}/ \
--data-access-role-arn arn:aws:iam::{{111122223333}}:role/{{ExampleRole}} \
--channel-definitions ChannelId=0,ParticipantRole={{AGENT}} ChannelId=1,ParticipantRole={{CUSTOMER}}
```

Veja está outro exemplo que usa o comando [start-call-analytics-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-call-analytics-job.html) e um corpo de solicitação que habilita o Call Analytics para esse trabalho.

```
aws transcribe start-call-analytics-job \
--region {{us-west-2}} \
--cli-input-json file://{{filepath}}/{{my-call-analytics-job}}.json
```

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

```
{
      "CallAnalyticsJobName": "{{my-first-call-analytics-job}}",
      "DataAccessRoleArn": "arn:aws:iam::{{111122223333}}:role/{{ExampleRole}}",
      "Media": {
          "MediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
      },
      "OutputLocation": "s3://{{amzn-s3-demo-bucket}}/{{my-output-files}}/",
      "ChannelDefinitions": [
          {
              "ChannelId": 0,
              "ParticipantRole": "{{AGENT}}"
          },
          {
              "ChannelId": 1,
              "ParticipantRole": "{{CUSTOMER}}"
          }
      ]
}
```

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

Este exemplo usa o AWS SDK para Python (Boto3) para iniciar um trabalho do Call Analytics usando o método [start\_call\_analytics\_job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_call_analytics_job). Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ChannelDefinition.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ChannelDefinition.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)

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
job_name = "{{my-first-call-analytics-job}}"
job_uri = "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
output_location = "s3://{{amzn-s3-demo-bucket}}/{{my-output-files}}/"
data_access_role = "arn:aws:iam::{{111122223333}}:role/{{ExampleRole}}"
transcribe.start_call_analytics_job(
     CallAnalyticsJobName = job_name,
     Media = {
        'MediaFileUri': job_uri
     },
     DataAccessRoleArn = data_access_role,
     OutputLocation = output_location,
     ChannelDefinitions = [
        {
            'ChannelId': 0, 
            'ParticipantRole': '{{AGENT}}'
        },
        {
            'ChannelId': 1, 
            'ParticipantRole': '{{CUSTOMER}}'
        }
     ]
)
    
 while True:
   status = transcribe.get_call_analytics_job(CallAnalyticsJobName = job_name)
   if status['CallAnalyticsJob']['CallAnalyticsJobStatus'] in ['COMPLETED', 'FAILED']:
     break
   print("Not ready yet...")
   time.sleep(5)
 print(status)
```