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, visite o fim do suporte do Amazon Connect Voice ID.

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: 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 CreateIntegrationAssociationAPI), 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 à função vinculada ao serviço do Amazon Connect.

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

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