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

# 從主控台傳送豐富的 RCS 訊息
<a name="rcs-console-rich-messaging"></a>

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

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

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

如需訊息類型及其 API 結構的詳細資訊，請參閱 [傳送豐富的 RCS 訊息](rcs-rich-messaging.md)。如需建議類型和行為的詳細資訊，請參閱 [設定 RCS 建議](rcs-suggestions.md)。

## 先決條件
<a name="rcs-console-rich-messaging-prereqs"></a>

從主控台傳送豐富的 RCS 訊息之前，請確認下列事項：
+ 您的 RCS 代理程式處於**測試**或**作用中**狀態。
+ 您至少有一個已驗證的 RBM Tester 電話號碼與您的客服人員相關聯。如需設定說明，請參閱 [測試 RCS 訊息](rcs-testing.md)。
+ 如果您計劃從 Amazon S3 傳送媒體檔案，S3 儲存貯體必須具有授予`sms-voice.amazonaws.com`讀取存取權的儲存貯體政策。如需詳細資訊，請參閱[傳送 RCS 檔案訊息](rcs-file-messages.md)。

## 傳送豐富的 RCS 訊息
<a name="rcs-console-rich-messaging-procedure"></a>

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

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

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

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

1. 選擇**測試**索引標籤。

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

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

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

1. 針對**選取 API**，選擇 **SendRcsMessage**。

1. <a name="rcs-console-rich-messaging-content-type"></a>針對**選取訊息格式**，選擇您要傳送的訊息類型：
   + **文字**：輸入訊息內文 （最多 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 建議](rcs-suggestions.md)。
   + **浮動切換**：設定下列項目：
     + **卡片寬度**：選擇 `SMALL`或 `MEDIUM`。
     + **媒體高度 （所有卡片）**：選擇 `SHORT`或 `MEDIUM`。輪跳功能中的所有卡片都使用相同的媒體高度。
     + **卡片**：新增 2 到 10 張卡片。每張卡片都包含卡片標題、卡片描述、媒體 URL (S3 儲存貯體或公有 URL，上限為 100 MB)，以及最多 4 個卡片建議。每張卡片至少需要一個標題、描述或媒體。
   + **JSON**：直接貼上原始 `RcsMessageContent` JSON 承載。選擇**格式化 JSON** 以格式化承載。主控台會驗證結構並即時更新電話預覽。

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

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

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

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

   1. 選取 檔案。URL 欄位會自動填入。
**注意**  
S3 儲存貯體必須具有儲存貯體政策，以授予物件的`sms-voice.amazonaws.com`讀取存取權。如需必要政策，請參閱 [傳送 RCS 檔案訊息](rcs-file-messages.md)。

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

   1. 選擇**新增建議**。

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

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

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

   訊息層級建議會呈現為整個訊息下方的晶片清單。您可以將訊息層級建議附加到任何內容類型 （文字、檔案、豐富卡或浮動切換）。如需詳細資訊，請參閱[設定 RCS 建議](rcs-suggestions.md)。

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

   如果訊息未在 TTL 過期之前傳遞，服務會觸發 TTL 過期事件。如果您設定了備用，則會在那時傳送備用訊息。

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

1. （選用） 設定 SMS 或 MMS 後援。展開**備用組態**區段：

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

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

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

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

   當訊息無法透過 RCS 傳遞時 （例如，當收件人的裝置不支援 RCS 或 TTL 過期時），就會觸發備用。如需詳細資訊，請參閱[傳送豐富的 RCS 訊息](rcs-rich-messaging.md)。

1. （選用） 在**進階選項**中，啟用**試轉**以驗證訊息結構而不傳送。這不會產生費用，也不會將訊息傳遞給收件人。

1. 檢閱編寫器右側的電話預覽。預覽會即時更新並顯示：
   + 內容轉譯 （文字、媒體、卡片配置、浮動切換捲動）
   + 訊息下方的建議晶片
   + 卡片內的卡片層級按鈕
**注意**  
預覽會近似 Android 轉譯。iOS 或其他 RCS 用戶端上的顯示可能會有所不同。預覽不會模擬建議選擇行為。

1. 選擇**傳送測試訊息**，將訊息傳送至選取的 RBM 測試人員，或使用下列其中一個選項：
   + **複製 JSON**：將訊息 JSON 複製到剪貼簿。選擇 **RcsMessageContent** 僅複製內容部分，或選擇 **Full API 請求**來複製完整的`SendRcsMessage`請求內文。
   + **複製 CLI 命令**：複製同等`aws pinpoint-sms-voice-v2 send-rcs-message`命令。

## 輸入驗證
<a name="rcs-console-rich-messaging-validation"></a>

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


**主控台驗證規則**  

| 欄位 | 規則 | 
| --- | --- | 
| 電話號碼 | 必須是 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 個字元 | 

## 相關資源
<a name="rcs-console-rich-messaging-related"></a>
+ [傳送豐富的 RCS 訊息](rcs-rich-messaging.md)
+ [設定 RCS 建議](rcs-suggestions.md)
+ [測試 RCS 訊息](rcs-testing.md)
+ [傳送 RCS 檔案訊息](rcs-file-messages.md)