Gerenciar domínios do Amazon Connect Voice ID - Amazon Connect

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

Gerenciar domínios do Amazon Connect Voice ID

nota

Aviso de fim do suporte: em 20 de maio de 2026, a AWS encerrará o suporte para o Amazon Connect Voice ID. Depois de 20 de maio de 2026, você não poderá mais acessar o Voice ID no console do Amazon Connect, acessar os recursos do Voice ID no site de administração do Amazon Connect, no Painel de controle de contatos nem acessar os recursos do Voice ID. Para acessar mais informações, acesse Fim do suporte do Amazon Connect Voice ID.

O Amazon Connect Voice ID fornece APIs para gerenciar domínios do Voice ID. Você pode encontrar equivalentes para Criar, Descrever, Listar e Atualizar no Console da AWS.

  1. CreateDomain: para criar um domínio do Voice ID, use a API CreateDomain do Voice ID. Quando o domínio do Voice ID é criado, uma lista de observação padrão de fraudadores para reter fraudadores é criada ao mesmo tempo.

    Observe as diretrizes a seguir ao usar a API CreateDomain:

    • Você só pode invocá-la para sua conta depois de confirmar o consentimento da BIPA no Console da AWS.

    • Você também deve especificar a chave do KMS para o domínio do Voice ID no momento da criação.

    • Depois de criar um domínio do Voice ID, use as APIs de associação do Amazon Connect para associá-lo a uma instância do Amazon Connect.

  2. DeleteDomain: para excluir um domínio do Voice ID, você deve invocar a API DeleteDomain do Voice ID e fornecer o ID do domínio. Se esse domínio estiver associado a uma instância do Amazon Connect, as chamadas de API do Voice ID e os blocos de fluxo do Voice ID retornarão um erro de tempo de execução. A exclusão de um domínio do Voice ID exclui todos os dados armazenados do cliente, como gravações de áudio, impressões de voz e identificadores de locutor, bem como listas de fraudadores que você gerenciou.

  3. DescribeDomain: use essa API para retornar o nome, a descrição e a configuração de criptografia de um domínio existente identificado pelo DomainID.

  4. ListDomains: use essa API para listar todos os domínios do Voice ID pertencentes à sua conta na região.

  5. UpdateDomain: para atualizar o nome e a configuração de criptografia de um domínio, você pode usar a API UpdateDomain do Voice ID. Essa API substitui os atributos existentes e você deve fornecer esses dois campos.

    Quando você alterar a chave do KMS associada ao domínio do Voice ID, após a chamada de UpdateDomain, os dados existentes do seu domínio serão recriptografados de forma assíncrona sob a nova chave do KMS. Você pode verificar o status desse processo por meio do atributo ServerSideEncryptionUpdateDetails do seu domínio usando a API DescribeDomain. Enquanto esse processo de atualização estiver em andamento, você deverá manter a chave do KMS antiga em um estado acessível; caso contrário, esse processo poderá falhar. Depois que esse processo for concluído, a chave do KMS antiga poderá ser removida com segurança.