翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
プールでの AWS RCS エージェントの管理
AWS RCS エージェントは、SMS 電話番号とともに電話プール内の発信元 ID として追加できます。プールに AWS RCS エージェントと SMS の両方の電話番号が含まれている場合、 AWS エンドユーザーメッセージングは最初に RCS 配信を試み、RCS 配信が不可能な場合は自動的に SMS にフォールバックします。フォールバックの仕組みの詳細については、「」を参照してください電話プールを使用した RCS から SMS へのフォールバック。
注記
AWS RCS エージェントをプールに追加するときは、ISO 国コードZZとして を使用します。このZZコードは、RCS エージェントがプールレベルで国固有ではないことを示します。国固有のルーティングは、エージェントの国起動登録を通じて処理されます。プールには、RCS エージェントとともに複数の国の電話番号を含めることができます。
ISO 国コードはプールの作成時に提供されますが、プールには保持されません。を呼び出すとDescribePools、ISO 国コードはレスポンスに表示されません。
AWS RCS エージェントを使用したプールの作成
AWS エンドユーザーメッセージングコンソールまたは CreatePool API を使用して、AWS RCS エージェントを含む新しいプールを作成できます。
既存のプールへの AWS RCS エージェントの追加
SMS 電話番号を持つプールがすでにある場合は、AWS RCS エージェントをプールに追加して、SMS フォールバックによる RCS メッセージングを有効にできます。AWS RCS エージェントがすでに含まれているプールに SMS 電話番号を追加することもできます。
重要
既存のプールに発信元 ID を追加する前に、プールの設定が追加する ID と一致することを確認します。プール内のすべての送信元 ID には、同じメタデータが必要です。不一致がある場合、オペレーションは で失敗しますConflictException。一致する必要があるフィールドと不一致の解決方法の詳細については、「」を参照してくださいRCS のプール設定要件。
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:
-
エラーメッセージを確認して、どのフィールドが異なるかを特定します。
-
フィールドが一致するように送信元 ID またはプール設定を更新します。
-
AssociateOriginationIdentityまたはCreatePoolオペレーションを再試行します。
注記
設定の不一致を解決できない場合は、送信元 ID 用に別のプールを作成することを検討してください。各プールは独自の設定を持つことができ、ユースケースごとに異なるプールを使用できます。
プールからの AWS RCS エージェントの削除
AWS RCS エージェントをプールから削除するには、 AWS エンドユーザーメッセージングコンソールまたは DisassociateOriginationIdentity API を使用します。プールから AWS RCS エージェントを削除すると、そのプールを介して送信されたメッセージの RCS 配信が無効になります。エージェントの削除後にプールに送信されるメッセージは、SMS 経由でのみ配信されます (プール内の残りの電話番号を使用）。
