View a markdown version of this page

從主控台傳送豐富的 RCS 訊息 - AWS 最終使用者傳訊簡訊
先決條件傳送豐富的 RCS 訊息輸入驗證相關資源

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

從主控台傳送豐富的 RCS 訊息

AWS 最終使用者傳訊主控台提供視覺化訊息編寫器，您可以用來建置和傳送豐富的 RCS 訊息，而無需撰寫程式碼。編寫器會直接映射到 SendRcsMessage API，並支援所有內容類型：文字訊息、檔案訊息、多張卡片和輪跳功能。您可以將互動式建議連接到任何訊息類型、設定time-to-live(TTL) 設定，以及為裝置不支援 RCS 的收件人設定 SMS 或 MMS 備用。

您可以從 RCS 測試界面的傳出測試訊息索引標籤編寫和傳送豐富的訊息。訊息會傳送給已驗證的 RBM 測試人員，以便在將 SendRcsMessage API 整合到您的應用程式之前驗證轉譯和交付。

當您設定訊息時，即時電話預覽會顯示訊息在收件人裝置上呈現的方式。您也可以複製同等 JSON 承載或 AWS CLI 命令，以在應用程式程式碼中使用相同的訊息結構。

如需訊息類型及其 API 結構的詳細資訊，請參閱 傳送豐富的 RCS 訊息。如需建議類型和行為的詳細資訊，請參閱 設定 RCS 建議。

先決條件

從主控台傳送豐富的 RCS 訊息之前，請確認下列事項：

  • 您的 RCS 代理程式處於測試或作用中狀態。

  • 您至少有一個已驗證的 RBM Tester 電話號碼與您的客服人員相關聯。如需設定說明，請參閱 測試 RCS 訊息。

  • 如果您打算從 Amazon S3 傳送媒體檔案，S3 儲存貯體必須具有授予sms-voice.amazonaws.com讀取存取權的儲存貯體政策。如需詳細資訊，請參閱傳送 RCS 檔案訊息。

傳送豐富的 RCS 訊息

使用下列程序，從 AWS 最終使用者傳訊主控台編寫和傳送豐富的 RCS 訊息。

  1. 在 開啟 AWS 最終使用者傳訊主控台https://console.aws.amazon.com/sms-voice/。

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

  3. 選擇您要用作起始身分的代理程式。代理程式狀態必須為測試或作用中。

  4. 選擇測試索引標籤。

  5. 在 RCS 測試界面中，選擇傳出測試訊息索引標籤。

  6. 在傳送測試 RCS 訊息區段中，針對 Select RBM Tester，選擇已驗證的 RBM Tester 電話號碼。

  7. （選用） 針對組態設定，選擇可追蹤訊息事件的組態設定。

  8. 針對選取 API，選擇 SendRcsMessage。

  9. 針對選取訊息格式，選擇您要傳送的訊息類型：

    • 文字：輸入訊息內文 （最多 3，072 個字元）。

    • 檔案：針對媒體來源，選擇 S3 儲存貯體或公有 URL，然後輸入要傳送之檔案的 S3 URI （或 HTTPS URL)。選擇瀏覽 S3 從儲存貯體中選取檔案，或在新的瀏覽器索引標籤中檢視以開啟參考的檔案。 檔案大小上限為 100 MB。或者，提供影片或 PDF 檔案的縮圖 URL。

    • Rich card：設定下列卡片欄位。至少需要其中一個標題、描述或媒體。

      • 卡片方向：選擇 VERTICAL或 HORIZONTAL。

      • 卡片標題：輸入標題 （最多 200 個字元）。

      • 卡片描述：輸入描述 （最多 2，000 個字元）。

      • 媒體 URL：針對媒體來源，選擇 S3 儲存貯體或公有 URL，然後輸入 S3 URI （或 HTTPS URL)。選擇瀏覽 S3 以選取檔案，或選擇檢視以在新的瀏覽器索引標籤中開啟檔案。 檔案大小上限為 100 MB。

      • （選用） 媒體縮圖 URL：完整媒體載入之前顯示的預覽影像。

      • （僅限 HoRIZONTAL 方向） 縮圖對齊：選擇 LEFT或 RIGHT以定位縮圖影像。

      • 卡片建議：新增最多 4 個在卡片界限內轉譯為按鈕的建議。如需建議類型，請參閱 設定 RCS 建議。

    • 浮動切換：設定下列項目：

      • 卡片寬度：選擇 SMALL或 MEDIUM。

      • 媒體高度 （所有卡片）：選擇 SHORT或 MEDIUM。輪跳功能中的所有卡片都使用相同的媒體高度。

      • 卡片：新增 2 到 10 張卡片。每張卡片都包含卡片標題、卡片描述、媒體 URL (S3 儲存貯體或公有 URL，上限為 100 MB)，以及最多 4 個卡片建議。每張卡片至少需要一個標題、描述或媒體。

    • JSON：直接貼上原始 RcsMessageContent JSON 承載。選擇格式化 JSON 以格式化承載。主控台會驗證結構並即時更新電話預覽。

  10. （選用） 使用 S3 瀏覽器設定媒體檔案：

    1. 選擇 Browse S3 (瀏覽 S3)。

    2. 從下拉式清單中選取儲存貯體。

    3. 瀏覽前綴 （資料夾） 以尋找您的檔案。

    4. 選取 檔案。URL 欄位會自動填入。

    注意

    S3 儲存貯體必須具有儲存貯體政策，以授予物件的sms-voice.amazonaws.com讀取存取權。如需所需政策，請參閱 傳送 RCS 檔案訊息。

  11. （選用） 新增訊息層級建議。在建議區段中：

    1. 選擇新增建議。

    2. 對於建議類型，請選擇回覆、開啟 URL、撥打電話、顯示位置、請求位置或行事曆事件。

    3. 輸入所選類型的必要欄位。所有建議類型都需要Text值 （最多 25 個字元） 和 PostbackData（最多 2，048 個字元）。

    4. 重複 以新增最多 11 個訊息層級建議。

    訊息層級建議會轉譯為整個訊息下方的晶片清單。您可以將訊息層級建議連接到任何內容類型 （文字、檔案、豐富卡或浮動切換）。如需詳細資訊，請參閱設定 RCS 建議。

  12. （選用） time-to-live(TTL) 設定。展開進階選項，然後在存留時間 （秒） 欄位中輸入值。有效值的範圍為 1 到 172，800 秒 (48 小時）。我們建議最小值為 10 秒。

    如果訊息未在 TTL 過期之前傳遞，服務會觸發 TTL 過期事件。如果您已設定後援，則後援訊息會在當時傳送。

    進階選項區段也包含最高價格 (USD)、乾式執行、訊息意見回饋、保護組態和內容 （選用金鑰值中繼資料）。

  13. （選用） 設定 SMS 或 MMS 備用。展開備用組態區段：

    1. 針對備用頻道，選擇 SMS 或 MMS。

    2. 針對備用訊息內文，輸入訊息文字 （最多 1，600 個字元）。選取後援頻道時，需要訊息內文。

    3. 對於 MMS，您也可以提供一或多個媒體 URLs。

    4. 針對來源身分，輸入用於備用簡訊或 MMS 訊息的電話號碼或寄件者 ID。從 RCS 代理程式傳送時，這是必要的。

    當訊息無法透過 RCS 傳遞時 （例如，當收件人的裝置不支援 RCS 或 TTL 過期時），就會觸發後援。如需詳細資訊，請參閱傳送豐富的 RCS 訊息。

  14. （選用） 在進階選項中，啟用乾式執行來驗證訊息結構而不傳送。這不會產生費用，也不會將訊息傳遞給收件人。

  15. 檢閱編寫器右側的電話預覽。預覽會即時更新並顯示：

    • 內容轉譯 （文字、媒體、卡片配置、浮動切換捲動）

    • 訊息下方的建議晶片

    • 卡片內的卡片層級按鈕

    注意

    預覽會近似 Android 轉譯。iOS 或其他 RCS 用戶端上的顯示可能會有所不同。預覽不會模擬建議選擇行為。

  16. 選擇傳送測試訊息，將訊息傳送至選取的 RBM 測試人員，或使用下列其中一個選項：

    • 複製 JSON：將訊息 JSON 複製到剪貼簿。選擇 RcsMessageContent 僅複製內容部分，或選擇 Full API 請求來複製完整的SendRcsMessage請求內文。

    • 複製 CLI 命令：複製對等aws pinpoint-sms-voice-v2 send-rcs-message命令。

輸入驗證

主控台會在您設定訊息時執行即時驗證。驗證錯誤會在受影響的欄位旁內嵌顯示。下表摘要說明驗證規則。

主控台驗證規則
欄位 規則
電話號碼 必須是 E.164 格式
媒體 URL 必須以 https://或 開頭 s3://
媒體檔案大小 最大 100 MB
建議文字 最多 25 個字元
後退資料 最多 2，048 個字元
卡片標題 最多 200 個字元
卡片描述 最多 2，000 個字元
浮動切換卡 最小值 2，最大值 10
卡片層級建議 每張卡最多 4 個
訊息層級建議 最多 11 個
文字訊息內文 最多 3，072 個字元
TTL 1 到 172，800 秒
備用訊息內文 最多 1，600 個字元