翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # RCS の開始方法 このガイドでは、 AWS エンドユーザーメッセージングで最初の RCS エージェントを設定し、最初の RCS メッセージを送受信する方法について説明します。最終的には、RCS テスト環境が機能します。推定完了時間: 15～30 分。 このガイドの内容は次のとおりです。 1. AWS RCS エージェントを作成してテスト登録を送信する 1. テストデバイスを追加してテスターの招待を受け入れる 1. 最初のアウトバウンド RCS メッセージを送信する 1. キーワードを使用してインバウンド (双方向) メッセージングをテストする 2 レベルの ID モデル (AWS RCS エージェントと RCS for Business ID) を含む、 AWS エンドユーザーメッセージングでの RCS の動作の背景については、「」を参照してください[RCS とは](rcs-overview.md)。 IDs ## RCS のセットアップとテスト このセクションでは、AWS RCS エージェントの作成、テストデバイスの登録、最初の RCS メッセージの送信、配信の検証について説明します。これらのステップを完了したら、本番稼働国で RCS の起動に進むことができます。 ### 前提条件 作業を開始する前に、次の項目があることを確認します。 + ** AWS エンドユーザーメッセージングアクセスを持つ AWS アカウント** — AWS エンドユーザーメッセージングを使用するためのアクセス許可を持つ AWS アカウントが必要です。アカウントをお持ちでない場合は、[AWS アカウント設定ガイド](https://docs.aws.amazon.com/accounts/latest/reference/welcome-first-time-user.html)を参照してください。 + **RCS が有効になっている電話** — デフォルトのメッセージングアプリで RCS メッセージングが有効になっている Android スマートフォン、または iOS 18 以降を実行している iPhone が必要です。この電話は、RCS メッセージを受信するためのテストデバイスとして機能します。 + **(オプション) AWS CLI 設定**済み — コンソールの代わりに API を使用してテストする場合は、CLI AWS をインストールして設定するか、boto3 for Python などの AWS SDK を使用します。 ### ステップ 1: AWS RCS エージェントを作成してテスト登録を送信する 最初のステップは、AWS RCS エージェントを作成し、テスト登録を送信することです。テスト登録は、キャリアの承認なしで登録されたテストデバイスにメッセージを送信するために使用できる RCS for Business ID (テストエージェント) を作成します。 エージェントのライフサイクルや API オペレーションなど、AWS RCS エージェント管理の詳細については、「」を参照してください[RCS エージェントの管理](rcs-agents.md)。 #### AWS RCS エージェントの作成 (コンソール) **AWS RCS エージェントを作成してテスト登録を送信するには** 1. [AWS エンドユーザーメッセージングコンソール](https://console.aws.amazon.com/sms-voice/home)を開きます。 1. ナビゲーションペインの設定で**、RCS** **エージェント**を選択します。 1. **RCS エージェントの作成**を選択します。これにより、AWS RCS エージェントが作成され、すぐに 1 つのワークフローでテスト登録を作成する手順が表示されます。 1. 次の画面では、RCS の概要とセットアッププロセスについて説明します。情報を確認し、**次へ**を選択して続行します。 1. **エージェントの詳細**ページで、以下を設定します。 + **わかりやすい名前** — AWS RCS エージェントのコンソールのみのラベル。これは参照の内部名 (タグとして保存) であり、受信者の電話に表示される名前ではありません。フレンドリ名は API では使用できません。 + **削除保護** — (オプション) エージェントを誤って削除しないようにするには、 を有効にします。 + **タグ** — (オプション) エージェントを整理して識別するタグを追加します。 1. 同じページの**ブランド情報**セクションに、次のように入力します。 + **表示名** — 受信者が RCS メッセージとともに表示するブランド名。 + **説明** — ブランドまたはビジネスの簡単な説明。 + **ユースケース** — RCS メッセージングの主なユースケース (トランザクション通知、マーケティング、カスタマーサポートなど) を選択します。 1. 同じページの**ブランドアセット**セクションで、以下をアップロードします。 + **ロゴ** — 224 × 224 ピクセル、透明性のある PNG、50 KB 未満。 + **バナーイメージ** — 1440 x 448 ピクセル、PNG または JPEG、200 KB 未満。 + **ブランド色** — 白の背景に対する最小コントラスト比が 4.5:1 の 16 進カラーコード (例: `#1A73E8`)。 **重要** 一部のブランドアセットは、エージェントが登録のために送信された後に変更することはできません。エージェントを作成する前に、最終的なブランドアセットを準備します。最初に実験する場合は、このフローを使用してテストエージェントをすばやく作成し、後で完成したブランドアセットを使用して新しい AWS RCS エージェントを作成できます。 1. **Compliance キーワード**ページで、キーワードと自動応答メッセージを設定します。 1. **レビュー**ページで、すべての設定を確認します。 1. **検証と送信**を選択して AWS RCS エージェントを作成し、テスト登録を送信します。 **注記** AWS RCS エージェントが正常に作成され、テスト登録が送信されました。通常、テストエージェントは数分以内に承認されます。次に、デバイスへのテストメッセージングを有効にします。 #### AWS RCS エージェントの作成 (CLI) AWS CLI を使用して AWS RCS エージェントを作成することもできます。まず、エージェントを作成してから、テスト登録を送信します。 ステップ 1: AWS RCS エージェントを作成する: ``` aws pinpoint-sms-voice-v2 create-rcs-agent \ --deletion-protection-enabled ``` ステップ 2: エージェントのテスト登録を送信します。RCS テストの登録タイプで `CreateRegistration` API を使用します。`DescribeRegistrationFieldDefinitions` API を使用して、送信前に利用可能なすべての登録フォームフィールドをプログラムで取得できます。登録フォームフィールドの一部として、ブランドアセット、説明、連絡先の詳細を入力します。 登録 API の詳細については、「」を参照してください[RCS エージェントの管理](rcs-agents.md)。 ### ステップ 2: テストデバイスを追加する テスト登録が承認されたら、テストエージェントから RCS メッセージを受信できるように、電話をテストデバイスとして追加します。 **注記** テストデバイスを追加すると、テスターの招待はすぐには送信されません。システムはアクティベーションを少なくとも 120 秒間遅延させ、招待が到着するまでに最大 20 分かかることがあります。コンソールには、おおよそのアクティベーション時間が表示されます。デバイスを追加する前に待つ必要はありません。システムは自動的に遅延を処理します。 ------ #### [ Console ] **テストデバイスを追加するには** 1. AWS エンドユーザーメッセージングコンソールで、AWS RCS エージェントに移動し、**テスト**タブを選択します。 1. **テストデバイスの追加** を選択します。 1. テストデバイスの電話番号を E.164 形式で入力します (例: `+12065550100`)。 1. **[Add]** (追加) を選択します。 ------ #### [ AWS CLI ] API を `--rcs-agent-id`パラメータ`CreateVerifiedDestinationNumber`とともに使用して、AWS RCS エージェントのテストデバイスを登録します。 ``` aws pinpoint-sms-voice-v2 create-verified-destination-number \ --destination-phone-number +12065550100 \ --rcs-agent-id rcs-a1b2c3d4 ``` ------ テストデバイスを追加すると、 AWS End User Messaging はテスターの招待を電話番号に送信します。招待は **RBM Tester Management** という RCS エージェントから送信され、受け入れまたは拒否するための 2 つのボタンが含まれています。**テスターにする**、**拒否**する。受信者は**「テスターにする**」をタップして検証を完了する必要があります。 **注記** iOS デバイス (iOS 18 以降の iPhone) では、テスターの招待がメインの受信トレイではなく、メッセージアプリの**不明な送信者**フォルダに表示される場合があります。招待が表示されない場合は、不明な送信者フォルダを確認してください。 API アプローチやトラブルシューティングなど、テストデバイスの管理の詳細については、「」を参照してください[RCS メッセージのテスト](rcs-testing.md)。 ### ステップ 3: 最初の RCS メッセージを送信する テストデバイスがテスターの招待を承諾したら、最初の RCS メッセージを送信できます。 AWS エンドユーザーメッセージングコンソールまたは API を使用できます。 ------ #### [ Console ] **コンソールを使用してテストメッセージを送信するには** 1. AWS エンドユーザーメッセージングコンソールで、AWS RCS エージェントに移動し、**テスト**タブを選択します。 1. **アウトバウンドテストメッセージ**を選択します。コンソールには、メッセージの受信者のデバイスでのレンダリング方法のプレビューと、JSON リクエスト本文および CLI コマンドが表示されます。 1. リストから検証済みテストデバイスを選択します。 1. メッセージテキストを入力します。 1. **[テキストメッセージを送信]** を選択します。 **注記** オプションで、メッセージイベントの設定セットを設定できます。設定セットを使用すると、選択したイベント送信先で詳細な配信受信 (DLRs) やその他のメッセージイベントを消費できます。これはテストではオプションですが、本番環境での使用をお勧めします。詳細については、「[RCS CloudWatch メトリクスとモニタリング](rcs-monitoring.md)」を参照してください。 ------ #### [ AWS CLI ] `send-text-message` コマンドを使用してテストメッセージを送信します。AWS RCS エージェント ARN を送信元 ID として指定します。 ``` aws pinpoint-sms-voice-v2 send-text-message \ --destination-phone-number +12065550100 \ --origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \ --message-body "Hello from RCS! This is my first test message." ``` `send-text-message` コマンドは、SMS に使用するコマンドと同じです。AWS RCS エージェント ARN を発信元 ID として指定すると、 AWS エンドユーザーメッセージングは RCS を介してメッセージを配信します。 ------ ### ステップ 4: インバウンド (双方向) メッセージングをテストする 自動応答を使用してキーワードを設定し、そのキーワードに一致するメッセージをテストデバイスから送信することで、インバウンド RCS メッセージングをテストできます。 **自動応答キーワードを使用してインバウンドメッセージングをテストするには** 1. AWS エンドユーザーメッセージングコンソールで、AWS RCS エージェントに移動し、キーワードを設定します。たとえば、キーワードに`RCSINBOUNDTESTING`「インバウンドテストが成功しました！」などの自動応答メッセージを設定します。メッセージを受信しました。」 1. **テスト**タブで、**インバウンドディープリンク**を選択します。 1. **デフォルトのメッセージ本文**フィールドに、設定したキーワード ( など`RCSINBOUNDTESTING`) を入力します。 1. **リンクの生成**を選択します。コンソールは、GSMA 標準 URI スキームを使用してインバウンドディープリンク URL `sms:` を生成します。このディープリンクは、画面に表示される QR コードに埋め込まれます。 1. 検証済みのテスターフォンで QR コードをスキャンします。これにより、ネイティブメッセージングアプリが開き、AWS RCS エージェント宛てのメッセージが事前に入力されます。 1. テストデバイスからメッセージを送信します。 1. テストデバイスで自動応答メッセージを受信していることを確認します。 自動応答キーワードをテストする場合、イベント送信先または Amazon SNS トピックを設定する必要はありません。自動応答は、AWS RCS エージェントのキーワード設定に基づいて、 AWS エンドユーザーメッセージングによって完全に処理されます。 (キーワード一致だけでなく) 任意のインバウンドメッセージを受信して処理するには、双方向メッセージング用に Amazon SNS トピックを設定する必要があります。詳細については、「[インバウンド RCS メッセージの受信](rcs-inbound.md)」を参照してください。 ### 達成したこと このガイドのステップを完了すると、次のことが可能になります。 + ブランドアセットを使用して AWS RCS エージェントを作成し、テスト登録を送信しました + テストデバイスを登録し、テスターの招待を承諾した + 最初の RCS メッセージと検証済み配信を送信しました + 自動応答キーワードを使用してテストされたインバウンドメッセージング これで、テスト環境の準備が整いました。RCS メッセージングをアプリケーションに統合する方法、または RCS メッセージングの仕組みを微調整する方法は次のとおりです。 + **インバウンドメッセージの受信と処理**: インバウンド RCS メッセージを受信し、Lambda 関数で処理するように Amazon SNS トピックを設定します。「[インバウンド RCS メッセージの受信](rcs-inbound.md)」を参照してください。 + **配信イベントの追跡**: 選択したイベント送信先で詳細な配信受信 (DLRs) やその他のメッセージイベントを消費するように設定セットを設定します。「[RCS CloudWatch メトリクスとモニタリング](rcs-monitoring.md)」を参照してください。 + **SMS フォールバックを有効にする**: RCS 配信が不可能な場合、AWS RCS エージェントと SMS 電話番号を使用して電話プールを作成し、自動的に SMS にフォールバックします。「[電話プールを使用した RCS から SMS へのフォールバック](rcs-sms-fallback.md)」を参照してください。 + **本番稼働国での **の起動: 米国とカナダのすべての受信者に RCS メッセージを送信するための国起動登録を送信します。「[各国での RCS の起動](rcs-country-launch.md)」を参照してください。 ## RCS セットアップの AI エージェントプロンプト 生成 AI コーディングアシスタントまたは AI エージェントを使用する場合は、次のプロンプトを使用して、AWS RCS エージェントの作成、テスト登録の送信、CLI AWS を使用した最初のテストメッセージの送信に関するヘルプを取得できます。 **注記** 次のプロンプトをコピーし、AI エージェントまたはコーディングアシスタントに貼り付けます。 ``` ## RCS Setup Assistant Prompt Help me set up RCS messaging in AWS End User Messaging using the AWS CLI. The service is `pinpoint-sms-voice-v2`. Walk me through each step with exact CLI commands. Ask me for all required details before generating any commands. **Important rules for generating commands:** - All commands use the `pinpoint-sms-voice-v2` service. - Use `create-rcs-agent` exactly as spelled — NOT `create-r-c-s-agent`. - Use the term "testing" — NOT "sandbox". - There is NO `describe-messages` API. Do not generate it. - `create-rcs-agent` does NOT accept brand asset parameters (no display name, no logo, no banner, no color). Brand assets are registration fields only. - `create-verified-destination-number` uses `--rcs-agent-id`, NOT `--origination-identity`. ### Step 1: Create an RCS Agent Use `create-rcs-agent`. This creates the agent resource only. Optional parameters: `--deletion-protection-enabled`, `--opt-out-list-name`, `--tags`. The response returns `RcsAgentId` and `RcsAgentArn` — save both. ### Step 2: Create and submit a testing registration This configures brand assets and submits for approval. It requires multiple API calls in sequence: a. `create-registration --registration-type TEST_RCS_LAUNCH_REGISTRATION` → returns `RegistrationId`. Save it. b. `create-registration-association --registration-id --resource-id ` → links the registration to the agent. c. Upload images as attachments (two calls): `create-registration-attachment --attachment-body fileb://` `create-registration-attachment --attachment-body fileb://` → each returns `RegistrationAttachmentId`. Save both. d. Set ALL required registration fields using `put-registration-field-value` with `--registration-id`, `--field-path`, and the appropriate value flag (`--text-value`, `--select-choices`, or `--registration-attachment-id`). Required fields (ALL must be set or registration will be DENIED): - `agentDetails.brandName` (text, 2-65 chars) - `agentDetails.serviceName` (text, 1-100 chars) - `agentDetails.senderDisplayName` (text, 1-40 chars) - `agentDetails.useCase` (select: OTP, TRANSACTIONAL, PROMOTIONAL, MULTI_USE) - `agentDetails.agentDescription` (text, 1-100 chars) - `agentDetails.logoImage` (attachment ID from step c, 224x224 PNG) - `agentDetails.bannerImage` (attachment ID from step c, 1440x448 PNG/JPEG) - `agentDetails.accentColor` (text, hex code e.g. #0066CC) - `agentDetails.privacyPolicyUrl` (text, valid URL) - `agentDetails.termsAndConditionsUrl` (text, valid URL) - `agentDetails.averageMonthlyRcsFrequency` (select: 10, 100, 1000+) - `agentDetails.monthlyRcsVolume` (text, 1-100000) - At least ONE contact method WITH its label: agentDetails.contactWebsite + agentDetails.contactWebsiteLabel, OR agentDetails.contactPhoneNumber + agentDetails.contactPhoneLabel, OR agentDetails.contactEmailAddress + agentDetails.contactEmailLabel e. Verify all fields: `describe-registration-field-values --registration-id ` Any field showing `DeniedReason: MISSING_REQUIRED_FIELD` must be set. f. Submit: `submit-registration-version --registration-id ` g. Poll status: `describe-registrations --registration-ids ` Wait for `RegistrationStatus: COMPLETE`. **Error recovery:** If registration is DENIED, you must: 1. `create-registration-version --registration-id ` (creates new draft) 2. Re-populate ALL fields from scratch (new versions do NOT inherit values) 3. Fix the issue noted in `DeniedReasons` 4. Re-submit ### Step 3: Add a test device **Prerequisite:** Step 2 must be COMPLETE and the agent's `TestingAgent.Status` must be `ACTIVE` (check with `describe-rcs-agents`). Then wait at least 120 seconds after the agent becomes ACTIVE. Use `create-verified-destination-number --destination-phone-number --rcs-agent-id `. The device status will be `PENDING`. The user must accept the RCS tester invitation on their physical device. Check status with `describe-verified-destination-numbers` — wait for `VERIFIED`. ### Step 4: Send a test RCS message **Prerequisite:** Step 3 device must be `VERIFIED`. Use `send-text-message --destination-phone-number --origination-identity --message-body "" --message-type TRANSACTIONAL`. Returns `MessageId`. ### Step 5: Verify delivery For testing: check the test device — the message appears from the branded RCS agent. For production monitoring: set up event destinations BEFORE sending messages using `create-event-destination` (SNS, CloudWatch Logs, or Firehose). Event destinations do not retroactively capture events for already-sent messages. CloudWatch metrics in the `AWS/SMSVoice` namespace provide aggregate stats. --- **Before generating commands, ask me for:** - Brand name, service name, and sender display name - Agent description (what the agent does, what messages users receive) - Use case type: OTP, TRANSACTIONAL, PROMOTIONAL, or MULTI_USE - Logo file path (224x224 PNG) and banner file path (1440x448 PNG/JPEG) - Brand accent color hex code (e.g. #0066CC) - Privacy policy URL and terms & conditions URL - One contact method with label: website URL, phone number, or email - Estimated monthly RCS volume and per-user message frequency - Test device phone number in E.164 format (e.g. +12065550100) ```