翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# RCS メッセージのテスト
RCS メッセージングを本番環境で起動する前に、テストエージェントを使用して統合をテストできます。テストエージェントは、AWS RCS エージェントのテスト登録を送信するときに作成される RCS for Business ID です。本番稼働環境と同じ完全な API アクセスを提供しますが、メッセージ配信は登録済みのテストデバイスのみに制限されます。テストにキャリアの承認は必要ありません。
この章では、テストデバイスを管理する方法や一般的な問題のトラブルシューティング方法など、テストエージェント自体に焦点を当てます。最初の AWS RCS エージェントを作成し、テストメッセージを送信するstep-by-stepについては、「」を参照してください[RCS の開始方法](rcs-getting-started.md)。AWS RCS エージェントの作成とテスト登録の送信の詳細については、「」を参照してください[RCS エージェントの管理](rcs-agents.md)。
**重要**
メッセージのテストには、標準の RCS レートで課金されます。テストエージェントは、統合を検証するためのテスト環境を提供しますが、テストデバイスへのメッセージ配信には、本番メッセージと同じ料金が発生します。
**Topics**
+ [テストエージェントとは](#rcs-testing-what-is)
+ [テストデバイスの追加](#rcs-testing-add-devices)
+ [テスターの招待フロー](#rcs-testing-tester-invitation)
+ [テストデバイスの表示](#rcs-testing-view-devices)
+ [テストメッセージの送信](#rcs-testing-send-messages)
+ [SMS フォールバックのテスト](#rcs-testing-sms-fallback)
+ [RCS テストのトラブルシューティング](#rcs-testing-troubleshooting)
## テストエージェントとは
テストエージェントは、AWS RCS エージェントのテスト登録を送信するときに AWS エンドユーザーメッセージングが作成する RCS for Business ID です。テストエージェントを使用すると、次のことができます。
+ キャリアの承認なしで登録済みのテストデバイスに RCS メッセージを送信する
+ `SendTextMessage` API を使用してテストメッセージを送信します。これは、本番環境で使用するのと同じ API です。
+ テストワークフローのプール、設定セット、オプトアウトリスト、キーワード、その他の AWS エンドユーザーメッセージング機能を設定する
+ 自動応答キーワードを使用してメッセージを送信して双方向メッセージングをテストする
+ 承認された SMS 電話番号の有無にかかわらず、SMS フォールバック動作をテストする
テストエージェントに登録したテストデバイスは、その AWS RCS Agent のすべての国で動作します。国ごとにテストデバイスを個別に登録する必要はありません。逆に、テストエージェントは、その国の国起動登録を送信したかどうかにかかわらず、任意の国のテストデバイスにメッセージを送信できます。
## テストデバイスの追加
テスト RCS メッセージを送信する前に、1 つ以上のテストデバイスを検証済み送信先番号として登録する必要があります。テストデバイスは、 AWS エンドユーザーメッセージングコンソールまたは `CreateVerifiedDestinationNumber` API を使用して追加できます。
------
#### [ Console ]
コンソールでは、テストデバイスは AWS RCS エージェント作成ワークフローの一部として追加されます。コンソールの手順についてはstep-by-step「」を参照してください[ステップ 2: テストデバイスを追加する](rcs-getting-started.md#rcs-getting-started-add-test-device)。
------
#### [ AWS CLI ]
コマンド`create-verified-destination-number`と `--rcs-agent-id`パラメータを使用して、AWS RCS エージェントのテストデバイスを登録します。
```
aws pinpoint-sms-voice-v2 create-verified-destination-number \
--destination-phone-number +12065550100 \
--rcs-agent-id rcs-a1b2c3d4
```
**注記**
`--origination-identity` パラメータは必須ではありません。を指定すると`--rcs-agent-id`、コマンドはそのエージェントに RCS テスト用の電話番号を登録します。を省略`--rcs-agent-id`して`--origination-identity`使用すると、コマンドは OTP SMS を送信して SMS 検証を行います。2 つのパラメータは相互に排他的です。
------
## テスターの招待フロー
テストデバイスを追加すると、 AWS End User Messaging は RBM Tester Management という RCS エージェントからテスターの招待を送信します。招待には、承諾または拒否するためのボタンが含まれています。120 秒の待機要件や iOS 固有の動作など、テスターの招待フローの詳細については、「」を参照してください[ステップ 2: テストデバイスを追加する](rcs-getting-started.md#rcs-getting-started-add-test-device)。
## テストデバイスの表示
AWS RCS エージェントに登録されているテストデバイスは、 AWS エンドユーザーメッセージングコンソールまたは `DescribeVerifiedDestinationNumbers` API を使用して表示できます。
------
#### [ Console ]
コンソールで登録済みのテストデバイスを表示するには、AWS RCS エージェントの詳細ページに移動し、**テスト**タブを選択します。タブには、検証ステータスや電話番号など、エージェントに関連付けられているすべての検証済み送信先番号が表示されます。
------
#### [ AWS CLI ]
`describe-verified-destination-numbers` コマンドを使用して、AWS RCS エージェントのテストデバイスを一覧表示します。で `--filters`パラメータを使用して`rcs-agent-id`、RCS テストデバイスのみを表示します。
```
aws pinpoint-sms-voice-v2 describe-verified-destination-numbers \
--filters Name=rcs-agent-id,Values=rcs-a1b2c3d4
```
------
テストエージェントに登録したテストデバイスは、その AWS RCS エージェントに対してグローバルに動作します。1 つの AWS リージョンに登録されたテストデバイスは、AWS RCS Agent が利用可能な任意の AWS リージョンから送信されたテストメッセージを受信できます。
## テストメッセージの送信
テストデバイスがテスターの招待を承諾したら、そのデバイスに RCS メッセージを送信できます。テストメッセージは、 AWS エンドユーザーメッセージングコンソールまたは `SendTextMessage` API を使用して送信できます。
------
#### [ Console ]
**コンソールを使用してテストメッセージを送信するには**
1. AWS エンドユーザーメッセージングコンソールを開きます。
1. ナビゲーションペインの設定で**、RCS** **エージェント**を選択します。
1. テストする AWS RCS エージェントを選択します。
1. **テスト**タブを選択します。
1. **テストメッセージの送信**セクションで、リストから検証済みのテストデバイスを選択します。
1. メッセージテキストを入力します。
1. **[テキストメッセージを送信]** を選択します。
------
#### [ 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 testing!"
```
------
## SMS フォールバックのテスト
SMS フォールバック動作をテストして、RCS 配信が不可能な場合にメッセージが SMS 経由で配信されることを確認できます。承認済みの SMS 番号やend-to-endフローを使用しないテストなど、SMS フォールバックのテストに関する詳細な手順については、「」を参照してください[SMS フォールバックのテスト](rcs-sms-fallback.md#rcs-sms-fallback-testing)。
## RCS テストのトラブルシューティング
以下のセクションでは、RCS メッセージをテストするときに発生する可能性がある一般的な問題とその解決方法について説明します。
### テストデバイスが RCS メッセージを受信していない
テストデバイスが RCS メッセージを受信していない場合は、以下を確認してください。
+ テストデバイスがテスターの招待を承諾していることを確認します。`rcs-agent-id` フィルターで `DescribeVerifiedDestinationNumbers` API を使用して、デバイスの検証ステータスを確認します。
+ テストデバイスで RCS が有効になっていることを確認します。Android では、RCS または Chat 機能のメッセージングアプリ設定を確認します。iPhone では、RCS に iOS 18 以降が必要です。
+ テストデバイスにアクティブなデータ接続があることを確認します。RCS メッセージは、SMS チャネルではなくデータ経由で配信されます。
+ E.164 形式で正しい電話番号に送信していることを確認します。
### RCS の代わりに SMS として配信されるメッセージ
テストメッセージが RCS ではなく SMS として配信される場合は、以下を確認してください。
+ AWS RCS エージェント ARN または AWS RCS エージェントを含むプールを発信元 ID として使用してメッセージを送信していることを確認します。SMS 電話番号のみを指定した場合、メッセージは SMS 経由で送信されます。
+ テストデバイスがテスターの招待を受け入れ、正しい AWS RCS エージェントの検証済み送信先番号として登録されていることを確認します。
+ 配信イベントをチェックして、メッセージが最初に RCS 経由で試行されて SMS にフォールバックされたかどうか、または SMS 経由で直接送信されたかどうかを判断します。
### テスターの招待が受信されない
テストデバイスがテスターの招待を受信しない場合は、以下を確認してください。
+ テスターの招待は、テストデバイスを追加してから到着するまでに最大 20 分かかる場合があります。20 分経っても招待が届かない場合は、テストデバイスを削除して再度追加します。
+ 電話番号が正しい E.164 形式であり、有効な携帯電話番号であることを確認します。
+ テストデバイスにアクティブなデータ接続があり、RCS が有効になっていることを確認します。
### iOS: 不明な送信者のテスターの招待
iOS デバイス (iOS 18 以降の iPhone) では、RBM Tester Management からのテスターの招待が Messages アプリの **Unknown Senders** フォルダにフィルタリングされる場合があります。これは、不明な連絡先からのメッセージのデフォルトの iOS 動作です。
招待を見つけるには:
**iOS でテスターの招待を見つけるには**
1. iPhone で Messages アプリを開きます。
1. 左上隅**のフィルター**をタップする (またはメッセージリストから右にスワイプする）。
1. **不明な送信者**をタップします。
1. RBM Tester Management メッセージを探し、**Make me a tester** to accept the invitation をタップします。