Habilitar o Voice ID

Antes de começar

Antes de começar, conclua as tarefas a seguir.

Conceder as permissões necessárias

Conceda as permissões necessárias a usuários, funções ou grupos. Para obter mais informações, consulte AmazonConnectVoiceID FullAccess.

O acesso às APIs do Voice ID usando o Painel de Controle de Contatos (CCP) está desabilitado por padrão.

Decida como nomear seu domínio do Voice ID

Ao ativar o Voice ID, você é solicitado a fornecer um nome de domínio amigável que seja significativo para você, como o nome da sua organização, por exemplo, Voice ID- ExampleCorp.

Crie uma AWS KMS key para criptografar dados armazenados no domínio

Quando você habilita o Voice ID, recebe uma solicitação para criar ou fornecer uma AWS KMS key. Ele criptografa os dados do cliente armazenados pelo Voice ID, como arquivos de áudio, impressões de voz e identificadores de locutor.

tep-by-step As instruções S para criar essas chaves KMS são fornecidas emEtapa 2: Criar um domínio do Voice ID e uma chave de criptografia.

Os dados em repouso, especificamente campos de formato livre que você fornece, além de arquivos de áudio/impressões de voz, são criptografados com a chave do KMS que você escolher. A chave gerenciada pelo cliente é criada e gerenciada por você e pertence a você. Você tem controle total sobre a chave do KMS (cobranças do AWS KMS são aplicáveis).

Ao fazer chamadas para o Voice ID para qualquer coisa que não seja CreateDomain ou UpdateDomain, o usuário que faz a chamada exige permissões kms:Decrypt para a chave associada ao domínio. Ao fazer chamadas para CreateDomain ou UpdateDomain, o usuário também exige permissões kms:DescribeKey e kms:CreateGrant para a chave. Quando você cria (ou atualiza) um domínio de ID de voz, ele cria uma concessão na chave do KMS para que possa ser usada por processos assíncronos de ID de voz (como inscrição de locutores) e pela função vinculada ao serviço Amazon Connect durante os fluxos. Essa concessão inclui um contexto de criptografia que especifica o domínio ao qual a chave está associada. Para obter mais informações, consulte Using grants no Guia do desenvolvedor.

Se você criar um domínio e associá-lo a uma chave, armazenar alguns dados e depois alterar a chave do KMS para uma chave diferente, um processo assíncrono será acionado para recriptografar os dados antigos com a nova chave KMS. Depois que esse processo for concluído, todos os dados do domínio serão criptografados com a nova chave do KMS, e você poderá retirar a chave antiga com segurança. Para obter mais informações, consulte UpdateDomain.

dica

Você pode criar chaves do KMS ou fornecer uma chave do KMS existente programaticamente. Para obter mais informações, consulte Amazon Connect Voice ID APIs.

Etapa 1: Ler a confirmação de consentimento da BIPA

A leitura da Confirmação de Consentimento da Lei de Privacidade Biométrica (BIPA) é um requisito para habilitar o Voice ID. Você precisa fazer isso apenas uma vez por conta, em todas as regiões. Você não pode realizar essa etapa usando APIs. Para obter mais informações sobre a BIPA, consulte este artigo da Wikipedia: Biometric Information Privacy Act.

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

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

   

3. No painel de navegação, escolha Voice ID. Leia a Confirmação de Consentimento da BIPA e aceite se você concordar.

   

Etapa 2: Criar um domínio do Voice ID e uma chave de criptografia

Você pode realizar essa etapa usando o console do Amazon Connect ou usando as APIs do Amazon Connect e do Voice ID.

Amazon Connect console instructions

1. Na seção Configuração de domínio, escolha Criar novo domínio.

   

2. Na caixa Nome do domínio, insira um nome amigável que seja significativo para você, como o nome da sua organização, por exemplo, VoiceID-. ExampleCorp

3. Em Criptografia, crie ou insira sua própria AWS KMS key para criptografar o domínio do Voice ID. Siga estas etapas para criar a chave do KMS:

   1. Escolha Criar chave.

      

   2. Uma nova guia no navegador é aberta para o console do Key Management Service (KMS). Na página Configurar chave, escolha Simétrica e selecione Próximo.

      

   3. Na página Adicionar rótulos, adicione um nome e uma descrição para a chave do KMS e escolha Próximo.

   4. Na página Definir permissões administrativas da chave, escolha Próximo.

   5. Na página Definir permissões de uso da chave, escolha Próximo.

   6. Na página Revisar e editar política de chave, escolha Concluir.

   7. Volte para a guia no navegador do console do Amazon Connect, página Voice ID. Clique ou toque na AWS KMS key para que a chave que você criou apareça em uma lista suspensa. Escolha a chave que foi criada.

4. Escolha Habilitar o Voice ID.

API instructions

1. Chame a CreateDomainAPI para criar um novo domínio de ID de voz.

2. Chame a CreateIntegrationAssociationAPI para associar o domínio do Voice ID à instância do Amazon Connect.

   1. Passe o ARN do domínio de ID de voz recém-criado para o parâmetro IntegrationArn. Para IntegrationType, use VOICE_ID.

Você habilitou o Voice ID para a instância. O seguinte foi criado:

• O domínio do Voice ID e uma lista de observação padrão de fraudadores que deterá seus fraudadores.

• Uma EventBridge regra gerenciada da Amazon em sua conta. Essa regra é usada para ingerir eventos do Voice ID e criar registros de contato relacionados ao Voice ID. Além disso, o Amazon Connect adiciona Permissões do Voice ID à função vinculada ao serviço do Amazon Connect.

Em seguida, na Etapa 3, você configura como deseja que o Voice ID funcione em no fluxo.

Etapa 3: Configurar o Voice ID em seu fluxo de contatos

Nesta etapa, você adiciona os blocos necessários ao seu fluxo e configura como deseja que o Voice ID funcione.

• Play prompt (Reproduzir aviso): adicione esse bloco antes do bloco Definir ID da voz para transmitir o áudio corretamente. Você pode editá-lo para incluir uma mensagem simples, como “Boas-vindas”.

• Definir ID da voz: depois do bloco Play prompt (Reproduzir aviso), adicione o bloco Definir ID da voz. Deve ser no início de uma chamada. Use esse bloco para começar a transmitir áudio ao Amazon Connect Voice ID e verificar a identidade do chamador, assim que a chamada for conectada a um fluxo.

  No bloco Definir ID da voz, você configura o limite de autenticação, o tempo de resposta, o limite de fraude e a lista de observação de fraudadores a serem usados na detecção de fraudadores conhecidos.

• Set contact attributes (Definir atributos do contato): use para passar o atributo CustomerId para o Voice ID. CustomerId pode ser um número de cliente do seu CRM, por exemplo. Você pode criar uma função do Lambda para extrair do seu sistema de CRM o ID exclusivo de cliente do chamador. O Voice ID usa esse atributo como CustomerSpeakerId para o chamador.

  nota

  CustomerId pode ser um valor alfanumérico. Ele só dá suporte a caracteres especiais _ e - (sublinhado e hífen). Ele não precisa ser UUID Como o Voice ID armazena informações biométricas de cada alto-falante, é altamente recomendável que você use um identificador que não contenha PII no campo. CustomerSpeakerId Para obter mais informações, consulte CustomerSpeakerId no tipo de dados Palestrante.

• Verificar ID da voz: use para verificar a resposta do Voice ID quanto ao status da inscrição, autenticação por voz e detecção de fraudes e, em seguida, ramifique com base em um dos status retornados.

Exemplo de fluxo do Voice ID

Chamador não inscrito

1. Quando um cliente liga pela primeira vez, CustomerId é passado para o Voice ID usando o bloco Set contact attributes (Definir atributos do contato).

2. O Voice ID procura CustomerId no respectivo banco de dados. Como ele não está lá, ele envia uma mensagem de resultado Não inscrito. O bloco Verificar ID da voz se ramifica com base nesse resultado e você pode decidir qual deve ser a próxima etapa. Por exemplo, digamos que os atendentes inscrevam o cliente na autenticação por voz.

3. O Voice ID começa a ouvir a fala do cliente depois que o contato encontra o bloco Definir ID da voz, onde o Voice ID está habilitado. Ele escuta até acumular 30 segundos de fala na rede ou a chamada termina, o que acontecer primeiro.

Chamador inscrito

1. Na próxima vez que o cliente ligar, o Voice ID os encontrará CustomerId no banco de dados.

2. O Voice ID começa a ouvir o áudio para criar uma impressão de voz. A impressão de voz criada dessa vez é usada para fins de autenticação para que o Voice ID possa comparar se o chamador foi inscrito anteriormente.

3. Ele compara a impressão de voz atual do chamador com a impressão de voz armazenada associada à identidade reivindicada. Ele retorna um resultado com base na propriedade de limite de autenticação que você configurou no bloco Definir ID da voz.

4. Depois de avaliar a fala, ele retornará a mensagem Autenticado se as impressões de voz forem semelhantes. Ou retornará um dos outros status.

5. O contato é então roteado pela ramificação apropriada pelo bloco Verificar ID da voz.