View a markdown version of this page

APIs da Voice ID e Connect Customer Integration Association - Amazon Connect Customer

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 da Voice ID e Connect Customer Integration Association

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 Connect Customer 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.

Você pode usar as seguintes APIs para gerenciar associações com instâncias do Connect Customer. Você também pode realizar essas operações no AWS console.

  1. CreateIntegrationAssociation: para habilitar o Voice ID em uma instância do Connect Customer, você precisará associar um domínio do Voice ID a uma instância do Connect Customer usando uma CreateIntegrationAssociation solicitação. Você só pode associar um domínio do Voice ID a uma instância do Connect Customer. 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ê ativa o Voice ID para uma instância do Connect Customer (usando o console do Connect Customer ou a CreateIntegrationAssociationAPI), o Connect Customer 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 Connect Customer adiciona permissões de ID de voz à função vinculada ao serviço do Connect Customer.

  2. DeleteIntegrationAssociation: para excluir uma associação existente entre uma instância do Connect Customer e um domínio do Voice ID, você precisará chamar as DeleteIntegrationAssociation APIs junto com o InstanceID do Connect Customer e o retornado por. IntegrationAssociationID CreateIntegrationAssociation Essa é uma etapa obrigatória se você quiser associar um domínio de ID de voz diferente a essa instância do Connect Customer. 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 em sua instância do Connect Customer.

  3. ListIntegrationAssociations: para listar todas as associações entre a instância Connect Customer e os domínios do Voice ID da sua conta nessa região, você pode invocar ListIntegrationAssociations a API.