本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 測試 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 使用者傳訊在提交 AWS RCS 代理程式測試註冊時建立的 RCS for Business ID。測試代理程式可讓您：
+ 在未經電信業者核准的情況下，將 RCS 訊息傳送至已註冊的測試裝置
+ 使用 `SendTextMessage` API 傳送測試訊息，即您在生產中使用的相同 API
+ 為您的測試工作流程設定集區、組態集、選擇退出清單、關鍵字和其他 AWS 最終使用者傳訊功能
+ 使用自動回應關鍵字傳送訊息來測試雙向傳訊
+ 測試 SMS 備用行為，無論是否具有已核准的 SMS 電話號碼
您註冊測試代理程式的測試裝置可跨該 AWS RCS 代理程式的所有國家/地區運作。您不需要為每個國家分別註冊測試裝置。相反地，測試代理程式可以傳送訊息到任何國家/地區的測試裝置，無論您是否已提交該國家/地區的國家/地區啟動註冊。
## 新增測試裝置
您必須先將一或多個測試裝置註冊為已驗證的目的地號碼，才能傳送測試 RCS 訊息。您可以使用 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 Agent 註冊測試裝置：
```
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 驗證。這兩個參數是互斥的。
------
## 測試人員邀請流程
新增測試裝置後， AWS 最終使用者傳訊會從稱為 RBM Tester Management 的 RCS 代理程式傳送測試者邀請。邀請包含要接受或拒絕的按鈕。如需測試人員邀請流程的詳細資訊，包括 120 秒的等待要求和 iOS 特定行為，請參閱 [步驟 2：新增測試裝置](rcs-getting-started.md#rcs-getting-started-add-test-device)。
## 檢視測試裝置
您可以使用 AWS 最終使用者傳訊主控台或 `DescribeVerifiedDestinationNumbers` API 檢視為 AWS RCS 代理程式註冊的測試裝置。
------
#### [ 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 代理程式的全域工作。在某個 AWS 區域中註冊的測試裝置可以接收來自任何可用 AWS RCS 代理 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 做為起始身分：
```
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 傳遞。如需測試簡訊後援的完整說明，包括測試沒有核准的簡訊號碼和完整的end-to-end流程，請參閱 [測試 SMS 備用](rcs-sms-fallback.md#rcs-sms-fallback-testing)。
## 故障診斷 RCS 測試
下列各節說明測試 RCS 訊息時可能遇到的常見問題，以及如何解決這些問題。
### 測試裝置未接收 RCS 訊息
如果您的測試裝置未接收 RCS 訊息，請檢查下列項目：
+ 確認測試裝置已接受測試人員邀請。使用 `DescribeVerifiedDestinationNumbers` API 搭配`rcs-agent-id`篩選條件來檢查裝置的驗證狀態。
+ 確認測試裝置已啟用 RCS。在 Android 上，檢查 RCS 或聊天功能的訊息應用程式設定。在 iPhone 上，RDS 需要 iOS 18 或更新版本。
+ 確認測試裝置具有作用中的資料連線。RCS 訊息會透過資料傳送，而非 SMS 通道。
+ 確認您以 E.164 格式傳送至正確的電話號碼。
### 以 SMS 而非 RCS 傳送的訊息
如果您的測試訊息是以 SMS 而非 RCS 傳送，請檢查下列項目：
+ 確認您正在使用 AWS RCS 代理程式 ARN 或包含 AWS RCS 代理程式做為起始身分的集區傳送訊息。如果您只指定簡訊電話號碼，訊息會透過簡訊傳送。
+ 確認測試裝置已接受測試人員邀請，並已註冊為正確 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 上開啟訊息應用程式。
1. 點選左上角**的篩選條件** （或從訊息清單向右滑動）。
1. 點選**不明寄件者**。
1. 尋找 RBM Tester 管理訊息，然後點選**讓我成為測試人員**以接受邀請。