View a markdown version of this page

Voice ID と Connect Customer Integration Association APIs - Amazon Connect Customer

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Voice ID と Connect Customer Integration Association APIs

注記

サポート終了通知: 2026 年 5 月 20 日、 AWS は Amazon Connect Voice ID のサポートを終了します。2026 年 5 月 20 日以降、Amazon Connect コンソールの Voice ID にアクセスしたり、管理者ウェブサイトまたは問い合わせコントロールパネルの Voice ID Connect Customer 機能にアクセスしたり、Voice ID リソースにアクセスしたりできなくなります。詳細については、「Amazon Connect Voice ID のサポート終了」を参照してください。

次の APIs を使用して、Connect Customer インスタンスとの関連付けを管理できます。これらのオペレーションは、 AWS コンソールでも実行できます。

  1. CreateIntegrationAssociation: Connect Customer インスタンスで Voice ID を有効にするには、CreateIntegrationAssociationリクエストを使用して Voice ID ドメインを Connect Customer インスタンスに関連付ける必要があります。Connect Customer インスタンスに関連付けることができる Voice ID ドメインは 1 つだけです。インスタンスがすでにドメインに関連付けられている場合、API は次のエラーを返します。

    DuplicateResourceException (409) - Request is trying to created a duplicate resource. (リクエストが重複リソースを作成しようとしています)。

    注記

    Connect Customer インスタンスの Voice ID を有効にすると (Connect Customer コンソールまたは CreateIntegrationAssociation API を使用して）、Connect Customer はアカウントにマネージド Amazon EventBridge ルールを作成します。このルールは、Voice ID に関連するコンタクトレコードを作成するために Voice ID イベントを取り込むために使用されます。さらに、Connect Customer は、Connect Customer のサービスにリンクされたロールに Voice ID アクセス許可を追加します。

  2. DeleteIntegrationAssociation: Connect Customer インスタンスと Voice ID ドメイン間の既存の関連付けを削除するには、Connect Customer InstanceID と によってIntegrationAssociationID返される とともに DeleteIntegrationAssociation APIs を呼び出す必要がありますCreateIntegrationAssociation。これは、別の Voice ID ドメインをこの Connect Customer インスタンスに関連付ける場合に必要なステップです。Connect Customer インスタンスの Voice ID に予期しない動作が発生する可能性があるため、本番稼働用セットアップの関連付けを削除することはお勧めしません。

  3. ListIntegrationAssociations: このリージョンのアカウントの Connect Customer インスタンスと Voice ID ドメイン間のすべての関連付けを一覧表示するには、 ListIntegrationAssociations API を呼び出します。