翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # RCS エージェントの管理 AWS RCS エージェントは、RCS メッセージングのブランドを表す AWS エンドユーザーメッセージングの最上位リソースです。これは、テストエージェントと国起動エージェント (RCS for Business IDs。キーワードと双方向メッセージング設定は、AWS RCS エージェントで定義されます。ブランドアセットは、各登録 (テストエージェントまたは国起動エージェント) で定義されます。AWS RCS エージェントと RCS for Business IDs「」を参照してください[RCS とは](rcs-overview.md)。 AWS RCS エージェントはこのライフサイクルに従います。 1. AWS RCS エージェント****を作成します。 1. **テストエージェントを追加します** (コンソール作成フローに含まれ、CLI 経由のオプション）。 1. 登録された**テスト**デバイスで RCS メッセージングをテストします。テストにキャリアの承認は必要ありません。 1. 本番稼働用 RCS メッセージを送信する国ごとに国**起動登録を送信します**。 1. **一部承認済み**: 少なくとも 1 つのキャリアがエージェントを承認しました。承認済みキャリアの受信者への送信を開始できます。 1. **完全に承認**: 国のすべてのキャリアがエージェントを承認しました。その国へのフルリーチ。 1 つの AWS RCS エージェントは、1 つのテストエージェント (ビジネス ID の RCS) と複数の国起動エージェント (国ごとにビジネス ID の RCS) にマッピングされます。コンソールで AWS RCS エージェントを作成すると、ワークフローによってすぐにテストエージェントを作成するように指示されます。次に、テストエージェントのブランド設定を使用して国起動登録フォームを事前入力し、重複するデータ入力を減らします。 **Topics** + [AWS RCS エージェントについて](#rcs-agents-concept) + [2 レベルの ID モデルについて](#rcs-agents-identity-model) + [AWS RCS エージェントの作成](#rcs-agents-create) + [AWS RCS エージェントの更新](#rcs-agents-update) + [AWS RCS エージェントの表示](#rcs-agents-view) + [テストエージェントの確認](#rcs-agents-review-test-agent) + [国の起動ステータスの表示](#rcs-agents-country-launch-status) + [AWS RCS エージェントの削除](#rcs-agents-delete) ## AWS RCS エージェントについて AWS RCS エージェントは、管理する RCS for Business IDs とは異なります。次の表は、違いをまとめたものです。 **AWS RCS エージェントと RCS for Business ID の比較** | 属性 | AWS RCS エージェント | RCS for Business ID | | --- | --- | --- | | 管理者 | AWS エンドユーザーメッセージングコンソールまたは API を通じて | AWS 登録プロセス中のエンドユーザーメッセージング | | スコープ | ブランドまたはユースケースごとに 1 つ | 国ごとに 1 つの起動と 1 つのテストエージェント | | 設定 | わかりやすい名前、削除保護、オプトアウトリスト、タグ、キーワード、双方向メッセージングの送信先 | 登録中に定義されたブランドアセットおよびその他の設定 | | 識別子 | rcs-a1b2c3d4 形式 | RCS インフラストラクチャプロバイダーによって内部的に管理される | ### エージェント ID と ARN 各 AWS RCS エージェントには、 形式の一意の識別子があります `rcs-a1b2c3d4` (プレフィックスの`rcs-`後に 16 進文字列が続きます）。この ID は、 `UpdateRcsAgent`や などの API オペレーションを呼び出すときに使用します`DeleteRcsAgent`。 各 AWS RCS エージェントには、次の形式の AWS リソース ARN もあります。 ``` arn:aws:sms-voice:{{region}}:{{account-id}}:rcs-agent/{{rcs-agent-id}} ``` AWS RCS エージェントを `SendTextMessage` API の送信元 ID として指定するとき、またはエージェントを電話プールに追加するときに、ARN を使用できます。 ### ライフサイクル状態 AWS RCS エージェントは、次のライフサイクル状態に移行します。 **作成済み** AWS RCS エージェントリソースは AWS エンドユーザーメッセージングで作成されていますが、登録はまだ送信されていません。この状態でブランドアセットと設定を更新できます。 **保留中** 登録が送信され、処理を待っています。エージェントはまだメッセージを送信できません。 **テスト** テスト登録が承認されました。エージェントにはテストエージェント (RCS for Business ID) があり、登録されたテストデバイスにメッセージを送信できます。国の起動登録は完了していません。 **部分的** 少なくとも 1 つの国起動登録が完了しましたが、送信されたすべての国起動がアクティブではありません。エージェントは、承認された国のメッセージを送信できますが、エージェントを承認した特定のキャリア (複数可) の受信者にのみメッセージを送信できます。ある国の `CountryStatus`は、その国の少なくとも 1 つのキャリアがアクティブになるとすぐに PARTIAL に移行します。 **アクティブ** 送信されたすべての国起動登録は完了し、アクティブです。エージェントは、登録されているすべての国で完全に運用されています。新しい国はまだ承認されていないため、新しい国の起動登録が送信されると、ACTIVE エージェントは PARTIAL ステータスに戻る可能性があることに注意してください。 **DELETED** AWS RCS エージェントは削除されました。関連するすべての RCS for Business IDs (テストエージェントと国起動エージェント) は非アクティブ化されます。このアクションを元に戻すことはできません。 ## 2 レベルの ID モデルについて AWS エンドユーザーメッセージングの RCS は、**AWS RCS エージェント**と 1 つ以上の **RCS for Business IDs** 2 つのレベルの ID モデルを使用します。 **AWS RCS エージェント** AWS RCS エージェントは、 AWS エンドユーザーメッセージングで作成して管理する最上位のリソースです。これは、テストエージェントと国起動エージェントを結合する統合リソースとして機能します。キーワードと双方向メッセージング設定は、AWS RCS エージェントで定義されます。ブランドアセットは登録ごとに定義されます。各 AWS RCS エージェントには、 形式の一意の識別子`rcs-a1b2c3d4`とリソース ARN があります AWS 。AWS RCS エージェントを、RCS を起動するすべての国におけるブランドの統一されたアイデンティティと考えてください。 **RCS for Business ID** RCS for Business ID は、登録プロセス中に RCS インフラストラクチャプロバイダーで作成される国ごとのエージェント ID です。国ごとに、AWS RCS エージェントの下に個別の RCS for Business ID が作成されます。RCS for Business IDsを直接管理することはありません。 AWS エンドユーザーメッセージングは、登録プロセスの一環として作成とライフサイクルを処理します。 1 つの AWS RCS エージェントは、次の RCS for Business IDsを持つことができます。 + 1 **つのテストエージェント** — テスト登録フェーズ中に作成された RCS for Business ID。テストエージェントは登録されたテストデバイスと連携し、本番環境で を起動する前に RCS 統合を検証できます。テストメッセージは標準料金で課金されます。 + **複数の国起動エージェント** — RCS を起動する各国は、個別の RCS for Business ID を作成します。たとえば、米国とカナダの両方で を起動する場合、AWS RCS エージェントには、テストエージェントに加えて 2 つの国起動エージェント (米国 RCS for Business ID とカナダ RCS for Business ID) があります。 次の図は、これらの ID の関係を示しています。 ``` AWS RCS Agent (rcs-a1b2c3d4) ├── Testing agent (RCS for Business ID) ├── US country launch agent (US RCS for Business ID) └── CA country launch agent (Canada RCS for Business ID) ``` キーワードと双方向メッセージングの送信先は AWS RCS エージェントで設定され、関連するすべての RCS for Business IDsに適用されます。ブランドアセットは、各登録 (テストエージェントまたは国起動エージェント) に固有です。AWS RCS エージェントには、フレンドリ名、削除保護、オプトアウトリストなどのアカウントレベルの設定も保持されます。 ## AWS RCS エージェントの作成 AWS RCS エージェントは、 AWS エンドユーザーメッセージングコンソールまたは `CreateRcsAgent` API を使用して作成できます。エージェントを作成するときは、コンソールでわかりやすい名前 (タグとして保存され、API では表示されない、または受信者の電話では表示されないコンソール専用ラベル) を指定し、削除保護やオプトアウトリストの関連付けなどのオプションの設定を行います。ブランドアセットは、AWS RCS エージェント自体ではなく、登録時に定義されます。 ### ブランドアセットの要件 ブランドアセットは、RCS メッセージとともに受信者に表示されます。ブランドアセットはテスト登録の一部として送信され、コンソールはエージェント作成ワークフローの継続として表示します。AWS RCS エージェントを作成するときは、次のアセットが必要です。 **ロゴ** ブランドを表す正方形の画像。ロゴがメッセージとともにメッセージングアプリに表示されます。 + ディメンション: 224 × 224 ピクセル + 形式: 透明性のある PNG + 最大ファイルサイズ: 50 KB **バナーイメージ** メッセージングアプリのエージェントのプロファイルの上部に表示されるワイドイメージ。バナーイメージは Android デバイスにのみ表示されます。 + ディメンション: 1440 x 448 ピクセル + 形式: PNG または JPEG + 最大ファイルサイズ: 200 KB **ブランドの色** メッセージングアプリのアクセント色として使用される 16 進カラーコード (例: `#1A73E8`)。アクセシビリティ要件を満たすには、色のコントラスト比が白の背景に対して 4.5:1 以上である必要があります。コントラスト比が正しく設定されていない場合、エージェントは承認されない可能性があります。 **重要** ブランドアセットには、エージェントの作成後の変更に制限があります。一部のブランドアセットは、エージェントが登録用に送信されると変更できません。AWS RCS エージェントを作成する前に、最終的なブランドアセットを準備します。 ------ #### [ Console ] AWS エンドユーザーメッセージングコンソールは、AWS RCS エージェントの作成と登録のテストを単一のガイド付きワークフローとして表示します。コンソールstep-by-step「」を参照してください[ステップ 1: AWS RCS エージェントを作成してテスト登録を送信する](rcs-getting-started.md#rcs-getting-started-create-agent)。 ------ #### [ AWS CLI ] `create-rcs-agent` コマンドを使用して AWS RCS エージェントを作成します。ブランドアセット (表示名、説明、ロゴ、バナー、ブランドカラー) は、このコマンドのパラメータではありません。これらは、テスト登録を作成するときに登録フィールドとして送信されます。 ``` aws pinpoint-sms-voice-v2 create-rcs-agent \ --deletion-protection-enabled ``` 以下のオプションパラメータを使用できます。 + `--deletion-protection-enabled` — 削除保護が無効になるまで、エージェントが削除されないようにします。 + `--opt-out-list-name` — 既存のオプトアウトリストをエージェントに関連付けます。 + `--tags` — AWS RCS エージェントを整理して識別するためのキーと値のペア。 ------ ## AWS RCS エージェントの更新 `UpdateRcsAgent` API を使用して、既存の AWS RCS エージェントの設定を変更します。次の設定を更新できます。 + **削除保護** — エージェントの削除保護を有効または無効にします。 + **オプトアウトリスト** — オプトアウトリストとエージェントとの関連付けまたは関連付け解除。 + **双方向メッセージングの送信先** — インバウンドメッセージが配信される Amazon SNS トピックと IAM ロールを設定します。RCS では、双方向メッセージングは常に有効になっています。お客様は、すべてのインバウンド RCS メッセージに対して標準料金で課金されます。この設定は、受信されたかどうかではなく、インバウンドメッセージが配信される場所を制御します。 **注記** API を使用した AWS RCS エージェント設定の変更は、すぐに使用できます。ただし、ブランドアセット (ロゴ、バナー、表示名などの登録フィールド) の更新は RCS インフラストラクチャプロバイダーによってレビューされ、受信者のデバイスに表示されるまでに時間がかかる場合があります。API の変更が適用されたことを確認するには、 `DescribeRcsAgents` API を使用して、 AWS エンドユーザーメッセージングで現在のエージェント設定を確認します。 ## AWS RCS エージェントの表示 AWS RCS エージェントは、 AWS エンドユーザーメッセージングコンソールまたは `DescribeRcsAgents` API を使用して表示できます。 ------ #### [ Console ] コンソールで AWS RCS エージェントを表示するには、ナビゲーションペイン**の設定**の下にある **RCS エージェント**ページに移動します。リストページには、現在のライフサイクル状態、エージェント ID、表示名など、アカウント内のすべての AWS RCS エージェントが表示されます。 エージェントを選択すると、ブランドアセット、設定、関連する登録などの詳細が表示されます。 ------ #### [ AWS CLI ] `describe-rcs-agents` コマンドを使用して、アカウント内のすべての AWS RCS エージェントを一覧表示します。 ``` aws pinpoint-sms-voice-v2 describe-rcs-agents ``` 特定のエージェントの詳細を取得するには、 `--rcs-agent-ids`パラメータを使用します。 ``` aws pinpoint-sms-voice-v2 describe-rcs-agents \ --rcs-agent-ids rcs-a1b2c3d4 ``` ------ ## テストエージェントの確認 国の起動登録を送信する前に、テストエージェント設定を確認して、ブランドアセット、キーワード、メッセージング設定が正しいことを確認します。テストエージェントは国起動登録のテンプレートとして機能するため、続行する前に問題を解決する必要があります。 テストエージェントを確認するには、 AWS エンドユーザーメッセージングコンソールで AWS RCS エージェントに移動し、**登録**タブを選択します。テスト登録には、受信者のデバイスに表示されるロゴ、バナーイメージ、ブランドカラー、表示名など、現在のブランド設定が表示されます。 `DescribeRegistrationFieldValues` API を使用して、テスト登録の現在のフィールド値をプログラムで取得することもできます。 ## 国の起動ステータスの表示 AWS RCS Agent の国起動登録を送信すると、その国の各キャリアの承認ステータスを追跡できます。 ------ #### [ Console ] コンソールで国起動ステータスを表示するには、AWS RCS エージェントの詳細ページに移動し、**国起動ステータス**タブを選択します。このタブには、起動登録を送信した各国の各キャリアの承認ステータスが表示されます。 ------ #### [ AWS CLI ] `describe-rcs-agent-country-launch-status` コマンドを使用して、キャリアごとの起動ステータスを取得します。 ``` aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \ --rcs-agent-id rcs-a1b2c3d4 ``` レスポンスには、起動登録を送信した各国の各キャリアの承認ステータスが含まれます。 ------ 各キャリアはエージェントを個別に確認および承認します。AWS RCS エージェントは、その国の少なくとも 1 つのキャリアがエージェントを承認するとすぐに、その国でメッセージを送信できます。RCS メッセージの送信を開始する前に、すべてのキャリアが承認するのを待つ必要はありません。追加のキャリアがエージェントを承認すると、その国のリーチが増加します。 **注記** 国起動ステータス画面から追加の国起動をリクエストできます。新しい国のローンチごとに個別の登録が作成され、独自のキャリア承認プロセスが実行されます。 ## AWS RCS エージェントの削除 `DeleteRcsAgent` API を使用して AWS RCS エージェントを完全に削除します。エージェントを削除すると、関連するすべての RCS for Business IDs (テストエージェントとすべての国起動エージェントを含む) が非アクティブ化されます。 **警告** AWS RCS エージェントの削除は永続的であり、元に戻すことはできません。エージェントに関連付けられたすべての登録、国の起動、およびテスト設定は失われます。 AWS RCS エージェントを削除する前に、まず関連するすべての登録 (テスト登録と国起動登録の両方) を削除してから、削除保護を無効にする必要があります。削除保護が有効になっている場合、`DeleteRcsAgent`API はエラーを返します。削除保護を無効にするには、削除保護を に設定して `UpdateRcsAgent` API を使用します`false`。 **AWS RCS エージェントを削除するには** 1. 削除保護が有効になっている場合は、削除保護を に設定して `UpdateRcsAgent` API を呼び出して無効にします`false`。 1. 削除する AWS RCS エージェントのエージェント ID または ARN を使用して `DeleteRcsAgent` API を呼び出します。 1. `DescribeRcsAgents` API を呼び出して、エージェントが削除されたことを確認します。エージェントは結果に表示されなくなるか、ステータスが DELETED になります。