Amazon Connect を使用してトラフィックディストリビューショングループに電話番号をリクエストする - Amazon Connect
ワークフローの例通話が ClaimPhoneNumber失敗する理由電話番号ステータスの定義

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

Amazon Connect を使用してトラフィックディストリビューショングループに電話番号をリクエストする

注記

新しいユーザーですか？ Amazon Connect Global Resiliency Workshop を参照してください。このオンラインコースでは、 APIsを通じて新しい を使用して電話番号とエージェントのフェイルオーバーをオンボーディングおよびテストするプロセスについて説明しますAWSCLI。

Global Resiliency は、米国東部 (バージニア北部）、米国西部 (オレゴン）、欧州 (フランクフルト）、欧州 (ロンドン) の各 AWS リージョンで作成された Amazon Connect インスタンスでのみ使用できます。

米国東部 (バージニア北部) リージョンでレプリカを作成できるのは、ソースが米国西部 (オレゴン) の場合のみで、その逆も同様です。同様に、欧州 (フランクフルト) リージョンでレプリカを作成できるのは、ソースが欧州 (ロンドン) の場合のみで、その逆も同様です。

この機能を利用するには、Amazon Connect ソリューションアーキテクトまたはテクニカルアカウントマネージャーにお問い合わせください。

トラフィックディストリビューショングループが正常に作成された後 (Status は ACTIVE）、 SearchAvailablePhoneNumbersを使用して使用可能な電話番号を検索しClaimPhoneNumber、それらをリクエストできます。

トラフィック分散グループに電話番号をリクエストする前に、 DescribeTrafficDistributionGroup API を使用してトラフィック分散グループのステータスが であることを確認することをお勧めしますACTIVE。ACTIVE ではないトラフィック分散グループに電話番号を割り当てると、ResourceNotFoundException になります。

を呼び出すときに TargetArnパラメータARNにトラフィック分散グループを指定することで、トラフィック分散グループに電話番号をリクエストできますClaimPhoneNumberAPI。を使用して、以前にインスタンスに請求された電話番号をトラフィック分散グループUpdatePhoneNumberAPIに割り当てることもできます。

注記

Description (説明) フィールドを更新するには、Amazon Connect コンソールを使用する必要があります。

ワークフローの例

以下は、複数の AWS リージョンに電話番号を登録して使用するワークフローの例です。

  1. インスタンスのレプリカを作成します:

    1. を呼び出しますReplicateInstanceAPI。

  2. これらのインスタンスをリンクするトラフィック分散グループを作成します:

    1. を呼び出しますCreateTrafficDistributionGroupAPI。

  3. トラフィック分散グループに登録できる電話番号を検索します:

    1. トラフィック分散グループが作成されたリージョンSearchAvailablePhoneNumbersAPIで を呼び出します。TargetArn パラメータARNのトラフィック分散グループを指定します。

  4. トラフィック分散グループが作成されたリージョンで、 ClaimPhoneNumber を呼び出しますAPI。

    1. TargetArn パラメータARNのトラフィック分散グループを指定します。

    2. ステップ 3 のSearchAvailablePhoneNumbersAPI呼び出しによって返された E164 電話番号の値を指定します。

    PhoneNumberId と PhoneNumberArn が返されます。これらの値は、フォローアップ操作に使用できます。

  5. 電話番号のステータスが CLAIMED であることを確認します:

    1. を呼び出しますDescribePhoneNumberAPI。

      （トラフィック分散グループに関連付けられている他のリージョンでも呼び出すDescribePhoneNumber ことができます。 同じ電話番号の詳細が返されます。）

    電話番号は、ステータスが CLAIMED になった後でのみ、フォローアップ操作で使用できます。

    ステータスが取り得る値については、「電話番号ステータスの定義」を参照してください。

  6. トラフィック分散グループに登録する必要があるすべての電話番号について、ステップ 3～5 を繰り返します。

  7. フローを電話番号に関連付けるには、以下のステップを実行します。トラフィック分散グループが動作する両方のリージョンで実行します。

    これらのステップにより、テレフォニートラフィックがフローに正しくルーティングされ、トラフィック分散設定をサポートできるようになります。

    1. トラフィック分散グループが作成されたリージョンの既存の Amazon Connect インスタンスで、以下のステップを実行します。

      1. ListContactFlows を呼び出しますAPI。レプリケーションされたインスタンスに対応する InstanceId を指定します。

      2. フローのリストが返されARNsます。これらのフローARNsを使用してフローを電話番号に関連付けるには、 AssociatePhoneNumberContactFlow を呼び出しますAPI。

    2. 他のリージョンのレプリケートされた Amazon Connect インスタンスで AWS 、次の手順を実行します。

      1. ListContactFlows を呼び出しますAPI。レプリケーションされたインスタンスに対応する InstanceId を指定します。

      2. フローのリストが返されARNsます。これらのフローARNsを使用してフローを電話番号に関連付けるには、 AssociatePhoneNumberContactFlow を呼び出しますAPI。

ClaimPhoneNumber 通話が失敗する理由

次の場合ResourceNotFoundException、 ではClaimPhoneNumberAPI通話が失敗します。

  • 指定したトラフィック分散グループが存在しない、トラフィック分散グループのステータスが ACTIVE ではない、またはトラフィック分散グループの所有権を持っていない。

  • 電話番号を登録に使用できない。場合によっては、 から見つかった電話番号が別の顧客によって請求されているSearchAvailablePhoneNumbers可能性があります。

ClaimPhoneNumber は、次の場合にInvalidParameterExceptionエラーで失敗します。

  • 呼び出しているエンドポイントが、トラフィック分散グループが作成されたリージョンとは異なります。

電話番号ステータスの定義

電話番号のステータスの説明は次のとおりです。

  • CLAIMED は、以前の ClaimPhoneNumberまたは UpdatePhoneNumberオペレーションが成功したことを意味します。

  • IN_PROGRESS とはClaimPhoneNumber、 オペレーションUpdatePhoneNumberがまだ進行中であり、まだ完了していないことを意味します。DescribePhoneNumber 後で を呼び出して、前のオペレーションが完了したかどうかを確認できます。

  • FAILED は、以前の ClaimPhoneNumberまたは UpdatePhoneNumberオペレーションが失敗したことを示します。失敗の原因を示すメッセージが含まれます。

    失敗の原因としてよくあるのは、電話番号を登録または更新しようとしている TargetArn の値が、登録件数の上限に達したことです。

    ClaimPhoneNumber API 通話からFAILEDステータスを受け取った場合は、電話番号を請求するために、その番号が他の顧客が請求できるようにインベントリにリリースされるまでに、電話番号の請求を再試行する日があります。