登録済み電話番号を Amazon Connect のトラフィック分散グループに割り当てる
-
新しいトラフィック分散グループを作成し、ステータスは
ACTIVEとなっています。DescribeTrafficDistributionGroup API を使用してステータスを確認することをお勧めします。 -
インスタンスまたは他のトラフィック分散グループに電話番号を既に登録しました。
これで、UpdatePhoneNumber API を使用して、登録済み電話番号を新しいトラフィック分散グループに割り当てることができます。TargetArn パラメータにトラフィック分散グループの ARN を指定します。
注記
Description (説明) フィールドを更新するには、Amazon Connect コンソールを使用する必要があります。
ワークフローの例
以下は、登録済み電話番号をトラフィック分散グループに割り当てるワークフローの例です。
-
UpdatePhoneNumber API を呼び出して、電話番号を新しい
TargetArnに割り当てます。TargetArnは、別の Amazon Connect インスタンス用でも、電話番号が最初に登録されたのと同じリージョンに作成されたトラフィック分散グループのものでもかまいません。 -
フローを電話番号に関連付けるには、以下のステップを実行します。トラフィック分散グループが動作する両方のリージョンで実行します。
これらのステップにより、テレフォニートラフィックがフローに正しくルーティングされ、トラフィック分散設定をサポートできるようになります。
-
トラフィック分散グループが作成されたリージョンの既存の Amazon Connect インスタンスで、以下のステップを実行します。
-
ListContactFlows API を呼び出します。レプリケーションされたインスタンスに対応する
InstanceIdを指定します。 -
フロー ARN のリストが返されます。これらのフロー ARN を使用して、フローを電話番号に関連付けます。AssociatePhoneNumberContactFlow API を呼び出します。
-
-
もう一方のリージョンのレプリケーションされた Amazon Connect インスタンスで、以下のステップを実行します。
-
ListContactFlows API を呼び出します。レプリケーションされたインスタンスに対応する
InstanceIdを指定します。 -
フロー ARN のリストが返されます。これらのフロー ARN を使用して、フローを電話番号に関連付けます。AssociatePhoneNumberContactFlow API を呼び出します。
-
-
AssociatePhoneNumberContactFlow 呼び出しが失敗する理由
番号がトラフィック分散グループに登録され、トラフィック分散グループが作成されている AWS リージョン のインスタンスを使用して AssociatePhoneNumberContactFlow を呼び出す場合、PhoneNumberId URI リクエストパラメータに完全な電話番号の ARN または UUID 値を使用できます。
ただし、その番号がトラフィック分散グループに登録されており、そのトラフィック分散グループに関連付けられたレプリカ AWS リージョン のインスタンスを使用してこの API を呼び出す場合は、完全な電話番号の ARN を指定する必要があります。このシナリオで UUID を指定すると、ResourceNotFoundException が発生します。
UpdatePhoneNumber の呼び出しが失敗する理由
UpdatePhoneNumber API の呼び出しは、以下の場合、ResourceNotFoundException で失敗します。
-
指定したトラフィック分散グループが存在しない、トラフィック分散グループのステータスが
ACTIVEではない、またはトラフィック分散グループの所有権を持っていない。
次の場合、UpdatePhoneNumber は InvalidParameterException エラーで失敗します。
-
呼び出しているエンドポイントが、トラフィック分散グループが作成されたリージョンとは異なります。
電話番号ステータスの定義
電話番号のステータスの説明は次のとおりです。
-
CLAIMEDは、前回の ClaimPhoneNumber または UpdatePhoneNumber 操作が成功したことを意味します。 -
IN_PROGRESSは、ClaimPhoneNumber、UpdatePhoneNumber の操作がまだ進行中であり、完了していないことを意味します。後で DescribePhoneNumber を呼び出して、前の操作が完了したかどうかを確認できます。 -
FAILEDは、前回の ClaimPhoneNumber または UpdatePhoneNumber 操作が失敗したことを示します。失敗の原因を示すメッセージが含まれます。失敗の原因としてよくあるのは、電話番号を登録または更新しようとしているTargetArnの値が、登録件数の上限に達したことです。
