View a markdown version of this page

Voice ID 和 Connect Customer Integration Association APIs - Amazon Connect 客戶

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Voice ID 和 Connect Customer Integration Association APIs

注意

支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員 Connect Customer 網站或聯絡控制面板上的語音 ID 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 Amazon Connect Voice ID 終止支援。

您可以使用下列 APIs來管理與 Connect Customer 執行個體的關聯。您也可以在 AWS 主控台上執行這些操作。

  1. CreateIntegrationAssociation：若要在 Connect Customer 執行個體上啟用語音 ID，您需要使用 CreateIntegrationAssociation請求將語音 ID 網域與 Connect Customer 執行個體建立關聯。您只能將一個語音 ID 網域與 Connect Customer 執行個體建立關聯。如果執行個體已與網域相關聯，則 API 會傳回下列錯誤：

    DuplicateResourceException (409) - 請求正在嘗試建立重複的資源。

    注意

    當您啟用 Connect Customer 執行個體的語音 ID 時 （使用 Connect Customer 主控台或 CreateIntegrationAssociation API)，Connect Customer 會在您的帳戶中建立受管 Amazon EventBridge 規則。此規則是用來擷取語音 ID 事件，以建立與語音 ID 相關的聯絡記錄。此外，Connect Customer 會將語音 ID 許可新增至 Connect Customer 的服務連結角色。

  2. DeleteIntegrationAssociation：若要刪除 Connect Customer 執行個體與 Voice ID 網域之間的現有關聯，您需要呼叫 DeleteIntegrationAssociation APIs以及 Connect Customer InstanceID 和 IntegrationAssociationID傳回的 CreateIntegrationAssociation。如果您想要將不同的語音 ID 網域與此 Connect Customer 執行個體建立關聯，這是必要的步驟。我們不建議在生產設定中刪除關聯，因為它可能會導致 Connect Customer 執行個體中語音 ID 的不可預測行為。

  3. ListIntegrationAssociations：若要列出 Connect Customer 執行個體與您的帳戶在此區域中的語音 ID 網域之間的所有關聯，您可以叫用 ListIntegrationAssociations API。