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 a autenticação de chamadas em tempo real com o Voice ID no Amazon Connect
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para obter mais informações, acesse [Fim do suporte ao Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
O Amazon Connect Voice ID fornece autenticação de chamadas em tempo real e detecção de risco de fraude, o que torna as interações de voz nas centrais de atendimento mais seguras e eficientes. O Voice ID usa machine learning para verificar a identidade de clientes genuínos analisando as características de voz exclusivas do chamador. Isso permite que as centrais de atendimento usem uma camada de segurança adicional que não depende de o chamador responder a várias perguntas de segurança e facilita a inscrição e a verificação de clientes sem alterar o fluxo natural da conversa. O Voice ID também oferece detecção em tempo real de fraudadores que frequentemente atacam a central de atendimento, reduzindo assim as perdas causadas por fraudes.
Com o Amazon Connect ID, você pode:
+ Inscrever passivamente os clientes para autenticação por voz sem exigir que eles repitam uma palavra ou frase específica.
+ Migrar clientes para o Voice ID inscrevendo-os em lote.
+ Verificar a identidade do cliente inscrito analisando suas características de voz exclusivas.
+ Detectar fraudadores em uma lista de observação que você criou.
+ Detectar falsificação de voz.
## Como funciona o Voice ID
### Inscrição de clientes
1. Quando um cliente liga pela primeira vez, o atendente confirma a identidade do chamador usando as medidas de segurança existentes, como solicitar o nome de solteira da mãe ou uma senha de uso único (OTP) entregue por SMS. Isso garante que somente clientes genuínos sejam inscritos no Voice ID.
1. O Voice ID começa a ouvir a fala do cliente depois que o contato encontra o bloco [Definir ID da voz](set-voice-id.md), onde o Voice ID está habilitado. O Voice ID escuta a chamada até que um dos seguintes eventos ocorra:
+ Ele obtém áudio suficiente para avaliar o locutor em busca de autenticação e fraude e inscrever o locutor (se solicitado). São 30 segundos de fala do cliente, excluindo o silêncio.
+ A ligação termina.
1. Em seguida, o Voice ID cria a impressão de voz de inscrição. Uma impressão de voz é uma representação matemática que captura implicitamente aspectos únicos da voz de um indivíduo, como ritmo, tom, entonação e volume da fala.
O chamador não precisa dizer ou repetir nenhuma frase específica para se inscrever no Voice ID.
### Autenticação do cliente
1. Quando o cliente inscrito liga de volta, ele é verificado por meio de uma interação com um IVR ou durante a interação com um atendente.
Por padrão, o Voice ID é configurado para exigir 10 segundos da fala do chamador para ser autenticado, o que pode ser feito como parte de uma interação típica do cliente no IVR ou com o atendente (como “qual é seu nome e sobrenome?” e “por que você está ligando?”). Você pode ajustar a quantidade de fala necessária usando a propriedade [Tempo de resposta da autenticação](set-voice-id.md#set-voice-id-properties-authentication-response-time) no bloco [Definir ID da voz](set-voice-id.md).
1. O Voice ID usa o áudio para gerar a impressão de voz do chamador e a compara com a impressão de voz registrada correspondente à identidade reivindicada e retorna um resultado de autenticação.
Para obter mais informações sobre a experiência do atendente, consulte [Inscrever os chamadores no Voice ID no Painel de controle do contato (CCP)](use-voiceid.md).
## Que tempo de fala é necessário para inscrição e autenticação
+ Inscrição: 30 segundos de fala via rede do cliente (fala que exclui qualquer silêncio) para criar uma impressão de voz e inscrever um cliente.
+ Verificação: por padrão, 10 segundos de fala na rede do cliente para verificar se a voz pertence à identidade reivindicada. A fala pode ser proveniente da interação com um IVR ou um atendente. Você pode ajustar a quantidade de fala necessária usando a propriedade [Tempo de resposta da autenticação](set-voice-id.md#set-voice-id-properties-authentication-response-time) no [Definir ID da voz](set-voice-id.md).
## Inscrição em lote
Você pode começar a usar a biometria inscrevendo em lote clientes que já consentiram com a biometria. Usando gravações de áudio armazenadas em seu bucket do S3 e um arquivo de entrada JSON que fornece o identificador do alto-falante e um link para as gravações de áudio, você pode invocar o lote de ID de voz. APIs
Para obter mais informações, consulte [Inscrição em lote no Amazon Connect Voice ID usando dados de áudio de chamadas anteriores](voiceid-batch-enrollment.md).
## Detecção de fraudadores conhecidos
Existem algumas etapas para configurar a detecção em tempo real de fraudadores:
1. [Crie uma nova lista de observação](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html) para armazenar fraudadores conhecidos. Ou use a lista de observação padrão criada quando o Voice ID está habilitado.
1. [Registre os fraudadores](voiceid-fraudster-watchlist.md) na nova lista de observação ou na lista de observação padrão.
1. No bloco [Definir ID da voz](set-voice-id.md), especifique qual lista de observação você deseja usar.
Quando um dos fraudadores da lista de observação especificada no fluxo liga para a central de atendimento, o Voice ID analisa o áudio da chamada para retornar uma pontuação de risco e um resultado. Essa pontuação indica o quanto a impressão de voz do chamador coincide com a do fraudador na lista de observação. O Voice ID requer 10 segundos de áudio para avaliar o áudio da chamada quanto ao risco de fraude de fraudadores conhecidos.
### Lista de observação padrão
Quando o domínio do Voice ID é criado, o Voice ID cria uma lista padrão de vigilância de fraudadores para esse domínio. O nome e a descrição da lista padrão de vigilância de fraudadores são criptografados usando a chave do KMS fornecida no domínio e salva no Voice ID.
Se você não fornecer o WatchListID do fraudador para detecção ou registro de fraudadores, o Voice ID usará a lista de observação padrão do fraudador.
Você não pode atualizar os metadados da lista de vigilância de fraudadores padrão, mas pode associar ou dissociar fraudadores dela.
**nota**
Se seu domínio do Voice ID foi criado antes de março de 2023, quando as listas de observação de fraudadores foram lançadas: uma lista de observação padrão foi criada e todos os fraudadores existentes foram colocados nela.
## Detecção de falsificação de voz
1. Quando um possível fraudador tenta falsificar o áudio do chamador usando reprodução de áudio ou fala sintetizada, o Voice ID retorna uma pontuação de risco e um resultado para indicar a probabilidade de a voz ser falsificada.
1. A falsificação de voz só é ativada quando você habilita o recurso de detecção de fraudes no fluxo de contatos. As pontuações de falsificação de voz não são retornadas quando somente a autenticação de palestrante está ativada.
1. O Voice ID requer 10 segundos de áudio para avaliar o áudio da chamada quanto ao risco de fraude de fraudadores conhecidos.
## Quais dados são armazenados?
O Voice ID armazena arquivos de áudio de voz, impressões de voz e identificadores do locutor. Esses dados são criptografados usando uma chave do KMS fornecida por você.
Se você habilitar a detecção de fraudadores em uma lista de observação, o Voice ID também armazenará o áudio e as impressões de voz do fraudador. Para obter mais informações, consulte [Dados processados pelo Amazon Connect](data-handled-by-connect.md).
# Fim de suporte do Amazon Connect Voice ID
Após uma análise cuidadosa, decidimos encerrar o suporte do Amazon Connect Voice ID a partir de 20 de maio de 2026. O Amazon Connect Voice ID não aceitará mais novos clientes a partir de 20 de maio de 2025. Como cliente existente com uma conta cadastrada no serviço antes de 20 de maio de 2025, você pode continuar usando os recursos do Amazon Connect Voice ID. Após 20 de maio de 2026, você não poderá mais usar o Amazon Connect Voice ID.
Esta página fornece instruções e práticas recomendadas para administradores e usuários de TI do Amazon Connect fazerem a transição do Voice ID para soluções alternativas a fim de atender às suas necessidades comerciais. Isso pode incluir soluções de AWS parceiros disponíveis no AWS Marketplace, como [Pindrop®](https://aws.amazon.com/marketplace/pp/prodview-f7rqlwjby3er4), ou do-it-yourself soluções com AWS End User Messaging SMS.
## Do-it-yourself soluções com AWS End User Messaging SMS
Você pode melhorar a segurança do contact center habilitando a autenticação baseada em One-Time-Pin (OTP) para o seu contact center com AWS End User Messaging SMS. Você pode consultar um exemplo de solução para habilitar OTPs o uso AWS End User Messaging SMS para criar uma para seu contact center. Para obter mais informações sobre essa solução, consulte a seguinte postagem no blog: [Crie uma arquitetura segura de senha única com AWS](https://aws.amazon.com/blogs/messaging-and-targeting/build-a-secure-one-time-password-architecture-with-aws/). Para obter mais informações sobre AWS End User Messaging SMS, consulte [O que é AWS End User Messaging SMS?](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-sms-mms.html)
## Gerenciar seus dados do Voice ID
Você pode obter informações sobre todos os seus domínios do Voice ID em sua AWS contabilidade usando a `ListDomains` API Voice ID em conjunto com a `DescribeDomain` API. Para acessar mais informações sobre o gerenciamento de domínios do Amazon Connect Voice ID, consulte [Gerenciar domínios do Amazon Connect Voice ID](voiceid-domain-operations.md).
Para um domínio específico do Voice ID, é possível baixar dados sobre chamadores inscritos usando a API `ListSpeakers` e fraudadores registrados usando a API `ListFraudsters`. Para acessar mais informações sobre locutores e fraudadores, consulte [Gerenciamento de alto-falantes, listas de observação e fraudadores do Amazon Connect Voice ID APIs](voiceid-speaker-fraudster-management-apis.md). Você pode garantir que todos os dados de seus clientes no Voice ID sejam excluídos usando a API `DeleteDomain` do Voice ID. Você precisa realizar essa operação para cada domínio do Voice ID em cada AWS região e em cada conta.
# Domínios de Voice ID no Amazon Connect Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para acessar mais informações, acesse [Fim do suporte do Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Ao habilitar o Amazon Connect Voice ID, você cria um domínio de Voice ID: um contêiner para todos os dados do Voice ID, como identificadores de locutor (que servem como identificador do cliente), impressões de voz, áudio do cliente que foi usado para criar as impressões de voz de inscrição e os status de inscrição (inscritos, cancelados etc.) associados aos identificadores de locutor. Para detectar fraudadores em uma lista de observação, o domínio do Voice ID armazena os identificadores de fraudadores, as impressões de voz e o áudio usados para criar as impressões de voz.
Veja abaixo as diretrizes para criar domínios de ID de voz:
+ Cada instância do Amazon Connect só pode ser associada a um domínio.
+ Cada instância do Amazon Connect só pode ser associada a um domínio. Isso permite que você use os mesmos dados de clientes armazenados em várias instâncias do Amazon Connect.
+ Você pode criar vários domínios, mas eles não compartilham integrações de aplicações externas ou dados de clientes entre si.
+ Recomendamos criar um novo domínio de ID de voz para associar a uma instância do Amazon Connect quando:
+ Você está habilitando o Voice ID pela primeira vez em sua conta em uma região da AWS .
+ Você quer garantir o isolamento dos domínios do Voice ID usados nos ambientes de teste e produção.
+ Recomendamos usar um domínio de ID de voz existente quando:
+ Você deseja usar o mesmo conjunto de chamadores e fraudadores inscritos em diferentes instâncias do Amazon Connect (que podem pertencer a diferentes equipes de atendimento ao cliente)
+ Você quer usar o mesmo ambiente de teste em diferentes instâncias de teste do Amazon Connect.
**nota**
Somente domínios de Voice ID existentes na mesma região em sua conta do Amazon Connect podem ser compartilhados entre instâncias do Amazon Connect nessa região.
+ Você pode alterar a associação da instância do Amazon Connect do domínio atual para um novo domínio a qualquer momento, escolhendo um domínio diferente.
+ Para excluir um domínio do Voice ID, use a API [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html)Voice ID. `DeleteDomain`exclui o domínio de forma reversível. O Amazon Connect espera 30 dias antes de apagar completamente os dados do domínio. Durante esse período, o Voice ID é desabilitado para todas as instâncias do Amazon Connect às quais está associado. Para restaurar um domínio durante essa janela, envie um Suporte ticket e forneça o ID do domínio. Você pode encontrar o ID do domínio na seção Voice ID do console do Amazon Connect Connect.
![\[A seção Voice ID do console do Amazon Connect exibindo o campo de ID do domínio que é necessário para a restauração do domínio.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/voiceid-domain.png)
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 todas as listas de observação de fraudadores que você gerenciou.
## Status da inscrição
O Voice ID armazena três status de inscrição diferentes para um locutor: `ENROLLED` ` OPTED_OUT` e `EXPIRED`. Você pode recuperar o status desses alto-falantes usando o [Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/) e usando blocos de fluxo de contato para tomar as medidas apropriadas.
+ `ENROLLED`: quando um novo chamador é inscrito no Voice ID, o Voice ID cria uma nova impressão de voz e define o status do locutor como `ENROLLED`. Mesmo que você reinscreva o mesmo chamador no Voice ID, o status permanece como `ENROLLED`.
+ `OPTED_OUT`: Se um chamador não der consentimento para se inscrever na biometria, você pode cancelar o chamador (no Painel de Controle de Contato) ou usar. APIs O Voice ID cria uma nova entrada para esse chamador e define o status `OPTED_OUT` do locutor. O Voice ID não gera nenhuma impressão de voz nem armazena nenhuma gravação de áudio para o locutor. Solicitações futuras de inscrição para esse locutor serão rejeitadas, a menos que a respectiva inscrição seja excluída.
+ `EXPIRED`: Se a impressão de voz de um chamador não tiver sido acessada ou atualizada por três anos, o Voice ID mudará o status para `EXPIRED`, e você não poderá mais realizar autenticações para esse chamador. Você pode reinscrever o chamador novamente ou excluí-lo do Voice ID.
## Locutores expirados
Para conformidade com o BIPA, o Voice ID expira automaticamente os locutores que não foram acessados para inscrição, reinscrição ou autenticação bem-sucedida por três anos.
Para ver o último acesso de um alto-falante, veja o `lastAccessedAt` atributo retornado pelo `DescribeSpeaker` `ListSpeakers` APIs e.
Se você tentar usar a API `EvaluateSesssion` para autenticar um locutor expirado, uma decisão de autenticação `SPEAKER_EXPIRED` será retornada.
Para usar o locutor expirado novamente, ele deve ser reinscrito.
## Identificadores de locutor e fraudador
O Voice ID usa identificadores de locutor para se referir e recuperar as impressões de voz em um domínio do Voice ID. Recomendamos que você use identificadores que não contenham informações de identificação pessoal (PII) nos identificadores.
O Voice ID cria dois campos para se referir a um chamador:
+ `CustomerSpeakerId`: um identificador fornecido pelo cliente. Ele pode ter entre 1 e 256 caracteres e só pode conter: **a-z, **A-Z****, **0-9**, **-** e **\$1**
+ `GeneratedSpeakerId`: uma sequência alfanumérica exclusiva de 22 caracteres que o Voice ID cria e retorna no momento da inscrição do chamador.
Os [alto-falantes do Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/Welcome.html) aceitam qualquer forma de identificadores de alto-falante, mas só são emitidos `GeneratedSpeakerId` nos streams de eventos e registros de contatos do Voice ID. Se você quiser regravar o chamador para refazer a impressão de voz, poderá inscrevê-lo com o mesmo `CustomerSpeakerId`.
Da mesma forma, o Voice ID cria identificadores exclusivos de fraudadores chamados `GeneratedFraudsterID` para cada fraudador que você adiciona a uma lista de observação no domínio. O Voice ID retorna o identificador do fraudador se um fraudador for detectado em uma chamada ao realizar a detecção de risco de fraude.
# Conceitos básicos de como habilitar o Voice ID no Amazon Connect
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para acessar mais informações, acesse [Fim do suporte do Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Antes de começar
Antes de começar, conclua as tarefas a seguir.
**Topics**
+ [Conceder as permissões necessárias](#enable-voiceid-permissions)
+ [Decida como nomear seu domínio do Voice ID](#enable-voiceid-domains)
+ [Crie um AWS KMS key para criptografar os dados armazenados no domínio](#enable-voiceid-awsmanagedkey)
### 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 [AmazonConnectVoiceIDFullAccess](security_iam_awsmanpol.md#amazonconnectvoiceidfullaccesspolicy).
O acesso ao Voice ID APIs usando o Painel de Controle de Contatos (CCP) está desativado 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 um AWS KMS key para criptografar os dados armazenados no domínio
Quando você habilita o Voice ID, recebe uma solicitação para criar ou fornecer uma [AWS KMS key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys). Ele criptografa os dados do cliente armazenados pelo Voice ID, como arquivos de áudio, impressões de voz e identificadores de locutor.
Step-by-step as instruções para criar essas chaves KMS são fornecidas em[Etapa 2: Criar um domínio do Voice ID e uma chave de criptografia](#enable-voiceid-step2).
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 KMS (AWS KMS taxas 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 acessar mais informações sobre concessões, consulte [Usar concessões](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html) no Guia do desenvolvedor do AWS Key Management Service .
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](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_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](https://docs.aws.amazon.com/voiceid/latest/APIReference/).
## 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 executar essa etapa usando APIs. Para obter mais informações sobre a BIPA, consulte este artigo da Wikipedia: [Biometric Information Privacy Act](https://en.wikipedia.org/wiki/Biometric_Information_Privacy_Act).
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.
![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png)
1. No painel de navegação, escolha **Voice ID**. Leia a Confirmação de Consentimento da BIPA e aceite se você concordar.
![\[A página Habilitar ID de voz mostrando o botão de confirmação de consentimento da BIPA (Lei de Privacidade de Informações Biométricas) que os usuários devem ler e aceitar antes de habilitar o Voice ID.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/voiceid-bipa.png)
## 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 o Amazon Connect e o Voice ID APIs.
------
#### [ Amazon Connect console instructions ]
1. Na seção **Configuração de domínio**, escolha **Criar novo domínio**.
![\[Interface de configuração do domínio com opções para criar um domínio ou escolher um existente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/voiceid-enable-domain.png)
1. 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
1. Em **Criptografia**, crie ou insira seu próprio domínio AWS KMS key para criptografar seu domínio do Voice ID. Siga estas etapas para criar a chave do KMS:
1. Escolha **Criar chave**.
![\[Seção de criptografia da página de configuração do Voice ID mostrando o botão “Criar chave do AWS KMS” para criar uma chave de criptografia.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/voiceid-create-kms-key.png)
1. 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**.
![\[Configure a página da chave com o tipo de chave simétrica selecionado para criptografia e descriptografia.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
1. Na página **Adicionar rótulos**, adicione um nome e uma descrição para a chave do KMS e escolha **Próximo**.
1. Na página **Definir permissões administrativas da chave**, escolha **Próximo**.
1. Na página **Definir permissões de uso da chave**, escolha **Próximo**.
1. Na página **Revisar e editar política de chave**, escolha **Concluir**.
1. 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.
1. Escolha **Habilitar o Voice ID**.
------
#### [ API instructions ]
1. Chame a [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html)API para criar um novo domínio de ID de voz.
1. Chame a [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API 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](connect-slr.md) à 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)](play.md): adicione esse bloco antes do bloco [Definir ID da voz](set-voice-id.md) para transmitir o áudio corretamente. Você pode editá-lo para incluir uma mensagem simples, como “Boas-vindas”.
+ [Definir ID da voz](set-voice-id.md): depois do bloco [Play prompt (Reproduzir aviso)](play.md), adicione o bloco [Definir ID da voz](set-voice-id.md). 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)](set-contact-attributes.md): 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 \$1 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](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_Speaker.html).
+ [Verificar ID da voz](check-voice-id.md): 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)](set-contact-attributes.md).
1. 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](check-voice-id.md) 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.
1. O Voice ID começa a ouvir a fala do cliente depois que o contato encontra o bloco [Definir ID da voz](set-voice-id.md), 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.
1. 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.
1. 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](set-voice-id.md).
1. Depois de avaliar a fala, ele retornará a mensagem **Autenticado** se as impressões de voz forem semelhantes. Ou retornará um dos outros status.
1. O contato é então roteado pela ramificação apropriada pelo bloco [Verificar ID da voz](check-voice-id.md).
# Permissões do perfil de segurança para o Amazon Connect Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para acessar mais informações, acesse [Fim do suporte do Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
+ Para permitir que os usuários pesquisem contatos pelo status do Voice ID, atribua a seguinte permissão de **Análise e otimização** ao perfil de segurança:
+ **Voice ID - atributos e pesquisa**: permite que os usuários pesquisem e visualizem os resultados do Voice ID na página **Detalhes de contato**.
+ Para conceder aos atendentes acesso ao Voice ID no Painel de Controle de Contatos, atribua a seguinte permissão no grupo **Painel de Controle de Contatos**:
+ **ID de voz - Acesso**: habilita controles no Painel de Controle de Contatos para que os atendentes possam:
+ Ver os resultados da autenticação.
+ Desativar ou reautenticar um chamador.
+ Atualizar `SpeakerID`.
+ Visualize os resultados da detecção de fraudes, execute novamente a análise de fraudes (decisão de detecção de fraudes, tipo e pontuação de fraude).
**nota**
A funcionalidade para inserir ou atualizar o `SpeakerID` não está disponível com o widget Voice ID padrão no CCP. Para incluir a opção de atualização do `SpeakerID`, implemente a API `updateVoiceIdSpeakerId` do [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) no CCP personalizado.
A imagem a seguir mostra um exemplo desses controles no CCP:
![\[Painel de controle do contato (CCP) mostrando controles do Voice ID incluindo status da inscrição, resultado da autenticação e botões para inscrever ou cancelar clientes.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/voiceid-ccp-controls.png)
Para obter informações sobre como adicionar mais permissões a um perfil de segurança existente, consulte [Atualizar perfis de segurança no Amazon Connect](update-security-profiles.md).
Por padrão, o perfil de segurança **Admin** já tem permissões para realizar todas as atividades da tarefa.
# Pesquisar e analisar os resultados da autenticação do Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para acessar mais informações, acesse [Fim do suporte do Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Use a página [Pesquisa de contato](contact-search.md) para pesquisar e analisar os resultados do status da inscrição, autenticação por voz e detecção de fraudadores em uma lista de observação. Com as [permissões de perfil de segurança](contact-search.md#required-permissions-search-contacts) necessárias (**Análise e otimização** - **Voice ID - atributos e pesquisa - Visualizar**), você pode pesquisar os resultados do Voice ID usando os seguintes filtros:
+ **Ações do locutor**: use esse filtro para pesquisar contatos nos quais o chamador foi inscrito no Voice ID ou optou por não participar do Voice ID.
+ **Resultado da autenticação**: use esse filtro para pesquisar contatos nos quais a autenticação do Voice ID retornou os seguintes resultados:
+ Autenticado
+ Não autenticado
+ Optou por não participar
+ Inconclusivo
+ Não inscrito
Por exemplo, se você quiser pesquisar todos os contatos em que o status de autenticação foi retornado como **Não autenticado** ou **Optou por não participar**, selecione essas duas opções e escolha **Aplicar**.
+ **Resultado da detecção de fraudes**: use esse filtro para pesquisar contatos nos quais a análise de fraude do Voice ID retornou os seguintes resultados:
+ Alto risco de fraude
+ Alto risco de fraude
+ Inconclusivo
+ **Motivo da detecção de fraudes**: use esse filtro para pesquisar contatos nos quais mecanismos específicos de risco de fraude foram detectados:
+ Fraudador conhecido: a voz do chamador corresponde à de um fraudador da lista de observação de fraudadores que você criou.
+ Falsificação de voz: o chamador está modificando sua voz ou está usando a síntese de voz para falsificar o atendente.
## O Voice ID gera um registro de contato
Depois de pesquisar um contato, você pode escolher um ID para visualizar seu registro de contato. A imagem a seguir mostra um exemplo dos campos na seção Voice ID do registro de contato:
![\[Seção do Voice ID de um registro de contato mostrando os resultados da autenticação, o status da detecção de fraudadores e o ID da lista de observação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/voiceid-ctr-nospoofing.png)
# Gerencie o Amazon Connect Voice ID com o Voice ID APIs
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para obter mais informações, acesse [Fim do suporte ao Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Para gerenciar o Voice ID de forma programática, consulte [Amazon Connect Voice](https://docs.aws.amazon.com/voiceid/latest/APIReference/) ID. APIs
Esta seção explica como realizar cenários comuns usando o Voice ID APIs.
**Topics**
+ [Gerenciar domínios do Amazon Connect Voice ID](voiceid-domain-operations.md)
+ [Associação de integração do Amazon Connect APIs](voiceid-integration-association-apis.md)
+ [Gerenciamento de palestrantes, listas de observação e fraudadores APIs](voiceid-speaker-fraudster-management-apis.md)
+ [Inscrição em lote no Amazon Connect Voice ID usando dados de áudio de chamadas anteriores](voiceid-batch-enrollment.md)
+ [Esquema de arquivos para o trabalho de inscrição de locutor](speaker-enrollment-job-schema.md)
+ [Criar e editar uma lista de observação de fraudadores no Amazon Connect Voice ID](voiceid-fraudster-watchlist.md)
+ [Esquema de arquivos para o trabalho de registro de fraudadores](fraudster-registration-schema.md)
+ [Amazon Connect Streams integrará APIs o Voice ID](voiceid-streams-apis.md)
# Gerenciar domínios do Amazon Connect Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para obter mais informações, acesse [Fim do suporte ao Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
O Amazon Connect Voice ID permite APIs que você gerencie domínios de Voice ID. Você pode encontrar equivalentes para Criar, Descrever, Listar e Atualizar no AWS console.
1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html): para criar um novo domínio de Voice ID, use a API `CreateDomain` 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 invocar isso para sua conta depois de confirmar o consentimento do BIPA no console. 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 de ID de voz, use a [associação do Amazon Connect APIs](https://docs.aws.amazon.com/connect/latest/APIReference/) para associá-lo a uma instância do Amazon Connect.
1. [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html): para excluir um domínio do Voice ID, você deve invocar a API do `DeleteDomain` 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.
1. [DescribeDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeDomain.html): use essa API para retornar o nome, a descrição e a configuração de criptografia de um domínio existente identificado por ela`DomainID`.
1. [ListDomains](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListDomains.html): use essa API para listar todos os domínios do Voice ID pertencentes à sua conta na região.
1. [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain.html): para atualizar o nome e a configuração de criptografia de um domínio, você pode usar a API `UpdateDomain` 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.
# Associação de integração entre Voice ID e Amazon Connect APIs
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para obter mais informações, acesse [Fim do suporte ao Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Você pode usar o seguinte APIs para gerenciar associações com instâncias do Amazon Connect. Você também pode realizar essas operações no AWS console.
1. [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html): Para habilitar o Voice ID em uma instância do Amazon Connect, você precisará associar um domínio do Voice ID a uma instância do Amazon Connect usando uma `CreateIntegrationAssociation` solicitação. Você só pode associar um domínio do Voice ID a uma instância do Amazon Connect. Se a instância já estiver associada a um domínio, a API retornará o seguinte erro:
`DuplicateResourceException` (409): a solicitação está tentando criar um recurso duplicado.
**nota**
Quando você habilita o Voice ID para uma instância do Amazon Connect (usando o console do Amazon Connect ou a [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API), o Amazon Connect cria 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](connect-slr.md) à função vinculada ao serviço do Amazon Connect.
1. [DeleteIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteIntegrationAssociation.html): Para excluir uma associação existente entre uma instância do Amazon Connect e um domínio do Voice ID, você precisará chamar o `DeleteIntegrationAssociation` APIs junto com o InstanceID do Amazon Connect e `IntegrationAssociationID` o retornado por. `CreateIntegrationAssociation` Essa é uma etapa obrigatória se você quiser associar um domínio do Voice ID diferente a essa instância do Amazon Connect. Não recomendamos excluir associações em uma configuração de produção, pois isso pode causar um comportamento imprevisível para o Voice ID na instância do Amazon Connect.
1. [ListIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListIntegrationAssociations.html): Para listar todas as associações entre a instância do Amazon Connect e os domínios do Voice ID para sua conta nesta região, você pode invocar `ListIntegrationAssociations` a API.
# Gerenciamento de alto-falantes, listas de observação e fraudadores do Amazon Connect Voice ID APIs
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para obter mais informações, acesse [Fim do suporte ao Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
O Amazon Connect Voice ID inclui APIs o gerenciamento de alto-falantes inscritos em um domínio de ID de voz e fraudadores registrados no domínio. Todos os palestrantes APIs`ListSpeakers`, exceto, aceitam o `CustomerSpeakerId` ou`GeneratedSpeakerId`.
## Gerenciamento de alto-falantes APIs
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html): descreva o [status de um palestrante em um domínio (ENROLLED, OPTED\$1OUT, EXPIRED)](voiceid-domain.md#voiceid-speaker-enrollments) e mapeie a para a e `GeneratedSpeakerId` vice-versa. `CustomerSpeakerId`
1. [DeleteSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html): remova completamente todos os registros de caller/speaker a de um domínio de ID de voz. Todas as impressões de voz e o status de inscrição são excluídos imediatamente e as gravações de áudio associadas são removidas em 24 horas.
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html): liste todos os alto-falantes cujas entradas estão presentes em um domínio de ID de voz. Essa API retorna o `CustomerSpeakerId` e o `GeneratedSpeakerId` para um locutor. Ela retorna uma saída paginada com o tamanho da página determinado na solicitação da API.
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html): exclua um chamador de um domínio do Voice ID. Essa API não exige que o locutor esteja presente no Voice ID. Um locutor inexistente pode ser excluído usando essa API, e o Voice ID mantém o status de cancelamento e rejeita futuras solicitações de inscrição para esse locutor. Essa API também remove as impressões de voz e todas as gravações de áudio armazenadas para esse chamador.
## Gerenciamento de listas de observação APIs
1. [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html): Crie uma lista de observação da qual os fraudadores possam fazer parte.
1. [DeleteWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteWatchlist.html): remova uma lista personalizada de fraudadores do domínio do Voice ID. Para excluir uma lista de observação, ela deve estar vazia. Ou seja, não deve ter nenhum fraudador associado a ela. Você pode usar o [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html)ou [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) APIs para remover todos os fraudadores de uma lista de observação.
Você não pode excluir a lista de observação padrão de um domínio do Voice ID.
1. [DescribeWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeWatchlist.html): determine se é uma lista de observação padrão para fraudadores ou uma lista de observação personalizada que você criou e obtenha os detalhes da lista de observação.
1. [ListWatchlists](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListWatchlists.html): liste todas as listas de observação no domínio do Voice ID.
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html): atualize o nome e a descrição de uma lista personalizada de fraudadores. Não é possível modificar os detalhes da lista de observação padrão porque ela é gerenciada pelo Voice ID.
## Gestão de fraudadores APIs
1. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html): associe um fraudador a uma lista de observação no mesmo domínio. Você pode associar um fraudador a várias listas de observação em um domínio.
1. [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html): exclua um fraudador de um domínio do Voice ID. A exclusão do fraudador remove o fraudador de todas as listas de observação das quais ele faz parte. Essa API também exclui todas as impressões de voz e gravações de áudio associadas em 24 horas.
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html): descreva o status de um fraudador no domínio do Voice ID.
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html): Desassocie um fraudador da lista de observação especificada. Observe que um fraudador sempre precisa estar associado a pelo menos uma lista de observação de fraudadores; uma exceção será lançada se você tentar dissociar um fraudador de sua única lista de observação.
Para remover completamente o fraudador, use `DeleteFraudster`.
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html): liste todos os fraudadores em um domínio ou em uma lista de observação específica. Essa API também retorna as listas de observação das quais o fraudador faz parte. Ela retorna uma saída paginada com o tamanho da página determinado na solicitação da API.
# Inscrição em lote no Amazon Connect Voice ID usando dados de áudio de chamadas anteriores
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para acessar mais informações, acesse [Fim do suporte do Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Você pode começar a usar a biometria inscrevendo em lote clientes que já consentiram com a biometria. [Usando gravações de áudio armazenadas em seu bucket do S3 e um arquivo de entrada JSON que fornece o identificador do alto-falante e um link para as gravações de áudio, você pode invocar o lote de ID de voz.](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartSpeakerEnrollmentJob.html) APIs
Para inscrever clientes de forma programática, transmita os seguintes dados para a API:
1. O ID do domínio para especificar o domínio ao qual associar as gravações.
1. Local do arquivo de saída.
1. Um arquivo de entrada contendo uma lista de locutores. Consulte [Esquema de arquivos de entrada e saída para o trabalho de inscrição de palestrante no Amazon Connect Voice ID](speaker-enrollment-job-schema.md).
Para cada locutor, o arquivo deve incluir:
+ Um link para uma gravação de áudio de chamada em um arquivo.wav com taxa de KHz amostragem de 8 e codificação PCM-16.
+ O `CustomerSpeakerId` correspondente para o cliente.
+ Um canal para o chamador na gravação de áudio. Se o áudio tiver vários canais, você poderá selecionar somente um.
1. Uma chave do KMS para usar ao gravar a saída.
1. Uma função que o Voice ID pode assumir. Ela deve ter acesso ao bucket do S3 no qual os arquivos de áudio são armazenados. Essa função deve ter acesso a qualquer chave do KMS usada para criptografar os arquivos. Ela também deve ser capaz de gravar no local de saída especificado e usar a chave do KMS solicitada para gravar a saída. Especificamente, deve ter as seguintes permissões:
+ `s3:GetObject` no bucket de entrada.
+ `s3:PutObject` no bucket de saída.
+ `kms:Decrypt` na chave do KMS usada para a criptografia padrão do bucket de entrada.
+ `kms:Decrypt` e `kms:GenerateDataKey` na chave do KMS fornecida na entrada que será usada para gravar o arquivo de saída no bucket de saída.
Você deve ter permissões `iam:PassRole` ao fazer a chamada e fornecer `dataAccessRole`. Para habilitar a proteção de substituto confuso para `dataAccessRole`, consulte [Prevenção do problema de substituto confuso entre serviços no Amazon Connect Voice ID](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Opcionalmente, um sinalizador de verificação de fraude, caso você queira ignorar verificações de fraude e falsificação de voz no áudio da inscrição.
1. Opcionalmente, especifique uma lista de observação de fraudadores na qual você deseja realizar verificações de fraude. Se nenhuma lista de observação for especificada, o Voice ID usará a lista de observação padrão de fraudadores para o domínio.
1. Opcionalmente, o limite de fraude, caso você queira aumentar ou diminuir o risco.
1. Opcionalmente, um sinalizador para reinscrever os clientes inscritos. Isso é útil se você quiser atualizar a gravação de áudio, pois o padrão é ignorar os clientes inscritos anteriormente.
A inscrição em lote retorna `CustomerSpeakerId`, `GeneratedSpeakerId` e o status associado a cada entrada. Ela armazena esses dados em um arquivo JSON no caminho de saída especificado na API.
**nota**
Há cobranças para a inscrição de locutores. Para obter mais informações, consulte [Amazon Connect Voice ID Pricing](https://aws.amazon.com/connect/pricing/).
# Esquema de arquivos de entrada e saída para o trabalho de inscrição de palestrante no Amazon Connect Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para acessar mais informações, acesse [Fim do suporte do Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Esquema de arquivos de entrada
Veja abaixo o esquema do arquivo de manifesto de entrada para o trabalho de inscrição de locutor:
```
{
"Version": "string",
"SpeakerEnrollmentRequests": [
{
"RequestId": "string",
"SpeakerId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**nota**
Todos os campos no esquema são **obrigatórios**.
Veja a seguir uma descrição de cada atributo do esquema de entrada.
+ `Version`: a versão do documento do esquema de entrada. No momento, deve ser `1.0`.
+ `SpeakerEnrollmentRequests`: lista de solicitações de inscrição de locutores a serem atendidas como parte do trabalho.
+ `RequestId`: um identificador para essa solicitação de inscrição de locutor. Ele deve ser exclusiva dentro do arquivo de entrada. É usado para mapear e identificar entradas no arquivo de saída.
+ `SpeakerId`: o identificador fornecido pelo cliente para o locutor que precisa ser inscrito. Você deve passar o `CustomerSpeakerId` nesse campo. Atualmente, o `GeneratedSpeakerId` não é compatível.
+ `AudioSpecifications`: a lista de arquivos de áudio que o Voice ID pode usar para inscrever esse locutor. O Voice ID usa esses arquivos de áudio juntos para coletar a quantidade necessária de fala para a inscrição. Atualmente, o número máximo de arquivos de áudio permitidos para uma solicitação de registro é **dez**. Cada arquivo pode ser um arquivo.wav de até 20 MB, contendo áudio com taxa de KHz amostragem 8 e codificação PCM-16.
+ `S3URI`: a localização no Amazon S3 do arquivo de áudio no formato.wav que precisa ser usado para inscrever o locutor.
+ `ChannelId`: o canal de áudio a ser usado para inscrever o locutor em um arquivo de áudio multicanal. O Voice ID comporta arquivos de áudio com até dois canais; portanto, esse valor é restrito a **0** ou **1**.
## Esquema de arquivos de saída
Veja abaixo o esquema do arquivo de saída para o trabalho de inscrição de locutor:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulEnrollments": [
{
"RequestId": "string",
"GeneratedSpeakerId": "string",
"CustomerSpeakerId": "string",
"EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
}
]
}
```
Veja a seguir uma descrição de cada atributo do esquema de entrada.
+ `Version`: a versão do documento do esquema de saída. No momento, deve ser `1.0`.
+ `Errors`: a lista de erros nas solicitações de inscrição de locutores que apresentaram falha em algum momento durante a inscrição.
+
+ `RequestId`: o identificador da solicitação associado a essa solicitação. É o mesmo `RequestId` especificado no arquivo de entrada para essa solicitação.
+ `ErrorCode`: o código de erro HTTP que representa o tipo de erro. Alguns exemplos de cenários de erro são descritos abaixo.
**nota**
Esta não é uma lista completa.
+ 400 (exceção de solicitação inválida):
+ O arquivo JSON de entrada está malformado e não pode ser analisado.
+ Os arquivos de áudio fornecidos não têm voz suficiente para a inscrição.
+ As verificações de fraude falharam para o locutor em questão.
+ 402 (ServiceQuotaLimitExceededException):
+ Limite de locutores excedido.
+ 409 (exceção de conflito):
+ Ação conflitante: você não pode solicitar a inscrição de um locutor que optou por não participar.
+ 500 (erro interno):
+ Erro interno do servidor (erro inesperado do lado do serviço).
+ `ErrorMessage`: uma mensagem descrevendo a causa da falha na inscrição.
+ `SuccessfulEnrollments`: a lista de solicitações de inscrição que foram bem-sucedidas.
+ `RequestId`: o identificador da solicitação associado a essa solicitação. É o mesmo `RequestId` especificado no arquivo de entrada para essa solicitação.
+ `CustomerSpeakerId`: o identificador fornecido pelo cliente para o locutor que foi inscrito.
+ `GeneratedSpeakerId`: o identificador gerado pelo serviço para o locutor que foi inscrito.
+ `EnrollmentStatus`: o status da inscrição bem-sucedida de locutores.
+ `DUPLICATE_SKIPPED`: o locutor já está inscrito e a inscrição foi ignorada.
+ `NEW_ENROLLMENT`: o locutor foi recém-inscrito no sistema.
+ `ENROLLMENT_OVERWRITE`: o locutor já está inscrito, mas foi reinscrito/sobrescrito usando o novo áudio.
# Criar e editar uma lista de observação de fraudadores no Amazon Connect Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para obter mais informações, acesse [Fim do suporte ao Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Use o seguinte APIs para criar uma lista de observação de fraudadores e registrar fraudadores:
1. Use a [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html)API para criar novas listas de observação de fraudadores.
1. Use a [StartFraudsterRegistrationJob](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartFraudsterRegistrationJob.html)API para registro em lote. Você pode registrar novos fraudadores na nova lista de observação ou registrá-los na lista de observação padrão associada ao domínio do Voice ID.
Ao registrar um novo fraudador, o Voice ID compara a impressão de voz com todos os fraudadores registrados em seu domínio do Voice ID para determinar se é uma duplicata de um fraudador existente.
Para adicionar fraudadores a uma lista de observação de fraudadores especificada, transmita os seguintes dados para a API:
1. O ID do domínio para especificar o domínio ao qual associar as gravações.
1. Um arquivo de entrada contendo uma lista de locutores. Consulte [Esquema de arquivos de entrada e saída para o trabalho de registro de fraudadores no Amazon Connect Voice ID](fraudster-registration-schema.md).
1. Local do arquivo de saída.
1. Uma chave do KMS para usar ao gravar a saída.
1. Uma função que o Voice ID pode assumir. Ela deve ter acesso ao bucket do S3 no qual os arquivos de áudio são armazenados. Essa função deve ter acesso a qualquer chave do KMS usada para criptografar os arquivos. Ela também deve ser capaz de gravar no local de saída especificado e usar a chave do KMS solicitada para gravar a saída. Especificamente, deve ter as seguintes permissões:
+ `s3:GetObject` no bucket de entrada.
+ `s3:PutObject` no bucket de saída.
+ `kms:Decrypt` na chave do KMS usada para a criptografia padrão do bucket de entrada.
+ `kms:Decrypt` e `kms:GenerateDataKey` na chave do KMS fornecida na entrada que será usada para gravar o arquivo de saída no bucket de saída.
Você deve ter permissões `iam:PassRole` ao fazer a chamada e fornecer `dataAccessRole`. Para habilitar a proteção de substituto confuso para `dataAccessRole`, consulte [Prevenção do problema de substituto confuso entre serviços no Amazon Connect Voice ID](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Um watchlistId para registrar o fraudador. Se nenhum watchlistId for especificado, os fraudadores serão registrados na lista de observação padrão desse domínio do Voice ID.
1. O limite para estabelecer o status duplicado dos fraudadores.
1. Um sinalizador para ignorar duplicatas de fraudadores.
O Voice ID atualiza a lista de fraudadores com adições bem-sucedidas e retorna a entrada `GeneratedFraudsterID` associada ao mesmo local do S3. Se forem identificadas duplicatas, o Voice ID retornará um status “duplicado” para a entrada e fornecerá o `GeneratedFraudsterId` de correspondência mais próxima. Depois que um fraudador for registrado com sucesso, você poderá associar esse fraudador identificado pelo a `GeneratedFraudsterID` uma nova lista de observação usando a API. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html)
O Voice ID não consegue realizar a detecção de fraudadores em uma lista de observação antes que a lista de fraudadores seja criada.
Para obter cotas para a lista de fraudadores, consulte [Amazon Connect cotas de serviço](amazon-connect-service-limits.md).
**nota**
Cobranças são aplicadas para adição à lista de fraudadores. Para obter mais informações, consulte [Amazon Connect Voice ID Pricing](https://aws.amazon.com/connect/voice-id/).
# Esquema de arquivos de entrada e saída para o trabalho de registro de fraudadores no Amazon Connect Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para acessar mais informações, acesse [Fim do suporte do Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Esquema de arquivos de entrada
Veja abaixo o esquema do arquivo do manifesto de entrada para trabalhos de registro de fraudadores:
```
{
"Version": "string",
"FraudsterRegistrationRequests": [
{
"RequestId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**nota**
Todos os campos no esquema são **obrigatórios**.
Veja a seguir uma descrição de cada atributo do esquema de entrada.
+ `Version`: a versão do documento do esquema. No momento, deve ser `1.0`.
+ `FraudsterRegistrationRequests`: lista de solicitações de registro de fraudadores a serem atendidas como parte do trabalho.
+ `RequestId`: um identificador para essa solicitação de registro de fraudador. Ele deve ser exclusiva dentro do arquivo de entrada. É usado para mapear e identificar entradas no arquivo de saída.
+ `AudioSpecifications`: a lista de arquivos de áudio que o Voice ID pode usar para registrar esse fraudador. O Voice ID usa esses arquivos de áudio juntos para coletar a quantidade necessária de fala para a inscrição. Atualmente, o número máximo de arquivos de áudio permitidos para uma solicitação de registro é **dez**. Cada arquivo pode ser um arquivo.wav de até 20 MB, contendo áudio com taxa de KHz amostragem 8 e codificação PCM-16.
+ `S3URI`: a localização no Amazon S3 do arquivo de áudio no formato.wav que precisa ser usado para registrar o fraudador.
+ `ChannelId`: o canal de áudio a ser usado para registrar o fraudador em um arquivo de áudio multicanal. O Voice ID comporta arquivos de áudio com até dois canais; portanto, esse valor é restrito a **0** ou **1**.
## Esquema de arquivos de saída
Veja abaixo o esquema do arquivo do manifesto de saída para trabalhos de registro de fraudadores:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulRegistrations": [
{
"RequestId": "string",
"GeneratedFraudsterId": "string",
"RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
"FraudsterSimilarityScore": number
}
]
}
```
Veja a seguir uma descrição de cada atributo do esquema de entrada.
+ `Version`: a versão do documento do esquema de saída. No momento, deve ser `1.0`.
+ `Errors`: a lista de erros nas solicitações de registro de fraudador que foram malsucedidas em algum momento durante o registro.
+
+ `RequestId`: o identificador da solicitação associado a essa solicitação. É o mesmo `RequestId` especificado no arquivo de entrada para essa solicitação.
+ `ErrorCode`: o código de erro HTTP que representa o tipo de erro. Alguns exemplos de cenários de erro são descritos abaixo.
**nota**
Esta não é uma lista completa.
+ 400 (exceção de solicitação inválida):
+ O arquivo JSON de entrada está malformado e não pode ser analisado.
+ Os arquivos de áudio fornecidos não têm voz suficiente para registro.
+ 402 (ServiceQuotaLimitExceededException):
+ Limite de fraudadores excedido.
+ 500 (erro interno):
+ Erro interno do servidor (erro inesperado do lado do serviço).
+ `ErrorMessage`: uma mensagem descrevendo a causa da falha no registro de fraudador.
+ `SuccessfulRegistrations`: a lista de solicitações de registro que foram bem-sucedidas.
+ `RequestId`: o identificador da solicitação associado a essa solicitação. É o mesmo `RequestId` especificado no arquivo de entrada para essa solicitação.
+ `RegistrationStatus`: o status do registro bem-sucedido de fraudador.
+ `DUPLICATE_SKIPPED`: o fraudador foi identificado como duplicado e o registro foi ignorado.
+ `NEW_FRAUDSTER`: o fraudador foi recém-inscrito no sistema.
+ `GeneratedFraudsterId`: o identificador gerado pelo serviço para o fraudador que foi registrado. Caso `RegistrationStatus` seja `DUPLICATE_SKIPPED`, esse é o identificador do fraudador que já está no domínio que mais se aproxima do fraudador em questão.
+ `FraudsterSimilarityScore`: um campo opcional que é preenchido quando o registro do fraudador é ignorado por ser uma duplicata. Isso representa a similaridade do fraudador em questão com o fraudador mais próximo que já existe no domínio.
# Amazon Connect Streams integrará APIs o Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para obter mais informações, acesse [Fim do suporte ao Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Use os seguintes [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) APIs para integrar o Voice ID aos seus aplicativos web de agentes existentes.
+ `enrollSpeakerInVoiceId`: inscreva um cliente no Voice ID depois de obter seu consentimento para se inscrever.
+ `evaluateSpeakerWithVoiceId`: verifique o status da autenticação do Voice ID do cliente e detecte fraudadores.
+ `optOutVoiceIdSpeaker`: exclua um cliente do Voice ID.
+ `getVoiceIdSpeakerStatus`: descreva o status de inscrição de um cliente.
+ `getVoiceIdSpeakerId`: adquira o `SpeakerID` para um cliente.
+ `updateVoiceIdSpeakerId`: atualize o `SpeakerID` para um cliente.
Você também pode usar o widget Voice ID no Painel de Controle de Contatos (CCP) se não quiser criar uma interface de atendente personalizada. Para obter mais informações sobre o Voice ID no CCP, consulte [Inscrever os chamadores no Voice ID no Painel de controle do contato (CCP)](use-voiceid.md).
# Esquema de eventos do Amazon Connect Voice ID
**nota**
Aviso de fim do suporte: em 20 de maio de 2026, o suporte para o Amazon Connect Voice ID AWS será encerrado. 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 do Amazon Connect administrador ou no Painel de Controle de Contatos ou acessar os recursos do Voice ID. Para acessar mais informações, acesse [Fim do suporte do Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
O Voice ID gera eventos para cada transação: inscrição, autenticação ou detecção de fraudadores em uma lista de observação. Os eventos são enviados para o barramento de eventos EventBridge padrão.
Você pode criar um pipeline de análise para os resultados da autenticação do Voice ID e a detecção de fraudadores em uma lista de observação usando EventBridge para monitorar eventos do Voice ID. Usando o esquema disponível neste tópico, você pode configurar EventBridge regras para ouvir e filtrar eventos de Voice ID que sejam relevantes e, em seguida, processá-los por meio do Amazon Data Firehose para armazená-los em um data warehouse de sua escolha.
Por exemplo, você pode querer um rastreamento quase em tempo real da análise do Voice ID. Para fazer isso, você pode pegar todos os eventos `Evaluate-Session` e obter `authenticationResult` e `fraudDetectionResult`.
Os eventos são emitidos com base no [melhor esforço](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html).
## Campos comuns no evento
+ `version`: a versão dos dados do evento.
+ `id`- Um identificador exclusivo do evento gerado por EventBridge
+ `detail-type`: um identificador dos detalhes do evento.
+ `source`: a origem do evento. Isso é sempre `aws.voiceid`.
+ `account`- ID AWS da conta.
+ `timestamp`: a data e a hora em que o evento foi publicado em UTC.
+ `region`- A AWS região em que a chamada da API foi feita.
+ `resources`: os recursos usados pela chamada da API.
+ `detail`: os detalhes sobre o evento.
+ `detail.sourceId`: um ID exclusivo gerado pelo Voice ID que você pode usar para desduplicação.
+ `detail.action`: análogo à API que está sendo invocada.
+ `detail.status`: especifica o status da ação: sucesso ou falha.
+ `detail.errorInfo`: é preenchido quando a ação especificada apresenta um erro no Voice ID.
A seguir estão os esquemas dos eventos emitidos.
## Ação Iniciar sessão
Emite eventos no início do fluxo (após a configuração), no final do fluxo e em caso de falhas.
```
{...commonfields
"detail-type": "VoiceId Start Session Action",
"detail": {
"sourceId": String,
"action": "START_SESSION",
"status": String,
"domainId": String,
"session": {
"sessionId": String,
"sessionName": String,
"authenticationConfiguration": {
"acceptanceThreshold":Integer
},
"fraudDetectionConfiguration": {
"riskThreshold":Integer,
"watchlistId": String
},
"streamingConfiguration": {
"authenticationMinimumSpeechInSeconds": Integer
},
"enrollmentAudioProgress": {
"audioAggregationStatus": String,
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp"
},
"authenticationAudioProgress": {
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp"
},
"fraudDetectionAudioProgress": {
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp"
},
"generatedSpeakerId": String
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## Ação Atualizar sessão
Emite eventos quando a atualização interna da sessão é bem-sucedida ou malsucedida.
```
{...commonfields
"detail-type": "VoiceId Update Session Action",
"detail": {
"sourceId": String,
"action": "UPDATE_SESSION",
"status": String,
"domainId": String,
"session": {
"sessionId": String,
"sessionName": String,
"authenticationConfiguration": {
"acceptanceThreshold": Integer
},
"fraudDetectionConfiguration": {
"riskThreshold": Integer,
"watchlistId": String
},
"streamingConfiguration": {
"authenticationMinimumSpeechInSeconds": Integer
},
"generatedSpeakerId": String
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## Ação Avaliar sessão
Emite eventos quando a atualização da sessão é bem-sucedida ou malsucedida. Os motivos podem ser KNOWN\$1FRAUDSTER ou VOICE\$1SPOOFING.
```
{...commonfields
"detail-type": "VoiceId Evaluate Session Action",
"detail": {
"sourceId": String,
"action": "EVALUATE_SESSION",
"status": String,
"domainId": String,
"session": {
"sessionId": String,
"sessionName": String,
"generatedSpeakerId": String,
"streamingStatus": String,
"authenticationResult": {
"authenticationResultId": String,
"decision": String,
"score": Integer,
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp",
"configuration": {
"acceptanceThreshold": Integer
}
},
"fraudDetectionResult": {
"fraudDetectionResultId": String,
"decision": String,
"reasons": [String],
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp",
"configuration": {
"riskThreshold": Integer
},
"riskDetails": {
"knownFraudsterRisk": {
"generatedFraudsterId": String,
"riskScore": Integer,
"watchlistId": String
},
"voiceSpoofingRisk": {
"riskScore": Integer
}
}
}
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## Ação do locutor
Emite eventos sobre sucesso ou insucesso ao cancelar, excluir ou inscrever um palestrante.
```
{...commonfields
"detail-type": "VoiceId Speaker Action",
"detail": {
"sourceId": String,
"domainID": String,
"action": String,
"status": String,
"generatedSpeakerId": String,
"data": {
"enrollmentSource": String,
"enrollmentSourceId": String,
"enrollmentStatus": String
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## Ação do fraudador
Emite eventos quando um fraudador é registrado ou excluído com sucesso.
Os eventos não são enviados quando um fraudador é associado ou desassociado de uma lista de observação.
```
{...commonfields
"detail-type": "VoiceId Fraudster Action",
"detail": {
"sourceId": String,
"domainID": String,
"action": String,
"status": String,
"generatedFraudsterId": String,
"watchlistIds": [String],
"data": {
"registrationSource": String,
"registrationSourceId": String,
"registrationStatus": String
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## EnrollBySession
Emite esse evento quando uma solicitação de inscrição é enviada. Um evento `Speaker` é emitido quando a inscrição real é bem-sucedida ou malsucedida.
```
{...commonfields
"detail-type": "VoiceId Session Speaker Enrollment Action",
"detail": {
"sourceId": String,
"domainId": String,
"action": "SESSION_ENROLLMENT_REQUEST",
"status": String,
"sessionId": String,
"sessionName": String,
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## StartSpeakerEnrollmentJob
Emite esse evento quando uma solicitação de inscrição em lote é enviada, bem-sucedida ou malsucedida. Um evento `Speaker` é emitido para cada um dos locutores para indicar se a inscrição correspondente foi bem-sucedida ou não.
```
{...commonfields
"detail-type": "VoiceID Batch Speaker Enrollment Action",
"detail": {
"sourceId": String,
"domainId": String,
"action": "BATCH_ENROLLMENT_REQUEST",
"status": String,
"batchJobId": String,
"data": {
"dataAccessRoleArn": String,
"enrollmentConfig": {
"existingEnrollmentAction": String,
"fraudDetectionConfig": {
"fraudDetectionAction": String,
"riskThreshold": Integer,
"watchlistIds": [String],
}
},
"inputDataConfig": {
"s3Uri": String
},
"outputDataConfig": {
"s3Uri": String,
"kmsKeyId": String
}
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## StartFraudsterRegistrationJob
Emite esse evento quando uma solicitação de registro em lote é enviada, bem-sucedida ou malsucedida. Um evento `Fraudster` é emitido para cada um dos fraudadores para indicar se o registro correspondente foi bem-sucedido ou malsucedido.
```
{...commonfields
"detail-type": "VoiceId Batch Fraudster Registration Action",
"detail": {
"sourceId": String,
"domainId": String,
"action": "BATCH_REGISTRATION_REQUEST",
"status": String,
"batchJobId": String,
"data": {
"dataAccessRoleArn": String,
"registrationConfig": {
"duplicateRegistrationAction": String,
"fraudsterSimilarityThreshold": Integer,
"watchlistIds": [String],
}
"inputDataConfig": {
"s3Uri": String
},
"outputDataConfig": {
"s3Uri": String,
"kmsKeyId": String
}
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```