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 do Call Analytics em tempo real
Antes de iniciar uma transcrição do Call Analytics em tempo real, você deve criar todas as [categorias](tca-categories-stream.md) que Amazon Transcribe deseja combinar em sua chamada.
**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ê tiver criado uma ou mais categorias e o áudio corresponder a todas as regras de pelo menos uma das categorias, o Amazon Transcribe marcará a saída com as categorias correspondentes. 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 incluir a análise pós-chamada na transcrição do Call Analytics em tempo real, você deve fornecer um bucket do Amazon S3 na solicitação usando o parâmetro `OutputLocation`. Você também deve incluir um `DataAccessRoleArn` que tenha permissões de gravação no bucket especificado. Uma transcrição separada é produzida e armazenada no bucket especificado após a conclusão da sessão de streaming do Call Analytics em tempo real.
Com o Call Analytics em tempo real, você também tem a opção de criar alertas de categoria em tempo real. Consulte [Criar alertas em tempo real para correspondências de categorias](#tca-create-alert-stream) para obter instruções.
Para iniciar uma transcrição do Call Analytics em tempo real, você pode usar o **Console de gerenciamento da AWS****HTTP/2** ou **WebSockets**; veja exemplos a seguir:
**Importante**
Atualmente, a Console de gerenciamento da AWS única oferece uma demonstração para análise de chamadas em tempo real com exemplos de áudio pré-carregados. Se quiser usar seu próprio áudio, você deve usar a API (HTTP/2 ou um SDK). WebSockets
## Console de gerenciamento da AWS
Use o procedimento a seguir para iniciar uma solicitação do Call Analytics. As chamadas que correspondem a todas as características definidas por uma categoria são rotuladas com essa categoria.
**nota**
Somente uma demonstração está disponível no Console de gerenciamento da AWS. Para iniciar uma transcrição personalizada de análise em tempo real, você deve usar a [API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html).
1. No painel de navegação, em Análise de Amazon Transcribe chamadas, escolha **Analisar uma chamada em tempo real**.
![\[Amazon Transcribe captura de tela do console: a página de demonstração “analisar uma chamada de streaming”.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-stream.png)
1. Para **Etapa 1: especificar áudio de entrada**, escolha um arquivo de teste de demonstração no menu suspenso.
![\[Amazon Transcribe captura de tela do console: uma seleção suspensa para o áudio de entrada da demonstração.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-stream-settings1.png)
1. Para a **Etapa 2: revisar categorias de chamada**, você tem a opção de revisar as categorias de análise de chamadas em tempo real que criou anteriormente. Todas as categorias de análise de chamadas em tempo real são aplicadas à transcrição.
Escolher **Exibir categorias** abre um novo painel que mostra as categorias existentes de análise de chamadas em tempo real e fornece um link para criar outras.
![\[Amazon Transcribe captura de tela do console: a página “categorias de análise de chamadas”.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-stream-settings2.png)
1. Para **Etapa 3: configurar entrada e saída**, você tem a opção de aplicar configurações adicionais.
Escolher **Definir configurações avançadas** abre um novo painel onde você pode especificar as configurações de edição de conteúdo.
![\[Amazon Transcribe captura de tela do console: os painéis de configurações avançadas, todos fechados.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-stream-settings3.png)
Depois de fazer todas as seleções, escolha **Salvar** para retornar à página principal.
1. Para aplicar análises adicionais, você pode ativar a **Análise pós-chamada**. Isso fornece a mesma análise de uma transcrição de análise pós-chamada, incluindo interrupções, volume, tempo sem conversa, velocidade da conversa, tempo de conversa, problemas, itens de ação e resultados. A saída da análise pós-chamada é armazenada em um arquivo separado da transcrição do Call Analytics em tempo real.
![\[Amazon Transcribe captura de tela do console: o painel de análise pós-chamada, fechado.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-stream-post-call1.png)
Se você aplicar a análise pós-chamada, deverá especificar um destino Amazon S3 de arquivo de saída e uma IAM função. Se preferir, você poderá criptografar a saída.
![\[Amazon Transcribe captura de tela do console: o painel de análise pós-chamada, expandido.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/analytics-start-stream-post-call1a.png)
1. Selecione **Start streaming** (Iniciar transmissão).
## Fluxo HTTP/2
Este exemplo cria uma solicitação HTTP/2 com o Call Analytics habilitado. Para obter mais informações sobre como usar o streaming HTTP/2 com Amazon Transcribe, consulte. [Configurar um fluxo de HTTP/2](streaming-setting-up.md#streaming-http2) Para obter mais detalhes sobre parâmetros e cabeçalhos específicos de Amazon Transcribe, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html).
Esse exemplo inclui [análises pós-chamada](tca-post-call.md). Se não quiser análises pós-chamada, remova a seção `PostCallAnalyticsSettings` da solicitação.
Observe que o evento de configuração mostrado no exemplo a seguir precisa ser passado como o primeiro evento no fluxo.
```
POST /stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartCallAnalyticsStreamTranscription
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: string
X-Amz-Date: 20220208T235959Z
Authorization: AWS4-HMAC-SHA256 Credential=access-key/20220208/us-west-2/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature=string
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000
transfer-encoding: chunked
{
"AudioStream": {
"AudioEvent": {
"AudioChunk": blob
},
"ConfigurationEvent": {
"ChannelDefinitions": [
{
"ChannelId": 0,
"ParticipantRole": "AGENT"
},
{
"ChannelId": 1,
"ParticipantRole": "CUSTOMER"
}
],
"PostCallAnalyticsSettings": {
"OutputLocation": "s3://amzn-s3-demo-bucket/my-output-files/",
"DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
}
}
}
}
```
As definições de parâmetros podem ser encontradas na [Referência da API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); os parâmetros comuns a todas as operações AWS da API estão listados na seção [Parâmetros comuns](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
## WebSocket stream
Este exemplo cria uma URL pré-assinada que usa o Call Analytics em um WebSocket stream. Quebras de linha foram adicionadas para uma melhor leitura. Para obter mais informações sobre o uso de WebSocket fluxos com Amazon Transcribe, consulte[Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). Para obter mais detalhes sobre os parâmetros, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html).
Esse exemplo inclui [análises pós-chamada](tca-post-call.md). Se não quiser análises pós-chamada, remova a seção `PostCallAnalyticsSettings` da solicitação.
Observe que o evento de configuração mostrado no exemplo a seguir precisa ser passado como o primeiro evento no fluxo.
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/call-analytics-stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=string
&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date
&language-code=en-US
&media-encoding=flac
&sample-rate=16000
{
"AudioStream": {
"AudioEvent": {
"AudioChunk": blob
},
"ConfigurationEvent": {
"ChannelDefinitions": [
{
"ChannelId": 0,
"ParticipantRole": "AGENT"
},
{
"ChannelId": 1,
"ParticipantRole": "CUSTOMER"
}
],
"PostCallAnalyticsSettings": {
"OutputLocation": "s3://amzn-s3-demo-bucket/my-output-files/",
"DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
}
}
}
}
```
As definições de parâmetros podem ser encontradas na [Referência da API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); os parâmetros comuns a todas as operações AWS da API estão listados na seção [Parâmetros comuns](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
**dica**
O HTTP/2 e os WebSocket exemplos acima incluem análises pós-chamada. Se não quiser análises pós-chamada, remova a seção `PostCallAnalyticsSettings` da solicitação.
Se você habilitar `PostCallAnalyticsSettings`, deverá enviar um evento de configuração como o primeiro evento. O evento de configuração inclui configurações para `ChannelDenifitions` e `PostStreamAnalyticsSettings`, conforme mostrado nos exemplos anteriores.
Os dados binários são transmitidos como uma mensagem binária com `content-type application/octet-stream` e o evento de configuração é transmitido como uma mensagem de texto com `content-type application/json`.
Para obter mais informações, consulte [Configurar uma transcrição de streaming](streaming-setting-up.md).
## Criar alertas em tempo real para correspondências de categorias
Para configurar alertas em tempo real, você deve primeiro criar uma categoria [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html) com o sinalizador `REAL_TIME`. Esse sinalizador permite que a categoria seja aplicada às transcrições do Call Analytics em tempo real.
Para obter instruções sobre como criar uma categoria, consulte [Criar categorias para transcrições em tempo real](tca-categories-stream.md).
Quando você inicia a transcrição do Call Analytics em tempo real, todas as categorias que têm o sinalizador `REAL_TIME` são aplicadas automaticamente ao resultado da transcrição em um nível de segmento. Se ocorrer uma correspondência `TranscriptFilterType`, ela aparecerá na seção `CategoryEvent` da transcrição. Em seguida, você pode usar esse parâmetro e os respectivos subparâmetros, `MatchedCategories` e `MatchedDetails`, para configurar alertas personalizados em tempo real.
Veja um exemplo de saída de transcrição do Call Analytics em tempo real para uma correspondência `CategoryEvent`:
```
"CategoryEvent": {
"MatchedCategories": [ "shipping-complaint" ],
"MatchedDetails": {
"my package never arrived" : {
"TimestampRanges": [
{
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22690
}
]
}
}
},
```
O exemplo anterior representa uma correspondência exata de texto com a fala “*meu pacote não chegou*”, que representa uma regra dentro da categoria “reclamação de envio”.
Você pode configurar o alerta em tempo real para incluir qualquer combinação dos parâmetros listados. Por exemplo, é possível configurar o alerta para incluir somente a frase para a qual houve correspondência (`MatchedDetails`) ou somente o nome da categoria (`MatchedCategories`). Ou você pode configurar o alerta para incluir todos os parâmetros.
A forma como você configura os alertas em tempo real depende das interfaces da organização e do tipo de alerta desejado. Por exemplo, você pode definir uma correspondência `CategoryEvent` para enviar uma notificação pop-up, um e-mail, uma mensagem de texto ou qualquer outro alerta que o sistema possa aceitar.