APIs de gerenciamento de locutores, lista de observação e fraudadores do Amazon Connect Voice ID - Amazon Connect
APIs de gerenciamento de locutoresAPIs de gerenciamento de listas de observaçãoAPIs de gerenciamento de fraudadores

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

APIs de gerenciamento de locutores, lista de observação e fraudadores 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 inclui APIs para gerenciar locutores inscritos em um domínio de Voice ID e fraudadores registrados no domínio. Todas as APIs de locutor, exceto ListSpeakers, aceitam o CustomerSpeakerId ou GeneratedSpeakerId.

APIs de gerenciamento de locutores

  1. DescribeSpeaker: descreva o status de um locutor em um domínio (ENROLLED, OPTED_OUT, EXPIRED) e mapeie GeneratedSpeakerId para CustomerSpeakerId e vice-versa.

  2. DeleteSpeaker: remova completamente todos os registros de um chamador/locutor 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.

  3. ListSpeakers: liste todos os locutores 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.

  4. OptOutSpeaker: cancele 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.

APIs de gerenciamento de listas de observação

  1. CreateWatchlist: crie uma lista de observação da qual os fraudadores possam fazer parte.

  2. DeleteWatchlist: 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 as APIs DeleteFraudster ou DisassociateFraudster 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.

  3. DescribeWatchlist: 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.

  4. ListWatchLists: relacione todas as listas de observação no domínio do Voice ID.

  5. UpdateWatchlist: 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.

APIs de gerenciamento de fraudadores

  1. AssociateFraudster: 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.

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

  3. DescribeFraudster: descreva o status de um fraudador no domínio do Voice ID.

  4. DisassociateFraudster: 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.

  5. ListFraudsters: 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.