翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Connect を使用してトラフィック分散グループに電話番号を請求する
**注記**
**初めて使用する場合** [Amazon Connect グローバルレジリエンシーのワークショップ](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)を参照してください。このオンラインコースでは、AWS CLI を通じて新しい API を使用した電話番号とエージェントのフェイルオーバーをオンボーディングおよびテストするプロセスについて説明します。
グローバルレジリエンシーは、米国東部 (バージニア北部）、米国西部 (オレゴン）、アジアパシフィック (大阪）、アジアパシフィック (東京）、欧州 (フランクフルト）、欧州 (ロンドン) の各 AWS リージョンで作成された Amazon Connect インスタンスでのみ使用できます。
米国東部 (バージニア北部) リージョンでレプリカを作成できるのは、ソースが米国西部 (オレゴン) の場合のみで、その逆も同様です。
欧州 (フランクフルト) リージョンでレプリカを作成できるのは、ソースが欧州 (ロンドン) の場合のみで、その逆も同様です。
アジアパシフィック (大阪) でのレプリカ作成は、レプリケート元がアジアパシフィック (東京) の場合にのみ行えます。
この機能を利用するには、Amazon Connect ソリューションアーキテクトまたはテクニカルアカウントマネージャーにお問い合わせください。
トラフィック分散グループが正常に作成されたら (`Status` が `ACTIVE`)、[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) を使用して使用可能な電話番号を検索し、[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) を使用してその電話番号を取得します。
トラフィック分散グループに電話番号を登録する前に、[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API を使用して、トラフィック分散グループのステータスが `ACTIVE` であることを確認することをお勧めします。`ACTIVE` ではないトラフィック分散グループに電話番号を割り当てると、`ResourceNotFoundException` になります。
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API を呼び出すときに **TargetArn** パラメータにトラフィック分散グループ ARN を指定することで、トラフィック分散グループに電話番号を登録できます。[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API を使用して、以前にインスタンスに登録された電話番号をトラフィック分散グループに割り当てることもできます。
**注記**
**Description** (説明) フィールドを更新するには、Amazon Connect コンソールを使用する必要があります。
## ワークフローの例
以下は、複数の AWS リージョンに電話番号を登録して使用するワークフローの例です。
1. インスタンスのレプリカを作成します:
1. [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API を呼び出します。
1. これらのインスタンスをリンクするトラフィック分散グループを作成します:
1. [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API を呼び出します。
1. トラフィック分散グループに登録できる電話番号を検索します:
1. トラフィック分散グループが作成されたリージョンで [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API を呼び出します。`TargetArn` パラメータにトラフィック分散グループの ARN を指定します。
1. トラフィック分散グループが作成されたリージョンで、[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API を呼び出します。
1. `TargetArn` パラメータにトラフィック分散グループの ARN を指定します。
1. ステップ 3 で [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API 呼び出しによって返された E164 電話番号の値を指定します。
`PhoneNumberId` と `PhoneNumberArn` が返されます。これらの値は、フォローアップ操作に使用できます。
1. 電話番号のステータスが `CLAIMED` であることを確認します:
1. [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) API を呼び出します。
(DescribePhoneNumber は、トラフィック分散グループに関連する他のリージョンでも呼び出すことができます。この場合、同じ電話番号の詳細が返されます。)
電話番号は、ステータスが `CLAIMED` になった後でのみ、フォローアップ操作で使用できます。
ステータスが取り得る値については、「[電話番号ステータスの定義](#claim-phone-number-status)」を参照してください。
1. トラフィック分散グループに登録する必要があるすべての電話番号について、ステップ 3～5 を繰り返します。
1. フローを電話番号に関連付けるには、以下のステップを実行します。トラフィック分散グループが動作する両方のリージョンで実行します。
これらのステップにより、テレフォニートラフィックがフローに正しくルーティングされ、トラフィック分散設定をサポートできるようになります。
1. トラフィック分散グループが作成されたリージョンの既存の Amazon Connect インスタンスで、以下のステップを実行します。
1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API を呼び出します。レプリケーションされたインスタンスに対応する `InstanceId` を指定します。
1. フロー ARN のリストが返されます。これらのフロー ARN を使用して、フローを電話番号に関連付けます。[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API を呼び出します。
1. 他のリージョンのレプリケートされた Amazon Connect インスタンスで AWS 、次の手順を実行します。
1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API を呼び出します。レプリケーションされたインスタンスに対応する `InstanceId` を指定します。
1. フロー ARN のリストが返されます。これらのフロー ARN を使用して、フローを電話番号に関連付けます。[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API を呼び出します。
## ClaimPhoneNumber 呼び出しが失敗する理由
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API の呼び出しは、次の場合に `ResourceNotFoundException` で失敗します。
+ 指定したトラフィック分散グループが存在しない、トラフィック分散グループのステータスが `ACTIVE` ではない、またはトラフィック分散グループの所有権を持っていない。
+ 電話番号を登録に使用できない。場合によっては、[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) で見つかった電話番号が、別の顧客によって登録された可能性があります。
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) は、次の場合に `InvalidParameterException` で失敗します。
+ 呼び出しているエンドポイントが、トラフィック分散グループが作成されたリージョンとは異なります。
## 電話番号ステータスの定義
電話番号のステータスの説明は次のとおりです。
+ `CLAIMED` は、前回の [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) または [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作が成功したことを意味します。
+ `IN_PROGRESS` は、[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)、[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) の操作がまだ進行中であり、完了していないことを意味します。後で [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) を呼び出して、前の操作が完了したかどうかを確認できます。
+ `FAILED` は、前回の [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) または [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作が失敗したことを示します。失敗の原因を示すメッセージが含まれます。
失敗の原因としてよくあるのは、電話番号を登録または更新しようとしている `TargetArn` の値が、登録件数の上限に達したことです。
`ClaimPhoneNumber` API の呼び出しから `FAILED` ステータスが返された場合、電話番号がインベントリに戻されて他の顧客が登録できるようになるまで 1 日待ってから、電話番号の登録を再試行する必要があります。