翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# プールでの AWS RCS エージェントの管理
AWS RCS エージェントは、SMS 電話番号とともに電話プール内の発信元 ID として追加できます。プールに AWS RCS エージェントと SMS の両方の電話番号が含まれている場合、 AWS エンドユーザーメッセージングは最初に RCS 配信を試み、RCS 配信が不可能な場合は自動的に SMS にフォールバックします。フォールバックの仕組みの詳細については、「」を参照してください[電話プールを使用した RCS から SMS へのフォールバック](rcs-sms-fallback.md)。
**注記**
AWS RCS エージェントをプールに追加するときは、ISO 国コード`ZZ`として を使用します。この`ZZ`コードは、RCS エージェントがプールレベルで国固有ではないことを示します。国固有のルーティングは、エージェントの国起動登録を通じて処理されます。プールには、RCS エージェントとともに複数の国の電話番号を含めることができます。
ISO 国コードはプールの作成時に提供されますが、プールには保持されません。を呼び出すと`DescribePools`、ISO 国コードはレスポンスに表示されません。
## AWS RCS エージェントを使用したプールの作成
AWS エンドユーザーメッセージングコンソールまたは `CreatePool` API を使用して、AWS RCS エージェントを含む新しいプールを作成できます。
------
#### [ Console ]
**コンソールを使用して AWS RCS エージェントでプールを作成するには**
1. AWS エンドユーザーメッセージングコンソールを開きます。
1. ナビゲーションペインで、**電話プール**を選択します。
1. **[プールを作成]** を選択します。
1. **送信元 ID** で、AWS RCS エージェントを選択します。プールは、選択した送信元 ID からその設定を継承します。
1. 必要に応じてプール設定を設定し、**プールの作成**を選択します。
1. プールを作成したら、SMS 電話番号をプールに追加して SMS フォールバックを有効にします。プール内のすべての発信元 ID には、一致する設定が必要です。詳細については、「[RCS のプール設定要件](#phone-pool-rcs-config)」を参照してください。
------
#### [ AWS CLI ]
`CreatePool` API を使用して、AWS RCS エージェントを最初の送信元 ID としてプールを作成します。プールの作成時に、発信元 ID として AWS RCS エージェント ARN を指定します。
次の例では、 CLI AWS を使用してプールを作成します。
```
aws pinpoint-sms-voice-v2 create-pool \
--origination-identity arn:aws:sms-voice:{{region}}:{{account-id}}:rcs-agent/{{rcs-agent-id}} \
--iso-country-code ZZ \
--message-type TRANSACTIONAL
```
プールを作成したら、 `AssociateOriginationIdentity` API を使用してフォールバック用にプールに SMS 電話番号を追加します。
------
## 既存のプールへの AWS RCS エージェントの追加
SMS 電話番号を持つプールがすでにある場合は、AWS RCS エージェントをプールに追加して、SMS フォールバックによる RCS メッセージングを有効にできます。AWS RCS エージェントがすでに含まれているプールに SMS 電話番号を追加することもできます。
**重要**
既存のプールに発信元 ID を追加する前に、プールの設定が追加する ID と一致することを確認します。プール内のすべての送信元 ID には、同じメタデータが必要です。不一致がある場合、オペレーションは で失敗します`ConflictException`。一致する必要があるフィールドと不一致の解決方法の詳細については、「」を参照してください[RCS のプール設定要件](#phone-pool-rcs-config)。
------
#### [ Console ]
コンソールを使用して AWS RCS エージェントをプールに追加する前に、プールの詳細ページを調べて現在の設定を確認します。プールのメッセージタイプ、ISO 国コード、およびその他の設定が、追加する AWS RCS エージェントと互換性があることを確認します。
**コンソールを使用して既存のプールに AWS RCS エージェントを追加するには**
1. AWS エンドユーザーメッセージングコンソールを開きます。
1. ナビゲーションペインで、**電話プール**を選択します。
1. AWS RCS エージェントを追加するプールを選択します。
1. 詳細ページでプールの設定を確認します。メッセージタイプおよびその他の設定が、追加する AWS RCS エージェントと一致することを確認します。
1. **送信元 ID** セクションで、**送信元 ID の追加** を選択します。
1. リストから AWS RCS エージェントを選択し、**追加** を選択します。
------
#### [ AWS CLI ]
CLI または API を使用してプールに AWS RCS エージェントを追加する前に、 `DescribePools` API を使用してプールの現在の設定を取得します。プールの設定が、追加する AWS RCS エージェントと一致することを確認します。
次の の例では、プールの詳細を取得します。
```
aws pinpoint-sms-voice-v2 describe-pools \
--pool-ids {{pool-id}}
```
設定が一致していることを確認したら、 `AssociateOriginationIdentity` API を使用して AWS RCS エージェントをプールに追加します。
```
aws pinpoint-sms-voice-v2 associate-origination-identity \
--pool-id {{pool-id}} \
--origination-identity arn:aws:sms-voice:{{region}}:{{account-id}}:rcs-agent/{{rcs-agent-id}} \
--iso-country-code ZZ
```
------
## RCS のプール設定要件
プール内のすべての送信元 ID には、同じメタデータが必要です。発信元 ID をプールに追加すると、 AWS End User Messaging は ID の設定をプールの既存の設定と比較します。不一致がある場合、オペレーションは、異なる特定のフィールドに関する詳細`ConflictException`を含む で失敗します。
プール設定フィールドは、プールの作成時に設定され変更できないイミュータブルフィールドと、作成後に更新できるミュータブルフィールドの 2 つのカテゴリに分類されます。
**イミュータブルプール設定フィールドとミュータブルプール設定フィールド**
| フィールド | ミュータビリティ | 注意事項 |
| --- | --- | --- |
| メッセージタイプ | Immutable | プールの作成時に を設定します。すべての ID が一致している必要があります。 |
| ISO 国コード | Immutable | プールの作成時に を設定します。AWS RCS エージェントの場合、値は ですZZ。プールには、複数の国の電話番号を含めることができます。 |
| 削除保護 | Mutable | 作成後に切り替えることができます。ID 間で一貫性がある必要があります。 |
| オプトアウトリスト | Mutable | 作成後に変更できます。ID 間で一貫性がある必要があります。 |
次の設定フィールドは、プール内のすべての送信元 ID で一致する必要があります。
+ **メッセージタイプ** — すべての ID は同じメッセージタイプ (TRANSACTIONAL や PROMOTIONAL など) に設定する必要があります。
+ **ISO 国コード** — プールの作成時に を設定します。AWS RCS エージェントの場合は、ISO 国コード`ZZ`として を使用します。プールには、複数の国の電話番号を含めることができます。
+ **削除保護** — 削除保護設定は、ID 間で一貫している必要があります。
+ **オプトアウトリスト** — すべての ID を同じオプトアウトリストに関連付けるか、いずれの ID にもオプトアウトリストを含めることはできません。
### ConflictException エラーについて
送信元 ID をプールに追加しようとして設定が一致しない場合、 `AssociateOriginationIdentity`または `CreatePool` API は を返します`ConflictException`。例外メッセージには、ID とプール間で異なるフィールドに関する詳細が含まれます。
例えば、PROMOTIONAL メッセージ用に設定された電話番号を TRANSACTIONAL メッセージ用に設定されたプールに追加しようとすると、エラーメッセージはメッセージタイプが一致しないことを示します。
を解決するには`ConflictException`:
1. エラーメッセージを確認して、どのフィールドが異なるかを特定します。
1. フィールドが一致するように送信元 ID またはプール設定を更新します。
1. `AssociateOriginationIdentity` または `CreatePool`オペレーションを再試行します。
**注記**
設定の不一致を解決できない場合は、送信元 ID 用に別のプールを作成することを検討してください。各プールは独自の設定を持つことができ、ユースケースごとに異なるプールを使用できます。
## プールからの AWS RCS エージェントの削除
AWS RCS エージェントをプールから削除するには、 AWS エンドユーザーメッセージングコンソールまたは `DisassociateOriginationIdentity` API を使用します。プールから AWS RCS エージェントを削除すると、そのプールを介して送信されたメッセージの RCS 配信が無効になります。エージェントの削除後にプールに送信されるメッセージは、SMS 経由でのみ配信されます (プール内の残りの電話番号を使用）。
------
#### [ Console ]
**コンソールを使用してプールから AWS RCS エージェントを削除するには**
1. AWS エンドユーザーメッセージングコンソールを開きます。
1. ナビゲーションペインで、**電話プール**を選択します。
1. 削除する AWS RCS エージェントを含むプールを選択します。
1. **送信元 ID** セクションで、AWS RCS エージェントを選択します。
1. **削除**を選択し、削除を確定します。
------
#### [ AWS CLI ]
`DisassociateOriginationIdentity` API を使用してプールから AWS RCS エージェントを削除します。
```
aws pinpoint-sms-voice-v2 disassociate-origination-identity \
--pool-id {{pool-id}} \
--origination-identity arn:aws:sms-voice:{{region}}:{{account-id}}:rcs-agent/{{rcs-agent-id}} \
--iso-country-code ZZ
```
AWS RCS エージェントを削除すると、プールを介して送信されたメッセージは SMS 経由でのみ配信されます。RCS 配信を再度有効にするには、 `AssociateOriginationIdentity` API を使用して AWS RCS エージェントをプールに戻します。
------