Voice ID und Amazon Connect Integration Association APIs

Anmerkung

Hinweis zum Ende des Supports: Am 20. Mai 2026 AWS wird der Support für Amazon Connect Voice ID eingestellt. Nach dem 20. Mai 2026 können Sie nicht mehr auf Voice ID in der Amazon Connect Connect-Konsole, auf Voice ID-Funktionen auf der Amazon Connect Admin-Website oder im Contact Control Panel zugreifen oder auf Voice ID-Ressourcen zugreifen. Weitere Informationen finden Sie unter Ende des Supports für Amazon Connect Voice ID.

Sie können Folgendes verwenden APIs , um Verknüpfungen mit Amazon Connect Connect-Instances zu verwalten. Sie können diese Operationen auch auf der AWS Konsole ausführen.

1. CreateIntegrationAssociation: Um Voice ID auf einer Amazon Connect Connect-Instance zu aktivieren, müssen Sie mithilfe einer CreateIntegrationAssociation Anfrage eine Voice ID-Domain mit einer Amazon Connect Connect-Instance verknüpfen. Sie können einer Amazon Connect-Instance nur eine Sprach-ID-Domain zuordnen. Wenn die Instance bereits mit einer Domain verknüpft ist, gibt die API den folgenden Fehler zurück:

   DuplicateResourceException (409) – Die Anfrage versucht, eine doppelte Ressource zu erstellen.

   Anmerkung

   Wenn Sie Voice ID für eine Amazon Connect-Instance aktivieren (entweder mithilfe der Amazon Connect Connect-Konsole oder der CreateIntegrationAssociationAPI), erstellt Amazon Connect eine verwaltete EventBridge Amazon-Regel in Ihrem Konto. Diese Regel wird verwendet, um Sprach-ID-Ereignisse zu erfassen, um Kontaktdatensätze im Zusammenhang mit Sprach-ID zu erstellen. Darüber hinaus fügt Amazon Connect der serviceverknüpften Rolle für Amazon Connect Voice ID-Berechtigungen hinzu.

2. DeleteIntegrationAssociation: Um eine bestehende Verknüpfung zwischen einer Amazon Connect Connect-Instance und einer Voice ID-Domain zu löschen, müssen Sie die DeleteIntegrationAssociation APIs zusammen mit der Amazon Connect Connect-InstanceID und der IntegrationAssociationID zurückgesendeten von aufrufen. CreateIntegrationAssociation Dieser Schritt ist erforderlich, wenn Sie dieser Amazon Connect-Instance eine andere Sprach-ID-Domain zuordnen möchten. Wir empfehlen nicht, Verknüpfungen in einem Produktionssetup zu löschen, da dies zu unvorhersehbarem Verhalten der Sprach-ID in Ihrer Amazon Connect-Instance führen kann.

3. ListIntegrationAssociations: Um alle Verknüpfungen zwischen Amazon Connect Connect-Instance und Voice ID-Domains für Ihr Konto in dieser Region aufzulisten, können Sie die ListIntegrationAssociations API aufrufen.