

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

# Gerenciando a análise de chamadas do Amazon Chime SDK
<a name="ag-call-analytics"></a>

Os tópicos da seção explicam como gerenciar a análise de chamadas do Amazon Chime SDK. Você usa a análise de chamadas para gerar insights de chamadas a partir de áudio em tempo real. Você também pode analisar as chamadas armazenadas. Além disso, você pode usar a análise de voz do Amazon Chime SDK para identificar os chamadores e prever seus sentimentos, sejam eles positivos, negativos ou neutros.

**Topics**
+ [Criação de configurações de análise de chamadas](create-ca-config.md)
+ [Usar configurações de análise de chamadas](use-ca-config.md)
+ [Atualizando as configurações de análise de chamadas](update-ca-config.md)
+ [Excluindo configurações de análise de chamadas](delete-ca-config.md)
+ [Habilitando a análise de voz](enable-voice-analytics.md)
+ [Gerenciando domínios de perfil de voz](manage-voice-profile-domains.md)

# Criação de configurações de análise de chamadas
<a name="create-ca-config"></a>

Para usar a análise de chamadas, você começa criando uma *configuração*, uma estrutura estática que contém as informações necessárias para criar um pipeline de análise de chamadas. Você pode usar o console do Amazon Chime SDK para criar uma configuração ou chamar o [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.

Uma configuração de análise de chamadas inclui detalhes sobre processadores de áudio, como gravação, análise de voz ou o Amazon Transcribe. Também inclui destinos de insights e configuração de eventos de alerta. Opcionalmente, é possível salvar os dados de chamadas em um bucket do Amazon S3 para análise posterior.

No entanto, *as configurações não incluem fontes de áudio específicas*. Isso permite reutilizar a configuração em vários fluxos de trabalho de análise de chamadas. Por exemplo, você pode usar a mesma configuração de análise de chamadas com conectores de voz diferentes ou em diferentes fontes do Amazon Kinesis Video Streams (KVS).

Use as configurações para criar pipelines quando as chamadas SIP ocorrem por um conector de voz ou quando novas mídias são enviadas para um Amazon Kinesis Video Stream (KVS). Os pipelines, por sua vez, processam a mídia de acordo com as especificações na configuração.

É possível interromper um pipeline programaticamente a qualquer momento. Os pipelines também interrompem o processamento da mídia quando a chamada de um conector de voz é encerrada. Além disso, é possível pausar um pipeline. Ao fazer isso, desativa as chamadas para os serviços subjacentes de machine learning da Amazon e as retoma quando desejado. No entanto, a gravação de chamadas continua durante a pausa do pipeline.

**Topics**
+ [Pré-requisitos](#ca-ag-prereqs)
+ [Criando uma configuração de análise de chamadas](#create-config-steps)

## Pré-requisitos
<a name="ca-ag-prereqs"></a>

Para usar a análise de chamadas com o Amazon Transcribe, o Amazon Transcribe Analytics ou a análise de voz do Amazon Chime SDK, você deve ter os seguintes itens:
+ Um conector de voz do SDK do Amazon Chime. Caso contrário[Criação de um conector de voz do Amazon Chime SDK](create-voicecon.md), consulte o artigo anterior neste guia.
+  EventBridge Alvos da Amazon. Caso contrário, consulte o [Monitorando o Amazon Chime SDK com a Amazon CloudWatch](monitoring-cloudwatch.md) artigo anterior neste guia.
+ Uma função vinculada ao serviço que permite que o Voice Connector acesse ações nos EventBridge alvos. Para ter mais informações, consulte [Usando a política de função vinculada ao serviço Amazon Chime SDK Voice Connector](using-service-linked-roles-stream.md) no início deste guia.
+ Um Amazon Kinesis Data Stream. Caso contrário, consulte [Criar um stream de vídeo do Kinesis](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-createstream.html) no Guia do desenvolvedor do *Amazon Kinesis Video* Stream. A análise e a transcrição de voz exigem um stream do Kinesis.
+ Para analisar chamadas off-line, é necessário criar um data lake do SDK do Amazon Chime. Para fazer isso, consulte [Criação de um data lake do Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-data-lake.html) no Guia do desenvolvedor do *Amazon Chime* SDK.

## Criando uma configuração de análise de chamadas
<a name="create-config-steps"></a>

Depois de criar a configuração, ative a análise de chamadas associando um conector de voz à configuração. Depois de fazer isso, a análise de chamadas será iniciada automaticamente quando uma chamada chegar ao conector de voz. Para ter mais informações, consulte [Configurando conectores de voz para usar a análise de chamadas](configure-voicecon.md) no início deste guia.

As seções a seguir explicam como realizar cada etapa do processo. Expandi-as na ordem listada.

### Especificar detalhes da configuração
<a name="ca-config-details"></a>

**Para especificar detalhes da configuração**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, em **Análise de chamadas**, escolha **Configurações** e, em seguida, escolha **Criar configuração**.

1. Em **Basic information** (Informações básicas), faça o seguinte:

   1. Insira um nome para a configuração. O nome deve refletir seu caso de uso e todas as tags.

   1. (Opcional) Em **Tags**, escolha **Adicionar nova tag** e insira as chaves de tag e valores opcionais. Defina as chaves e os valores. As tags ajudam a consultar a configuração.

   1. Escolha **Próximo**.

### Configuração da gravação
<a name="recording-details"></a>

**Para configurar a gravação**
+ Na página **Configure recording** (Configurar gravação), faça o seguinte: 

  1. Escolha a caixa de seleção **Ativar gravação de chamadas**. Isso permite gravar chamadas do conector de voz ou streams do KVS e enviar os dados ao bucket do Amazon S3.

  1. Em **Formato de arquivo**, escolha **WAV com PCM** para obter a melhor qualidade de áudio.

     —ou—

     Escolha **OGG com OPUS** para compactar o áudio e otimizar o armazenamento.

  1. (Opcional) Conforme necessário, escolha o link **Criar um bucket do Amazon S3** e siga as etapas para criar um bucket do Amazon S3.

  1. Insira o URI do seu bucket do Amazon S3 ou escolha **Browse** para localizar um bucket.

  1. (Opcional) Escolha **Ativar aprimoramento de voz** para ajudar a melhorar a qualidade do áudio das gravações.

  1. Escolha **Próximo**.

Para obter mais informações sobre aprimoramento de voz, expanda a próxima seção.

### Compreender o aprimoramento de voz
<a name="understand-voice-enhancement"></a>

O aprimoramento de voz ajuda a melhorar a qualidade de áudio das chamadas telefônicas gravadas nos buckets Amazon S3 de seus clientes. As chamadas telefônicas são filtradas por banda estreita e amostradas a uma taxa de 8 kHz. O aprimoramento de voz aumenta a taxa de amostragem de 8 kHz para 16 kHz e usa um modelo de machine learning para expandir o conteúdo de frequência de banda estreita para banda larga para tornar a fala mais natural. O aprimoramento de voz também usa um modelo de redução de ruído chamado Amazon Voice Focus, que ajuda a reduzir o ruído de fundo no áudio aprimorado.

Quando o aprimoramento de voz está ativado, o processamento do aprimoramento de voz é executado após a conclusão da gravação da chamada. O arquivo de áudio aprimorado é gravado em seu bucket do Amazon S3 como a gravação original e tem o sufixo **\$1enhanced** adicionado ao nome do arquivo base da gravação original. O aprimoramento de voz pode processar chamadas de até 30 minutos de duração. As gravações aprimoradas não serão geradas para chamadas com mais de 30 minutos.

*Para obter informações sobre o uso programático do aprimoramento de voz, consulte [Usando APIs para criar configurações de análise de chamadas](https://docs.aws.amazon.com/chime-sdk/latest/dg/create-config-apis.html), no Guia do desenvolvedor do Amazon Chime SDK.*

*Para obter mais informações sobre o aprimoramento de voz, consulte [Entendendo o aprimoramento de voz](https://docs.aws.amazon.com/chime-sdk/latest/dg/understand-voice-enhancement.html), no latest/dg/. https://docs.aws.amazon.com/chime/*

### Configurar os serviços de análise
<a name="configure-analytics"></a>

O Amazon Transcribe fornece transcrições de texto das chamadas. Em seguida, é possível usar as transcrições para ampliar outros serviços de machine learning, como o Amazon Comprehend ou seus próprios modelos de machine learning.

**nota**  
O Amazon Transcribe também fornece reconhecimento automático de idiomas. No entanto, esse atributo não pode ser usado com modelos de linguagem ou redação de conteúdo personalizados. Além disso, se a identificação de idioma for utilizada com outros atributos, somente será possível usar os idiomas compatíveis com esses atributos. Para obter mais informações, consulte [Identificação do idioma com transcrições de streaming](https://docs.aws.amazon.com/transcribe/latest/dg/lang-id-stream.html), no *Guia do desenvolvedor do Amazon Transcribe*.

A Amazon Transcribe Call Analytics é uma API baseada em machine learning que fornece transcrições de chamadas, opiniões e insights de conversas em tempo real. O serviço elimina a necessidade de fazer anotações e permite uma ação imediata sobre os problemas detectados. O serviço também fornece análises pós-chamada, como sentimento do autor da chamada, motivadores da chamada, tempo sem conversa, interrupções, velocidade da conversa e características da conversa.

**nota**  
Por padrão, a análise pós-chamada transmite gravações de chamadas para o bucket do Amazon S3. Para evitar a criação de gravações duplicadas, não ative a gravação de chamadas e a análise pós-chamada ao mesmo tempo.

Por fim, o Transcribe Call Analytics pode marcar automaticamente conversas com base em frases específicas e ajudar a redigir informações confidenciais de áudio e texto. Para obter mais informações sobre os processadores de mídia de análise de chamadas, os insights gerados por esses processadores e os destinos de saída, consulte [Processador de análise de chamadas e destinos de saída](https://docs.aws.amazon.com/chime-sdk/latest/dg/call-analytics-processor-and-output-destinations.html), no Guia do *desenvolvedor do Amazon Chime SDK*.

**Para configurar os serviços de análise**

1. Na página **Configurar serviços de análise**, marque as caixas de seleção ao lado de **Análise de voz** ou **Serviços de transcrição**. Os dois itens podem ser selecionados.

   Marque a caixa de seleção **Análise de voz**, para ativar qualquer combinação de **pesquisa de locutor** e **análise de tom de voz**. 

   Selecione a caixa de seleção **Serviços de transcrição** para ativar o Amazon Transcribe ou o Transcribe Call Analytics.

   1. **Para ativar a pesquisa de locutor**
      + Selecione a caixa de seleção **Sim, eu concordo com a confirmação de consentimento para análise de voz do SDK do Amazon Chime** e escolha **Aceitar**.

   1. Para ativar a análise de tom de voz
      + Marque a caixa de seleção **Análise de tom de voz**.

   1. Para habilitar o Amazon Transcribe

      1. Escolha o botão **Amazon Transcribe**.

      1. Em **Configurações de idioma**, faça o seguinte:

         1. Se seus chamadores falarem um único idioma, escolha **Idioma específico**, abra a lista de **idiomas** e selecione o idioma.

         1. Se seus chamadores falarem vários idiomas, você poderá identificá-los automaticamente. Escolha **Detecção automática de idioma**. 

         1. Abra a lista **Opções de idioma para identificação automática de idioma** e selecione pelo menos dois idiomas.

         1. (Opcional) Abra a lista **Idiomas preferidos** e especifique um idioma preferido. Quando os idiomas selecionados na etapa anterior têm pontuações de confiança correspondentes, o serviço transcreve o idioma preferido.

         1. (Opcional) Expanda as **Configurações de remoção de conteúdo**, selecione uma ou mais opções e escolha uma ou mais das opções adicionais que forem exibidas. O texto auxiliar explica cada opção.

         1. (Opcional) Expanda **Configurações adicionais**, selecione uma ou mais opções e escolha uma ou mais das opções adicionais que forem exibidas. O texto auxiliar explica cada opção.

   1. Para habilitar o Amazon Transcribe Call Analytics

      1. Escolha o botão **Amazon Transcribe Call Analytics**.

      1. Abra a lista **Idiomas** e selecione um idioma.

      1. (Opcional) Expanda as **Configurações de remoção de conteúdo**, selecione uma ou mais opções e escolha uma ou mais das opções adicionais que forem exibidas. O texto auxiliar explica cada opção.

      1. (Opcional) Expanda **Configurações adicionais**, selecione uma ou mais opções e escolha uma ou mais das opções adicionais que forem exibidas. O texto auxiliar explica cada opção.

      1. (Opcional) Expanda as **Configurações de análise pós-chamada** e faça o seguinte:

         1. Escolha a caixa de seleção **Análise pós-chamada**.

         1. Insira o URI do bucket do Amazon S3.

         1. Selecione um tipo de redação de conteúdo.

1. Ao terminar de fazer as seleções, escolha **Avançar**. 

### Configurar os detalhes de saída
<a name="configure-output"></a>

Depois de concluir as etapas de processamento de mídia, selecione um destino para a saída da análise. A análise de chamadas fornece insights ao vivo por meio do Amazon Kinesis Data Streams e, opcionalmente, por meio de um data warehouse em um bucket do Amazon S3 de sua escolha. Para criar o data warehouse, você usa um CloudFormation modelo. O modelo ajuda a criar a infraestrutura que fornece os metadados e insights de chamada para o bucket do Amazon S3. Para obter mais informações sobre a criação do data warehouse, consulte [Criação de um data lake do Amazon Chime e modelo de dados](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-data-lake.html) [de análise de chamadas](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-data-model.html), no Guia do desenvolvedor do *Amazon Chime SDK*.

Se você ativar a análise de voz ao criar uma configuração, também poderá adicionar destinos de notificação de análise de voz, como AWS Lambda, Amazon Simple Queue Service ou Amazon Simple Notification Service. As etapas a seguir explicam como.

**Para configurar os detalhes de saída**

1. Abra a lista de **fluxo de dados do Kinesis** e selecione seu fluxo de dados.
**nota**  
Se quiser visualizar os dados, deve selecionar o fluxo de dados do Kinesis usado pelo bucket do Amazon S3 e pelo Amazon Kinesis Data Firehose.

1. (Opcional) Expanda **Destinos adicionais de notificação de análise de voz** e selecione qualquer combinação de destinos Lambda, Amazon SNS e Amazon SQS da AWS .

1. (Opcional) Em **Analisar e visualizar insights**, marque a caixa de seleção **Executar análise histórica com data lake**.

1. Quando terminar, escolha **Next** (Próximo).

### Configurar permissões de acesso
<a name="configure-perms"></a>

Para permitir a análise de chamadas, o serviço de machine learning e outros recursos devem ter permissões para acessar a mídia de dados e fornecer informações. Para obter mais informações, consulte [Como usar a função de acesso ao recurso de análise de chamadas](https://docs.aws.amazon.com/chime-sdk/latest/dg/call-analytics-resource-access-role.html), no Guia do *desenvolvedor do Amazon Chime SDK*.

**Para configurar permissões de acesso**

1. Na página **Configurar permissões de acesso**, faça um dos itens a seguir:

   1. Selecione **Criar e usar um novo perfil de serviço**.

   1. Na caixa **Sufixo do nome do perfil de serviço**, insira um sufixo descritivo para o perfil.

   —ou—

   1. Selecione **Usar um perfil de serviço existente**.

   1. Abra a lista **Perfil de serviço** e selecione um perfil.

1. Escolha **Próximo**.

### (Opcional) Configurar alertas em tempo real
<a name="configure-alerts"></a>

**Importante**  
Para usar alertas em tempo real, você deve primeiro ativar o Amazon Transcribe ou o Amazon Transcribe Call Analytics.

Você pode criar um conjunto de regras que enviam alertas em tempo real para a Amazon EventBridge. Quando um insight gerado pelo Amazon Transcribe ou pelo Amazon Transcribe Call Analytics corresponde à regra especificada durante uma sessão de análise, é enviado um alerta. Os alertas têm o tipo de detalhe`Media Insights Rules Matched`. EventBridge oferece suporte à integração com serviços downstream, como Amazon Lambda, Amazon SQS e Amazon SNS, para acionar notificações para o usuário final ou iniciar outra lógica de negócios personalizada. Para mais informações, consulte [Automatizando o Amazon Chime SDK com EventBridge](automating-chime-with-cloudwatch-events.md), mais adiante nesta seção.

**Para configurar alertas**

1. Em **Alertas em tempo real**, escolha **Alertas ativos em tempo real**.

1. Em **Regras**, selecione **Criar regra**.

1. Na caixa de seleção **Nome da regra**, insira um nome para a regra.

1. Abra a lista **Tipo de regra** e selecione o tipo de regra que deseja usar.

1. Use os controles que aparecem para adicionar palavras-chave à regra e aplicar a lógica, como **mencionada** ou **não mencionada**.

1. Escolha **Próximo**.

### Examinar e criar
<a name="review-create"></a>

**Para criar o arquivo de configuração**

1. Revise as configurações em cada seção. Conforme necessário, escolha **Editar** para alterar uma configuração.

1. Escolha **Criar configuração**.

A configuração aparece na página **Configurações** do console do SDK do Amazon Chime.

# Usar configurações de análise de chamadas
<a name="use-ca-config"></a>

Depois de criar uma configuração, você a usa associando-a a um ou mais conectores de voz do Amazon Chime SDK. Para ter mais informações, consulte [Configurando conectores de voz para usar a análise de chamadas](configure-voicecon.md) no início deste guia.

# Atualizando as configurações de análise de chamadas
<a name="update-ca-config"></a>

As etapas desta seção explicam como atualizar uma configuração de análise de chamadas.

**Para atualizar uma configuração**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, em **Análise de chamadas**, escolha **Configurações** e, em seguida, escolha a configuração que você deseja atualizar.

1. No canto superior direito, escolha **Editar**.

1. Siga as etapas [Criação de configurações de análise de chamadas](create-ca-config.md) conforme necessário para alterar as configurações.

   Talvez seja necessário modificar as políticas da função de serviço para serem compatíveis com a configuração atualizada ou escolher uma nova função de serviço.

1. Ao terminar, escolha **Atualizar configuração**.

**nota**  
Se a configuração estiver associada a um conector de voz, o conector de voz usará essa configuração automaticamente. No entanto, se você ativar, desativar ou ajustar uma meta de notificação de análise de voz, aguarde cinco minutos para que essas novas configurações entrem em vigor.

# Excluindo configurações de análise de chamadas
<a name="delete-ca-config"></a>

As etapas desta seção explicam como excluir permanentemente uma configuração de análise de chamadas do Amazon Chime SDK.

**Importante**  
Você não pode desfazer uma exclusão.

**Para excluir uma configuração**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, em **Análise de chamadas**, escolha **Configurações** e, em seguida, escolha o botão de rádio ao lado da configuração que você deseja excluir.

1. Escolha **Excluir**.

1. Na caixa de diálogo **Excluir configuração**, insira **confirm** para confirmar a exclusão e escolha **Excluir**.

# Habilitando a análise de voz
<a name="enable-voice-analytics"></a>

**Importante**  
Como condição para usar esse recurso, você reconhece que a coleta, o uso, o armazenamento e a retenção dos identificadores biométricos e das informações biométricas do chamador (“dados biométricos”) na forma de um perfil de voz digital exigem o consentimento informado do chamador por meio de uma autorização por escrito. Esse consentimento é exigido por várias leis estaduais, incluindo leis de biometria em Illinois, Texas, Washington e outras leis estaduais de privacidade.  
Você deve fornecer uma autorização por escrito a cada chamador por meio de um processo que reflita claramente o consentimento informado de cada chamador antes de usar o serviço de análise de voz Amazon Chime SDK, conforme exigido pelos termos do seu contrato AWS que rege o uso do serviço.

**nota**  
Para habilitar a análise de voz, você deve ter pelo menos um conector de voz do SDK do Amazon Chime e pelo menos uma configuração de análise de chamadas do SDK do Amazon Chime. Para obter mais informações sobre a criação de conectores de voz, consulte[Criação de um conector de voz do Amazon Chime SDK](create-voicecon.md). Para obter informações sobre como criar uma configuração de análise de chamadas, consulte[Criação de configurações de análise de chamadas](create-ca-config.md). Para obter informações sobre como atualizar uma configuração, consulte 

Os tópicos desta seção explicam como habilitar a análise de voz do Amazon Chime SDK para conectores de voz do Amazon Chime SDK. A análise de voz usa aprendizado de máquina para habilitar alguns ou todos os itens a seguir:
+ **Pesquisa de alto-falantes** *— converte a voz de um chamador em uma incorporação vetorial.* Em seguida, ele compara a incorporação a um banco de dados de incorporações de voz conhecidas. Se encontrar uma correspondência ou correspondências, ele retornará uma lista classificada de correspondências de ID de perfil de voz de alta probabilidade, junto com um conjunto correspondente de pontuações de confiança.
**nota**  
A pesquisa de alto-falantes não foi projetada para casos de uso de autenticação ou verificação de identidade, como verificar a identidade de um locutor com precisão extremamente alta.
+ **Análise de tom de voz** — Prevê o sentimento expresso em um sinal de fala com base em uma análise combinada de informações linguísticas e tonais.
**nota**  
Como lembrete, você deve cumprir todos os requisitos legais ao usar a análise de tom de voz. Isso inclui obter o consentimento do palestrante, conforme exigido por lei, e não usar o recurso para tomar decisões sobre o palestrante que produziriam impactos legais ou igualmente significativos, como emprego, moradia, capacidade de crédito ou ofertas financeiras.

Para habilitar a análise de voz, os administradores usam o console do Amazon Chime SDK para fazer o seguinte: 
+ Configure os conectores de voz para usar um ou mais dos recursos listados acima.
+ Crie alvos de notificação. Os alvos de notificação recebem eventos de análise de voz de forma assíncrona, e você deve ter pelo menos um alvo.
+ Crie domínios de perfil de voz. Os domínios do perfil de voz contêm conjuntos de *perfis de voz*. Por sua vez, um perfil de voz consiste em uma incorporação vetorial da voz do chamador, além de um ID exclusivo. Por padrão, você pode criar 3 domínios de perfil de voz, e cada domínio pode abrigar 20.000 perfis de voz. Você pode solicitar um aumento para os dois limites, conforme necessário.

Os desenvolvedores podem usar um conjunto de APIs para realizar essas mesmas tarefas. *Para obter mais informações, consulte [Usando o serviço de análise de voz PSTN do Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/dg/pstn-voice-analytics.html), no Guia do desenvolvedor do Amazon Chime SDK.*

# Gerenciando domínios de perfil de voz
<a name="manage-voice-profile-domains"></a>

A pesquisa de alto-falantes do Amazon Chime SDK cria *perfis de voz* e mapas vetoriais da voz de um chamador. Um domínio de perfil de voz representa uma coleção de perfis de voz. Você deve criar um domínio de perfil de voz antes que os desenvolvedores possam ligar para o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartSpeakerSearchTask.html)API.

**Importante**  
O recurso de busca de alto-falantes envolve a criação de uma incorporação de voz, que pode ser usada para comparar a voz de um chamador com dados de voz armazenados anteriormente. A coleta, uso, armazenamento e retenção de identificadores biométricos e informações biométricas na forma de uma incorporação digital podem exigir o consentimento informado do chamador por meio de uma autorização por escrito. Esse consentimento é exigido por várias leis estaduais, incluindo leis de biometria em Illinois, Texas, Washington e outras leis estaduais de privacidade. Antes de usar o atributo de pesquisa de locutor, você deve fornecer todos os avisos e obter todos os consentimentos, conforme exigido por lei e de acordo com os [Termos de serviço da AWS](https://aws.amazon.com/service-terms/) que regem o uso do atributo.  
Você deve fornecer uma autorização por escrito a cada chamador por meio de um processo que reflita claramente o consentimento informado de cada chamador antes de usar o serviço de análise de voz Amazon Chime SDK, conforme exigido pelos termos do seu contrato AWS que rege o uso do serviço.

Os tópicos a seguir explicam como criar e gerenciar domínios de perfil de voz.

**Topics**
+ [Criação de domínios de perfil de voz](create-vp-domain.md)
+ [Editando domínios de perfil de voz](edit-vp-domain.md)
+ [Excluindo domínios do perfil de voz](delete-vp-domain.md)
+ [Usando tags com domínios de perfil de voz](vp-domain-tags.md)
+ [Entendendo o aviso de consentimento da análise de voz](va-consent-notice.md)

# Criação de domínios de perfil de voz
<a name="create-vp-domain"></a>

As etapas desta seção explicam como criar domínios de perfil de voz. Lembre-se do seguinte:
+ Os nomes de domínio não podem exceder 256 caracteres.
+ As descrições de domínio não podem exceder 512 caracteres.

O console do Amazon Chime SDK exibirá uma mensagem de erro se você exceder um dos limites.

**nota**  
Você deve usar uma chave KMS simétrica para criptografar todos os seus domínios. Para obter mais informações, consulte [Usando criptografia com análise de voz](analytics-encryption.md). Além disso, seus usuários finais devem consentir que suas vozes sejam gravadas antes de você iniciar uma sessão de análise de voz. Para obter mais informações sobre consentimento, consulte[Entendendo o aviso de consentimento da análise de voz](va-consent-notice.md).

**Para criar um domínio de perfil de voz**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, escolha **Domínios do perfil de voz**. 

1. Escolha **Criar domínio de perfil de voz**.

1. Em **Confirmação de consentimento**, escolha **Sim, eu concordo com a confirmação de consentimento para o Amazon Chime** Speaker Search. 

1. Em **Configuração**, insira um nome e uma descrição para o domínio e escolha uma chave KMS.

1. (Opcional) Em **Tags**, escolha **Adicionar nova tag** e insira uma chave e um valor opcional. Repita conforme necessário para adicionar mais tags.

1. Ao terminar, escolha **Criar domínio de perfil de voz**.

# Editando domínios de perfil de voz
<a name="edit-vp-domain"></a>

Você pode editar qualquer domínio de perfil de voz, independentemente de quem o criou.

**Para editar um domínio de perfil de voz**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, escolha **Domínios do perfil de voz**. 

1. Marque a caixa de seleção ao lado do domínio que você deseja editar e escolha **Editar**.

1. Conforme necessário, altere o nome e a descrição do domínio e escolha **Salvar**.

# Excluindo domínios do perfil de voz
<a name="delete-vp-domain"></a>

Você pode excluir qualquer domínio de perfil de voz, independentemente de quem o criou.

**Importante**  
Ao excluir um domínio, você também exclui todos os seus perfis de voz e não pode desfazer a exclusão.

**Para excluir um domínio de perfil de voz**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, escolha **Domínios do perfil de voz**. 

1. Marque a caixa de seleção ao lado do domínio que você deseja excluir e escolha **Excluir**.

1. Na caixa de diálogo exibida, escolha **Eu entendo que essa ação não pode ser revertida** e escolha **Excluir**.

# Usando tags com domínios de perfil de voz
<a name="vp-domain-tags"></a>

Os tópicos desta seção explicam como usar tags com seus domínios de perfil de voz existentes do Amazon Chime SDK. As tags permitem que você atribua metadados aos seus domínios. Uma tag consiste em uma chave e um valor opcional que armazena informações sobre o recurso ou os dados retidos nesse recurso. Você define todas as chaves e valores. Por exemplo, você pode criar uma chave de tag chamada *CostCenter*com um valor de *98765* e usar o par para fins de alocação de custos. Você pode adicionar até 50 tags a um domínio de perfil de voz.



## Adicionar tags aos domínios do perfil de voz
<a name="domain-add-tags"></a>

Siga estas etapas para adicionar tags a um domínio de perfil de voz existente.

**Como adicionar tags do**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, escolha **Domínios do perfil de voz**.

1. Escolha o domínio ao qual você deseja adicionar tags.

1. Escolha **Gerenciar tags** e escolha **Adicionar nova tag**.

1. Insira um valor na caixa **Chave** e um valor opcional na caixa **Valor**.

1. Conforme necessário, escolha **Adicionar nova tag** para criar outra tag.

1. Ao concluir, escolha **Salvar alterações**.

## Editando tags de domínio de perfil de voz
<a name="domain-edit-tags"></a>

Se você tiver as permissões necessárias, poderá editar qualquer tag na sua AWS conta, independentemente de quem as criou. No entanto, as políticas do IAM podem impedir que você faça isso.

**Como editar tags**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, escolha **Domínios do perfil de voz**. .

1. Escolha o domínio que tem as tags que você deseja editar.

1. Selecione **Gerenciar tags**.

1. Conforme necessário, altere os valores nas caixas **Chave** e **Valor**.

   —OU—

   Escolha **Adicionar nova tag** e adicione uma ou mais tags.

1. Ao concluir, escolha **Salvar alterações**.

## Removendo tags de domínio do perfil de voz
<a name="domain-remove-tags"></a>

Se você tiver as permissões necessárias, poderá remover todas as tags da sua AWS conta, independentemente de quem as criou. No entanto, as políticas do IAM podem impedir que você faça isso.

**Como remover tags**

1. [Abra o console do Amazon Chime SDK em casa. https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)

1. No painel de navegação, escolha **Domínios do perfil de voz**. .

1. Escolha o domínio que tem as tags que você deseja editar.

1. Selecione **Gerenciar tags**.

1. Escolha **Remover** em cada uma das tags que você deseja excluir.

1. Ao concluir, escolha **Salvar alterações**.

# Entendendo o aviso de consentimento da análise de voz
<a name="va-consent-notice"></a>

Ao criar um domínio de perfil de voz ou uma configuração de análise de chamadas que usa análise de voz, você vê esta confirmação de consentimento:

*Como condição para usar esse recurso, você reconhece que a coleta, o uso, o armazenamento e a retenção dos identificadores biométricos e das informações biométricas do locutor (“dados biométricos”) na forma de uma incorporação digital podem exigir o consentimento informado do palestrante, inclusive por meio de um comunicado por escrito. Esse consentimento é exigido por várias leis estaduais, incluindo leis de biometria em Illinois, Texas, Washington e outras leis estaduais de privacidade. Antes de usar a pesquisa de alto-falantes, você deve fornecer todos os avisos necessários e obter todos os consentimentos necessários de cada palestrante, conforme exigido pela lei aplicável e conforme estabelecido em nossos Termos de Serviço que regem o uso do recurso.* 

*Você deve fornecer uma autorização por escrito para cada chamador por meio de um processo que reflita claramente o consentimento informado de cada chamador antes de usar o serviço de análise de voz Amazon Chime SDK, conforme exigido pelos termos do seu contrato com a AWS que rege o uso do serviço.*

*Para cada palestrante em Illinois, conforme exigido pela Lei de Privacidade de Informações Biométricas (“BIPA”), você deve fornecer as seguintes informações por escrito, como uma declaração por escrito, por meio de um processo que reflita claramente o consentimento informado de cada chamador antes de usar a pesquisa de alto-falantes:*

*“[O nome da sua empresa (“Empresa”)] usa a Amazon Web Services como provedor de serviços para serviços de pesquisa por voz. Identificadores biométricos e informações biométricas (“dados biométricos”) podem ser coletados, armazenados e usados pela Amazon Web Services em nome da [Empresa] com o objetivo de comparar a voz de um chamador com dados de voz armazenados anteriormente. Os dados biométricos gerados como parte desse processo serão retidos por até três anos após sua última interação com a [Empresa], ou por mais tempo somente se permitido ou exigido pela lei aplicável e, posteriormente, destruídos. Exceto conforme exigido ou permitido pela lei aplicável, a [Empresa] instruirá a Amazon Web Services a destruir permanentemente os dados biométricos armazenados em nome da [Empresa] quando a finalidade inicial de coletar ou obter tais dados for satisfeita, dentro de três anos após sua última interação com os serviços, ou após ser informado por você de que esses dados devem ser destruídos, o que ocorrer primeiro. Os dados biométricos podem ser transmitidos entre a [Empresa] e a Amazon Web Services conforme necessário para fornecer e receber esse serviço. Você fornece sua autorização e consentimento expressos, informados e por escrito para que a [Empresa] e a Amazon Web Services coletem, usem e armazenem seus dados biométricos conforme descrito aqui.”*

*Ao marcar a caixa abaixo, você concorda em fornecer as informações anteriores por escrito e obter uma autorização por escrito de cada palestrante em Illinois, conforme exigido pelo BIPA.*