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

# Configurar streaming de mídia ao vivo do áudio do cliente no Amazon Connect
<a name="customer-voice-streams"></a>

No Amazon Connect, você pode capturar o áudio do cliente durante uma interação com a central de atendimento enviando o áudio para um streaming de vídeo do Kinesis. Dependendo das configurações, o áudio pode ser capturado durante toda a interação, até que a interação com o atendente seja concluída, ou somente em uma direção: 
+ O que o cliente ouve, incluindo o que o agente diz e o sistema solicita.
+ O que o cliente diz, inclusive quando ele está em espera.

Os fluxos de áudio do cliente também incluem interações com um bot do Amazon Lex, se você estiver usando um no fluxo. 

**Topics**
+ [Planejar-se para streaming de mídia ao vivo](plan-live-media-streams.md)
+ [Habilitar streaming de mídia ao vivo](enable-live-media-streams.md)
+ [Acessar dados do Kinesis Video Streams](access-media-stream-data.md)
+ [Testar streaming de mídia ao vivo](use-media-streams-blocks.md)
+ [Atributos de contato do streaming de mídia ao vivo](media-streaming-attributes.md)

# Planejar-se para streaming de mídia ao vivo do Amazon Connect ao Kinesis Video Streams
<a name="plan-live-media-streams"></a>

**Importante**  
Se você quiser usar o recurso de streaming de áudio, será necessário manter os fluxos criados pelo Amazon Connect. Não os exclua, a menos que você pare de usar o recurso de streaming.

Você pode enviar todo o áudio de/para o cliente para o Kinesis Video Streams. O streaming de mídia aproveita o suporte a várias faixas do Kinesis Video Streams de modo que aquilo que o cliente diz esteja em um caminho separado do que o cliente ouve. 

O áudio enviado para o Kinesis usa uma taxa de amostragem de 8 kHz.

## É necessário aumentar suas cotas de serviço?
<a name="create-streams-service-limit"></a>

Quando você habilitar o streaming de mídia no Amazon Connect, somente um fluxo de vídeo do Kinesis será usado por chamada ativa. Criamos novos fluxos KVS conforme necessário para lidar com solicitações de streaming simultâneas. Criamos automaticamente fluxos adicionais conforme necessário para acompanhar as chamadas ativas, a menos que sua [conta atinja a cota de serviço do Kinesis Video Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html).

Entre em contato Suporte para solicitar um aumento no **número de streams**.

Para solicitar um aumento na sua cota de serviço, no AWS Support Center, escolha **Criar caso** e, em seguida, escolha Aumento da **cota de serviço**.

**dica**  
Garantimos que as **PutMedia**solicitações sempre permaneçam dentro da cota de 5 TPS. Você não precisa solicitar um aumento.

## Por quanto tempo é necessário armazenar um áudio?
<a name="storing-audio-streams"></a>

O áudio do cliente é armazenado no Kinesis pelo tempo definido pelas configurações de retenção na instância do Amazon Connect. Para obter instruções sobre como definir esse valor, consulte [Habilitar streaming de mídia ao vivo na instância do Amazon Connect](enable-live-media-streams.md).

## É necessário a alterar os streamings de áudio?
<a name="changing-audio-streams"></a>

Recomendamos evitar modificar os streamings. Isso pode causar comportamento inesperado.

## Quem requer permissões do IAM para recuperar dados?
<a name="perms-audio-streams"></a>

Se sua empresa estiver usando permissões do IAM, seu AWS administrador precisará conceder permissões às funções do IAM que precisam recuperar dados do Kinesis Video Streams. Elas precisarão conceder permissões de acesso total para Kinesis Video Streams e AWS Key Management Service. 

# Habilitar streaming de mídia ao vivo na instância do Amazon Connect
<a name="enable-live-media-streams"></a>

O streaming de mídia ao vivo (streams de áudio do cliente) não é habilitado por padrão. Você pode habilitar streams de áudio do cliente a partir da página de configurações da sua instância.

**Para habilitar o streaming de mídia ao vivo**

1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.

1. No painel de navegação, escolha **Data storage (Armazenamento físico de dados)**.

1. Em **Live media streaming (Streaming de mídia ao vivo)**, escolha **Edit (Editar)**. Escolha **Enable live media streaming (Habilitar streaming de mídia ao vivo)**.

1. Insira um prefixo para o Kinesis Video Streams criado para o áudio do cliente. Esse prefixo ajuda a identificar o stream com os dados.

1. Os dados são criptografados antes de serem gravados na camada de armazenamento do fluxo do Kinesis Video Streams e descriptografados depois de recuperados do armazenamento. Como resultado, os dados são sempre criptografados em repouso no serviço Kinesis Video Streams. Escolha a chave do KMS usada para criptografar os dados no Kinesis Video Streams, conforme mostrado na imagem a seguir.  
![\[A seção Criptografia na qual você escolhe a chave do KMS.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/streaming-encryption.png)

   Ao optar por inserir sua própria chave, pense nas seguintes restrições:

   1. A chave do KMS deve estar na mesma região que a instância.

   1. A chave do KMS deve ser: 
      + Uma chave gerenciada pelo cliente

      OU
      +  A chave AWS gerenciada para o Kinesis Video Streams (aws/kinesisvideo). 

      Não deve ser nenhuma das chaves AWS gerenciadas criadas automaticamente para outros serviços (por exemplo,aws/connect, aws/lambda, aws/kinesis).

   1. A concessão provisionada para a chave pelo Amazon Connect não deve ser revogada. Essas concessões teriam `GranteePrincipal` do formato:

      ```
      arn:aws:iam::customer-account-id:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_hash_suffix
      ```

1. Especifique um número e unidade para o **Data retention period (Período de retenção de dados)**.
**Importante**  
Se você selecionar **Sem retenção de dados**, os dados não serão retidos e estarão disponíveis para serem consumidos por apenas 5 minutos. Esse é o tempo mínimo padrão em que o Kinesis retém os dados.  
Como o Amazon Connect usa o Kinesis para streaming, as [cotas do Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html) se aplicam.

1. Escolha **Save (Salvar)** em **Live media streaming (Streaming de mídia ao vivo)** e selecione **Save (Salvar)** na parte inferior da página.

Depois de habilitar o streaming de mídia ao vivo, adicione os blocos **Iniciar streaming de mídia** e **Interromper streaming de mídia** ao fluxo. Configure esses blocos para especificar o áudio que deseja capturar. Para obter instruções e um exemplo, consulte [Exemplo de fluxo para teste de streaming de mídia ao vivo no Amazon Connect](use-media-streams-blocks.md).

# Desenvolver streaming de mídia ao vivo no Amazon Connect
<a name="access-media-stream-data"></a>

Para ajudar você a começar a desenvolver usando streaming de mídia ao vivo, o Amazon Connect inclui o seguinte repositório do Kinesis Video Streams, que contém um exemplo básico de como consumir dados de áudio do seu Kinesis Video Streams: [https://github.com/amazon-connect/connect-kvs-consumer-demo](https://github.com/amazon-connect/connect-kvs-consumer-demo) 

Esta demonstração se baseia nas abstrações de alto nível fornecidas pela Kinesis Video Streams Parser Library para ler as faixas `AUDIO_TO_CUSTOMER` e `AUDIO_FROM_CUSTOMER` publicadas pelo Amazon Connect. Ela armazena esses dados como um arquivo PCM bruto. Esse arquivo pode ser transformado, transcodificado ou reproduzido.

# Exemplo de fluxo para teste de streaming de mídia ao vivo no Amazon Connect
<a name="use-media-streams-blocks"></a>

Veja como configurar um fluxo para testar streaming de mídia ao vivo: 

1. Adicione um bloco **Start media streaming (Iniciar streaming de mídia)** quando quiser habilitar o streaming de áudio do cliente.

1. Conecte a ramificação **Success (Sucesso)** ao restante do seu fluxo.

1. Adicione um bloco **Stop media streaming (Interromper streaming de mídia)** ao local onde você deseja interromper o streaming. 

1. Configure os dois blocos para especificar o que você deseja transmitir: **do cliente and/or ** **para o cliente**.  
![\[Um bloco Iniciar streaming de mídia.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/start-media-streaming.png)

O áudio é capturado até que um bloco **Parar streaming de mídia** seja invocado, mesmo se o contato for transmitido para outro fluxo.

Use os atributos de contato do streaming de mídia em seu fluxo para que o registro de contato inclua os atributos. Em seguida, você pode visualizar o registro de contato para determinar os dados do streaming de mídia associados a um contato específico. Você também pode passar os atributos para uma AWS Lambda função.

O fluxo de exemplo a seguir mostra como você pode usar o streaming de mídia com atributos para fins de teste. Esse fluxo inclui um bloco **Iniciar streaming de mídia**, mas não tem o bloco **Parar streaming de mídia**.

![\[Um fluxo de exemplo com um bloco Iniciar streaming de mídia.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/media-streaming-flow.png)


Depois que o áudio é transmitido com sucesso para o Kinesis Video Streams, os atributos de contato são preenchidos a partir do bloco de funções Invoke **Lambda AWS **. Você pode usar os atributos para identificar o local no stream em que o áudio do cliente começa. Para instruções, consulte [Atributos de contato do streaming de mídia ao vivo no Kinesis Video Streams](media-streaming-attributes.md).

# Atributos de contato do streaming de mídia ao vivo no Kinesis Video Streams
<a name="media-streaming-attributes"></a>

Os atributos são exibidos quando você seleciona **Streams de mídia** para **Tipo** em um bloco de fluxo que oferece suporte a atributos, como o bloco **Iniciar streaming de mídia**. Entre elas estão:

ARN do stream de áudio do cliente  
O ARN do fluxo de vídeo do Kinesis que inclui os dados do cliente para referência.  
**JSONPath formato:** \$1. MediaStreams.customer.audio.StreamArn

Data e hora do início do áudio do cliente  
A hora em que o stream de áudio do cliente começou.  
**JSONPath formato:** \$1. MediaStreams.Cliente.Áudio. StartTimestamp

Data e hora do término do áudio do cliente  
A hora em que o stream de áudio do cliente é interrompido.  
**JSONPath formato:** \$1. MediaStreams.Cliente.Áudio. StopTimestamp

Número do fragmento do início do áudio do cliente  
O número que identifica o fragmento do Kinesis Video Stream no qual o stream de áudio do cliente começou.  
**JSONPath formato:** \$1. MediaStreams.Cliente.Áudio. StartFragmentNumber

Para obter mais informações sobre fragmentos do Amazon Kinesis Video Streams, consulte [Fragmento](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_Fragment.html) no *Guia do desenvolvedor do Amazon Kinesis Video Streams*.