View a markdown version of this page

測試 RCS 訊息 - AWS 最終使用者傳訊簡訊
什麼是測試代理程式？新增測試裝置測試人員邀請流程檢視測試裝置傳送測試訊息測試 SMS 備用故障診斷 RCS 測試

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

測試 RCS 訊息

在生產環境中啟動 RCS 訊息之前，您可以使用測試代理程式測試整合。測試代理程式是在您提交 AWS RCS 代理程式測試註冊時建立的 RCS for Business ID。它提供與生產相同的完整 API 存取，但僅將訊息傳遞限制為已註冊的測試裝置。測試不需要電信業者核准。

本章著重於測試代理程式本身，包括如何管理測試裝置，以及如何疑難排解常見問題。如需建立第一個 AWS RCS 代理程式並傳送測試訊息的step-by-step演練，請參閱 RCS 入門。如需建立 AWS RCS 代理程式和提交測試註冊的詳細資訊，請參閱 管理 RCS 代理程式。

重要

測試訊息會以標準 RCS 費率收費。測試代理程式提供測試環境來驗證您的整合，但傳遞至測試裝置的訊息會產生與生產訊息相同的費用。

什麼是測試代理程式？

測試代理程式是 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：新增測試裝置。

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：新增測試裝置。

檢視測試裝置

您可以使用 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 最終使用者傳訊主控台。

  2. 在導覽窗格中的組態下，選擇 RCS 代理程式。

  3. 選擇您要測試的 AWS RCS 代理程式。

  4. 選擇測試索引標籤。

  5. 在傳送測試訊息區段中，從清單中選擇已驗證的測試裝置。

  6. 輸入您的訊息文字。

  7. 選擇傳送測試訊息。

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 測試

下列各節說明測試 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 上開啟訊息應用程式。

  2. 點選左上角的篩選條件 （或從訊息清單向右滑動）。

  3. 點選不明寄件者。

  4. 尋找 RBM Tester 管理訊息，然後點選讓我成為測試人員以接受邀請。