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

# Usar as configurações de analytics de chamadas do SDK do Amazon Chime
Usar configurações de análise de chamadas

Para processar o áudio usando uma configuração de análise de chamadas, é necessário criar um pipeline de análise de chamadas, também conhecido como pipeline de insights de mídia. O pipeline é criado durante uma chamada para tratar o áudio e é encerrado ao final da chamada. Os pipelines de análise de chamadas exigem o ARN de uma configuração de análise de chamadas e informações sobre a fonte de áudio. A configuração de análise de chamadas inclui detalhes sobre processadores de áudio, destinos de insights e configurações de eventos de alerta, *mas não a fonte do áudio*. Assim, é possível reutilizar a configuração em diferentes fluxos de trabalho de análise de chamadas, com diferentes conectores de voz ou fontes KVS. O pipeline de análise de chamadas invoca os serviços de machine learning especificados na configuração e grava o áudio. É possível interromper o pipeline manual ou automaticamente quando a chamada terminar.

É possível usar pipelines de análise de chamadas em uma ampla variedade de casos de uso. Os fluxos de trabalho a seguir mostram possíveis formas de usar uma configuração e um pipeline de análise de chamadas.

**Topics**
+ [

# Noções básicas sobre fluxos de trabalho para gravar chamadas para o SDK do Amazon Chime
](recording-workflows.md)
+ [

# Noções básicas sobre fluxos de trabalho de analytics baseada em machine learning do SDK do Amazon Chime
](ml-based-analytics.md)

# Noções básicas sobre fluxos de trabalho para gravar chamadas para o SDK do Amazon Chime
Noções básicas sobre fluxos de trabalho para gravação de chamadas

Os tópicos desta seção listam e descrevem os fluxos de trabalho para gravar chamadas e para o Kinesis Video Streams.

# Gravar chamadas do conector de voz


Use esse fluxo de trabalho quando:
+ Já usa, ou planeja usar, um conector de voz para incluir a mídia SIP na análise de chamadas.
**nota**  
Os conectores de voz forem compatíveis com SIP e SIPREC. Para obter mais informações, consulte [Gerenciamento de conectores de voz do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html), no *Guia do administrador do SDK do Amazon Chime*.
+ Quiser gravar automaticamente chamadas SIP ou SIPREC com baixa latência para os destinos do Amazon Simple Storage Service de sua escolha.
+ Quiser usar o console do SDK do Amazon Chime para criar a configuração e associá-la a um conector de voz.
+ Quiser aplicar a mesma configuração de gravação a cada chamada do conector de voz. Se quiser aplicar várias configurações a um ou mais conectores de voz, consulte a próxima seção.

Para habilitar a chamada programaticamente, use o seguinte SDK do Amazon Chime. APIs
+ Usar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) para criar uma configuração de analytics de chamadas
+ Use o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html) para criar um Voice Connector.
+ Use a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) para associar a configuração a um Voice Connector. 

Para obter mais informações, consulte [Como configurar conectores de voz para usar a análise de chamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) no *Guia do administrador do SDK do Amazon Chime*. 

 O diagrama a seguir mostra o fluxo de dados quando um conector de voz inicia uma sessão de gravação de chamadas. Os números no diagrama correspondem ao texto numerado abaixo. 

![\[Imagem mostra o fluxo de dados quando um conector de voz começa a gravar uma chamada.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)


 No diagrama: 

1. Use o console do SDK do Amazon Chime ou a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) para criar uma configuração de analytics de chamadas. Durante o processo para criar a configuração, basta ativar a gravação de chamadas, escolher o formato de arquivo de gravação desejado e especificar o destino do Amazon S3 para armazenar os arquivos de gravação. Para obter mais informações, consulte [Criar configurações de análise de chamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-ca-config.html) no *Guia do administrador do SDK do Amazon Chime*.

1. Use o console do SDK do Amazon Chime ou a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) para associar a configuração a um Voice Connector. Para usar o console, consulte [Como configurar conectores de voz para usar a análise de chamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html).

1. Durante uma chamada de saída, o conector de voz recebe o áudio de cada participante da chamada.

1. Se uma configuração de gravação de análise de chamadas estiver anexada ao conector de voz, o serviço de conector de voz usará o serviço de pipeline de mídia para iniciar uma sessão de gravação de análise de chamadas.

1. O serviço de pipeline de mídia inicia o processador de gravação de chamadas que monitora a chamada em andamento.

1. Quando a chamada termina, o serviço de pipeline de mídia entrega o arquivo de gravação da chamada para o bucket do Amazon S3 indicado e fornece os metadados de gravação por meio do Amazon Kinesis Data Stream. Se um data warehouse estiver ativado, os metadados da chamada também serão enviados para o data warehouse do Amazon Simple Storage Service. Nos casos em que for utilizado o SIPREC para incorporar áudio SIP na análise de chamadas, os metadados da chamada conterão metadados do SIPREC em formato de tabela. Para obter mais informações sobre as tabelas de gravação, consulte [Entendendo as tabelas do catálogo de AWS Glue dados para o Amazon Chime SDK](glue-tables.md), mais adiante nesta seção.

1. O serviço de pipeline de mídia envia os eventos de status do pipeline para a Amazon padrão EventBridge. Para obter mais informações, consulte [Usando EventBridge notificações](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) neste guia. 

**nota**  
 Observe que deve habilitar o streaming do conector de voz para permitir a gravação com um conector de voz. Esse atributo permite o streaming de dados de chamadas para o Kinesis Video Streams gerenciado pelo conector de voz em sua conta. Para obter mais informações, consulte [Streaming de mídia do conector de voz do SDK do Amazon Chime para o Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) no *Guia do administrador do SDK do Amazon Chime*.

 Também é possível armazenar dados de chamadas criados pelo conector de voz no Kinesis Video Streams com durações variadas, variando de horas a dias ou até anos. Ao optar pela não retenção de dados a usabilidade dos dados da chamada fica limitada para consumo imediato. O custo do Kinesis Video Streams é determinado com base na largura de banda e no armazenamento total utilizado. É possível ajustar o período de retenção de dados a qualquer momento na configuração de streaming do conector de voz. Para habilitar a gravação da análise de chamadas, você deve garantir que o stream de vídeo do Kinesis retenha os dados por tempo suficiente para realizar a análise de chamadas. Faça isso especificando um período de retenção de dados adequado. 

 É possível associar uma configuração de pipeline de informações de chamadas a quantos conectores de voz quiser. Também é possível criar uma configuração diferente para cada conector de voz. Os conectores de voz usam o AWSService RoleForAmazonChimeVoiceConnector para chamar a [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API em seu nome uma vez por ID de transação. Para obter informações sobre a função, consulte [Uso da função vinculada ao serviço do SDK do Amazon Chime para conectores de voz do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream) no *Guia do administrador do SDK do Amazon Chime*.

# Gravar com produtores do Amazon Kinesis Video Streams


Grave Amazon Kinesis Video Streams quando: 
+ Precisar aplicar configurações diferentes a uma chamada em vez de usar a mesma configuração para cada chamada do conector de voz.
+ Desejar gravar áudio SIP ou não SIP que não seja processado por um conector de voz.

 Para usar essa opção de gravação de chamadas, você precisará publicar áudio no Kinesis Video Streams (KVS) e, depois, chamar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) com as informações do canal de fluxos do KVS e um ARN de configuração de analytics de chamadas.

**nota**  
A análise de chamadas APIs suporta no máximo dois canais de áudio. Você também pode ativar o streaming do Voice Connector e, em seguida, usar as informações do KVS publicadas nas EventBridge notificações do Voice Connector para iniciar a gravação de uma chamada. 

 Ao chamar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html), é possível escolher se deseja ou não especificar números de fragmentos para cada definição de canal de fluxos do KVS. Se fornecer um número de fragmento, a análise de chamadas começará a processar o streaming nesse fragmento. Se não especificar a ID de um fragmento, a análise de chamadas começará a processar o streaming a partir do fragmento mais recente disponível. 

 O diagrama a seguir mostra o fluxo de dados quando um conector de voz inicia uma sessão de gravação de chamadas. Os números no diagrama correspondem ao texto numerado abaixo. 

![\[Imagem mostra o fluxo de dados quando um conector de voz começa a gravar uma chamada.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/call-analytics-workflow-2.png)


No diagrama:

1. É possível usar o console do SDK do Amazon Chime ou a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) para criar uma configuração de gravação de chamadas.

1. Use o AWS SDK para criar um aplicativo que envia áudio externo para o KVS ou habilite o streaming do Voice Connector para publicar automaticamente o áudio da chamada em um KVS. Para obter mais informações, consulte [Streaming de mídia do conector de voz do SDK do Amazon Chime para o Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) no *Guia do administrador do SDK do Amazon Chime*.

1. Se o streaming do Voice Connector estiver ativado, o serviço Voice Connector enviará notificações para o padrão EventBridge.

1. No caso de streaming do Voice Connector, seu aplicativo pode usar os `STARTED` eventos de streaming do Amazon Chime Voice Connector EventBridge para coletar informações do stream KVS sobre os trechos de uma chamada.

1. Depois que sua aplicação tiver as informações de áudio dos eventos de streaming do Voice Connector ou de uma origem externa, ela invocará a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) do SDK do Amazon Chime.

1. O serviço de pipeline de mídia inicia o processador de gravação de chamadas que monitora a chamada em andamento.

1. O serviço de pipeline de mídia envia os eventos de status do pipeline para a Amazon padrão EventBridge. Para obter mais informações, consulte [Usando EventBridge notificações](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html).

1. Quando a chamada é finalizada, o serviço de pipeline de mídia entregará o arquivo de gravação da chamada para o bucket do Amazon S3 indicado e fornecerá os metadados de gravação por meio do Amazon Kinesis Data Stream. Se um data warehouse estiver ativado, os metadados da chamada também serão enviados para o data warehouse do Amazon S3. Nos casos em que for utilizado o SIPREC para incorporar áudio SIP na análise de chamadas, os metadados da chamada conterão metadados do SIPREC em um formato conveniente de tabela. Para obter mais informações sobre as tabelas de gravação, consulte [Entendendo as tabelas do catálogo de AWS Glue dados para o Amazon Chime SDK](glue-tables.md), mais adiante nesta seção.

1. Seu aplicativo pode monitorar o pipeline e, no caso de um conector de voz, o status da chamada usando eventos publicados na Amazon EventBridge. Para obter mais informações, consulte [Usando EventBridge notificações](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) neste guia.

1. Para encerrar a gravação, chame a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) para encerrar a gravação da chamada. 

Para obter exemplos e gravações baseadas em API, consulte o [Coletor de gravação do Amazon S3](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-processors-sinks.html#ca-s3-recording-sink) neste guia.

# Usar a CLI para iniciar a gravação


Os exemplos nesta seção explicam como fazer o seguinte:
+ Use a CLI para executar uma configuração de analytics de chamadas e invocar o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html).
+ Usar a CLI para especificar destinos de gravação, formatos de arquivo de áudio e nomes de arquivos de áudio.

**Topics**
+ [

## Executar uma configuração e iniciar um pipeline
](#cli-run-config)
+ [

## Definição de destinos, nomes e formatos
](#cli-set-buckets-formats)

## Executar uma configuração e iniciar um pipeline


Use o comando a seguir para executar uma configuração e iniciar um pipeline de insights de mídia. O arquivo pipeline.json contém as configurações.

```
aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json
```

O exemplo a seguir mostra um típico arquivo `pipeline.json`.

```
{
    "MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration,
    "KinesisVideoStreamRecordingSourceRuntimeConfiguration": {
        "Streams": [
            {
                "StreamArn": kinesis_video_stream_arn_1
            },
            {
                "StreamArn": kinesis_video_stream_arn_2
            }
        ],
        "FragmentSelector": {
            "FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type
            "TimestampRange": {
                "StartTimestamp": epoch_time_seconds,
                "EndTimestamp": epoch_time_seconds
            }
        }
    },
    "S3RecordingSinkRuntimeConfiguration": {
        "Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name,
        "RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration
    }
}
```

O `MediaInsightsPipelineConfigurationArn` é o ARN de configuração que você recebe depois de criar uma configuração de análise de chamadas.

## Definição de destinos, nomes e formatos


 O exemplo a seguir usa uma pasta chamada `MyRecordingBucket` como o valor de `S3SinkConfiguration.Destination` e `Opus` como o valor de `RecordingFileFormat`.

```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg
```

O exemplo a seguir usa `MyRecordingBucket` como o valor de `S3SinkConfiguration.Destination` e `Wav` como o valor de `RecordingFileFormat`.

```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav
```

# Noções básicas sobre fluxos de trabalho de analytics baseada em machine learning do SDK do Amazon Chime
Noções básicas sobre fluxos de trabalho para analytics baseada em machine learning

As seções a seguir descrevem como usar os atributos de análise de machine learning fornecidos pela análise de chamadas do SDK do Amazon Chime.

**nota**  
Se planeja executar várias análises de machine learning no mesmo stream de vídeo do Kinesis, talvez seja necessário aumentar o limite do nível de conexão para `GetMedia` e `GetMediaForFragmentList` do streaming de vídeo. Para obter mais informações, consulte [Limites do Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html) no *Guia do desenvolvedor do Kinesis Video Streams*.

# Usar conectores de voz para iniciar a análise de chamadas automaticamente


Use esse fluxo de trabalho quando:
+ Quiser uma configuração controlada pelo console.
+ Já usa, ou planeja usar, um conector de voz para incluir a mídia SIP na análise de chamadas. Os conectores de voz forem compatíveis tanto com SIP quanto com SIPREC. Para obter mais informações sobre a configuração de conectores de voz, consulte [Gerenciar o conector de voz do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html).
+ Desejar aplicar a mesma configuração de insights de mídia a cada chamada do conector de voz.
+ Precisar usar a análise de voz do SDK do Amazon Chime, que requer um conector de voz ou um pipeline de insights de mídia.

Para habilitar esse fluxo de trabalho no console do SDK do Amazon Chime, siga as etapas para criar uma configuração de gravação em [Como configurar conectores de voz para usar a análise de chamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html).

Para habilitar esse fluxo de trabalho programaticamente, use o seguinte APIs: [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API para criar uma configuração de análise de chamadas e, em seguida, associe a configuração a um conector de voz usando a [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API. Para obter mais informações, consulte [Como configurar conectores de voz para usar análise de voz](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) no *Guia do administrador do SDK do Amazon Chime*. 

 O diagrama a seguir mostra o fluxo de dados quando um conector de voz inicia uma sessão de análise de chamadas. Os números no diagrama correspondem ao texto numerado abaixo. 

 ![\[Image showing the flow of data when a Voice Connector initiates a call.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)

 No diagrama: 

1. Use o console do SDK do Amazon Chime ou a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) para criar uma configuração de pipeline de insights de mídia.

1. Use o console do SDK do Amazon Chime ou a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) para associar a configuração a um Voice Connector. Para associar uma configuração existente a um conector de voz, consulte [Como configurar conectores de voz para a usar análise de chamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) no *Guia do administrador do SDK do Amazon Chime*.

1. Durante uma chamada de saída, o conector de voz recebe o áudio de cada participante da chamada.

1. Devido à integração com a análise de chamadas, se uma configuração de análise de chamadas estiver anexada a um conector de voz, o serviço de conector de voz iniciará uma sessão de análise de chamadas usando o serviço de pipeline de mídia.

1. O serviço de pipeline de mídia invoca um ou mais processadores de mídia conforme especificado na configuração.

1. O serviço de pipeline de mídia envia os dados de saída para um ou mais destinos com base na configuração. Por exemplo, é possível enviar análises em tempo real por meio de um Amazon Kinesis Data Stream e, se configurado, enviar os metadados e as análises da chamada para um data warehouse do Amazon S3.

1. O serviço de pipeline de mídia envia os eventos de status do pipeline para a Amazon padrão EventBridge. Se você configurou regras, as notificações para elas também serão enviadas para EventBridge a Amazon. Para obter mais informações, consulte [Usando EventBridge notificações](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html).

**nota**  
Um processador de análise de voz só inicia automaticamente quando você liga para o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)ou [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html) APIs. 
Você deve habilitar o streaming do conector de voz para usar a análise de chamadas com o conector de voz. Esse atributo permite o streaming de dados de chamadas para o Kinesis Video Streams gerenciado por conector de voz em sua conta. Para obter mais informações, consulte [Streaming de mídia do conector de voz do SDK do Amazon Chime para o Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) no *Guia do administrador do SDK do Amazon Chime*. 

 Também é possível armazenar dados de chamadas do conector de voz no Kinesis Video Streams por períodos variáveis, de horas até anos. Ao optar pela não retenção de dados a usabilidade dos dados da chamada fica limitada para consumo imediato. O custo do Kinesis Video Streams é determinado com base na largura de banda e no armazenamento total utilizado. É possível ajustar o período de retenção de dados a qualquer momento editando a configuração de streaming do conector de voz. Para habilitar a gravação da análise de chamadas, você deve garantir que o stream de vídeo do Kinesis retenha os dados até que a análise de chamadas seja concluída. Faça isso especificando um período de retenção de dados adequado. 

 É possível associar uma configuração de pipeline de insights de mídia a quantos conectores de voz quiser. Também é possível criar uma configuração diferente para cada conector de voz. Os conectores de voz usam o AWSService RoleForAmazonChimeVoiceConnector para chamar a [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API em seu nome uma vez por ID de transação. Para obter informações sobre a função, consulte [Uso da função vinculada ao serviço do SDK do Amazon Chime para conectores de voz do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream) no *Guia do administrador do SDK do Amazon Chime*. 

# Usando a análise de chamadas APIs com conectores de voz


Use esse fluxo de trabalho se você usa um conector de voz, mas precisa controlar quando aplicar uma configuração de análise de chamadas e em qual chamada a configuração será aplicada.

 Para usar esse método, você precisa criar um EventBridge destino para os eventos que o Voice Connector publica e, em seguida, usar os eventos para acionar o pipeline APIs de análise de chamadas. Para obter mais informações, consulte [Automatização do SDK do Amazon Chime com o Guia do administrador do SDK EventBridge](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html) do Amazon *Chime*. 

 O diagrama a seguir mostra como implementar um controle mais granular ao usar a análise de chamadas com conector de voz. Os números no diagrama correspondem aos números no texto abaixo. 

![\[Imagem mostrando o fluxo de dados ao usar chamadas de API com conectores de voz.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/analytics-vc-with-apis.png)


 No diagrama: 

1. Use o console do SDK do Amazon Chime ou a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) para criar uma configuração de pipeline de insights de mídia.

1. Durante uma chamada de saída, o conector de voz receberá o áudio do participante.

1. O Voice Connector envia o áudio da chamada para o Kinesis Video Stream e os eventos correspondentes para o. EventBridge Os eventos têm metadados de streaming e da chamada.

1. Sua inscrição é assinada EventBridge por meio de um EventBridge Target.

1. Sua aplicação invoca a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) do SDK do Amazon Chime.

1. O serviço de pipeline de mídia invoca um ou mais processadores de mídia com base nos elementos do processador na configuração do pipeline de insights de mídia.

1. O serviço de pipeline de mídia envia os dados de saída para um ou mais destinos com base na configuração. A análise de chamadas do SDK do Amazon Chime fornecerá análises em tempo real por meio do Amazon Kinesis Data Stream e, se configuradas, análises de metadados de chamadas para um data warehouse do Amazon S3.

1. O serviço de pipeline de mídia envia os eventos para a Amazon EventBridge. Se você configurou regras, as notificações para elas também serão enviadas para EventBridge a Amazon.

1. É possível pausar ou retomar a sessão de analytics de chamadas invocando a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html).
**nota**  
A gravação de chamadas não suporta pausar e retomar chamadas. Além disso, as tarefas de análise de voz iniciadas para a chamada também param quando uma sessão é pausada. Para reiniciá-los, você deve chamar o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)ou [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.

1. Se você selecionar a análise de tom de voz durante a configuração, inicie a análise de voz chamando o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)ou [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.

# Como usar a análise de chamadas com produtores do Kinesis Video Streams


 Para usar essa opção, é necessário publicar dados do áudio no Kinesis Video Streams (KVS) e, depois, chamar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) com informações do canal de fluxos do KVS.

**nota**  
A análise de chamadas APIs suporta no máximo dois canais de áudio.

Ao chamar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html), é possível especificar números de fragmentos para cada definição de canal de fluxo KVS. Se fornecer um número de fragmento, a análise de chamadas começa a processar o streaming nesse fragmento. Caso contrário, a análise de chamadas começa a processar o streaming a partir do fragmento mais recente disponível.

A análise de chamadas suporta áudio PCM (somente formatos de áudio little-endian assinados de 16 bits, que não incluem WAV) com uma taxa de amostragem de áudio entre 8 kHz e 48 kHz. Áudio de baixa qualidade, como áudio de telefonia, normalmente é de cerca de 8.000 Hz. Áudio de alta qualidade normalmente varia de 16.000 Hz a 48.000 Hz. A taxa de amostragem especificada deve corresponder à do seu áudio. Para ter mais informações, consulte [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html) na *Referência da API do SDK do Amazon Chime*.

O SDK do produtor do Kinesis Video Streams fornece um conjunto de bibliotecas que podem ser usadas para transmitir dados de áudio para um stream de vídeo do Kinesis. Para obter mais informações, consulte as [Bibliotecas do produtor do Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk.html) no *Guia do desenvolvedor do Amazon Kinesis Video Streams*.

O diagrama a seguir mostra o fluxo de dados ao usar a análise de chamadas com um produtor personalizado do stream de vídeo do Kinesis. Os números no diagrama correspondem ao texto numerado abaixo.

![\[Imagem mostrando o fluxo de dados ao usar a análise de chamadas com um produtor do stream de vídeo do Kinesis.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/analytics-kvs-with-apis.png)


1. Você usa o AWS console ou a [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API para criar uma configuração de pipeline de insights de mídia.

1. Use um produtor do stream de vídeo do Kinesis para gravar áudio no Kinesis Video Streams.

1. Sua aplicação invoca a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html).

1. O serviço de pipeline de mídia lê o áudio do Kinesis Video Streams do cliente.

1. O serviço de pipeline de mídia envia os eventos para a Amazon EventBridge. Se você configurou regras, as notificações para elas também serão enviadas para EventBridge a Amazon.

1. O serviço de pipeline de mídia invoca um ou mais elementos do processador.

1. O serviço de pipeline de mídia envia dados de saída para um ou mais elementos coletores.

1. É possível pausar ou retomar a sessão de analytics de chamadas invocando a API [ UpdateMediaInsightsPipelineStatus](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html).
**nota**  
A gravação de chamadas não suporta pausar e retomar.

1. Seu aplicativo pode processar os EventBridge eventos da Amazon para acionar fluxos de trabalho comerciais personalizados.

1. Se você selecionar análise de voz ao criar uma configuração, seu aplicativo poderá iniciar a análise de voz chamando o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)ou [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.