本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
傳送豐富的 RCS 訊息
透過AWS最終使用者傳訊中的 SendRcsMessage API 動作，您可以透過 RCS (Rich Communication Services) 傳送豐富的互動式內容給收件人。豐富的 RCS 訊息超越純文字，包括豐富的卡片、輪跳功能、媒體檔案，以及收件人選擇採取動作的建議。這些互動式元素將單向通知轉換為雙向對話體驗，例如讓收件人確認預約、瀏覽產品目錄，或共用其位置而不離開對話。
當您需要交付視覺效果豐富的互動式內容SendRcsMessage時，請使用 ，例如具有影像和動作按鈕的產品卡、具有行事曆建議的預約確認、檔案附件或收件人捲動的多項目輪跳功能。每個SendRcsMessage請求都包含任何文字內容的個別文字內文，並且可以為裝置不支援 RCS 的收件人包含選用的 SMS 或 MMS 備用。
對於不需要豐富格式的純文字訊息，請改用 SendTextMessage API 動作。 只SendTextMessage接受文字內容，讓請求更簡單，而且它適用於根據收件人功能在 RCS 和 SMS 之間自動選取的訊息集區。如需詳細資訊，請參閱傳送 RCS 訊息。
重要
您可以在支援 RCS 的所有國家SendRcsMessage/地區使用 RCS 訊息。如需目前的清單，請參閱 RCS 支援的國家/地區。
主題
先決條件
傳送豐富的 RCS 訊息之前，請先完成 中的 RCS 設定步驟RCS 入門。除了處於作用中狀態的已註冊 AWS RCS 代理程式之外，請確認下列事項：
-
若要在傳送給生產收件人之前驗證豐富的內容，請將已註冊的測試裝置新增至您的測試代理程式，並向其傳送測試訊息。如需詳細資訊，請參閱測試 RCS 訊息。
-
設定事件目的地 (Amazon SNS 主題或 Amazon Data Firehose 交付串流） 以接收交付狀態事件。如果您的訊息包含互動式元素，例如建議，則需要事件目的地，因為收件人選擇會以後退事件的形式交付到您的應用程式。如需詳細資訊，請參閱AWS 最終使用者傳訊簡訊中的事件目的地。
-
如果您設定 SMS 或 MMS 備用，並傳送具有 SMS 提取風險的目的地，請將保護組態建立關聯，以將選擇退出和國家/地區規則套用至備用訊息。如需詳細資訊，請參閱AWS 最終使用者簡訊簡訊中的詐騙防護。
在 SendTextMessage 和 SendRcsMessage 之間進行選擇
這兩個 API 動作都可以透過 RCS 傳遞訊息，但其用途不同。 會SendTextMessage假設每則訊息都以 SMS 形式傳遞，也可以透過 RCS 傳遞，進而提供更簡單的請求合約。 會SendRcsMessage假設豐富的 RCS 內容，並新增SendTextMessage沒有的功能，包括媒體和結構化內容類型、具有time-to-live(TTL) 的訊息過期，以及每則訊息 SMS 或 MMS 後援。
| 功能 | SendTextMessage | SendRcsMessage |
|---|---|---|
| 訊息內容 | 僅限純文字 | 文字、檔案、多張卡片和輪跳功能，每個都有選用的建議 |
| 交付管道 | RCS 或 SMS | RCS，搭配選用的 SMS 或 MMS 備用 |
| 頻道選擇 | 集區會依收件人功能自動選取 RCS 或 SMS | 首先是 RCS，然後是您已設定的 SMS 或 MMS 備用 |
| Fallback (備用) | 自動、以集區為基礎的 | 明確，每則訊息 |
| 起始身分 | 集區、電話號碼、寄件者 ID 或 AWS RCS 代理程式 | 集區或 AWS RCS 代理程式 |
| 訊息過期 (TTL) | 否 | 是 |
| 請求合約 | 更簡單。與 SMS 和 MMS 傳送相同的 API | 具有個別文字內文和內容類型的專用 RCS API |
SendTextMessage 選擇純文字通知、您希望以集區為基礎的自動頻道選擇，或當您以最少的程式碼變更遷移現有的簡訊工作流程時。SendRcsMessage 當您需要豐富的卡片、輪跳功能、媒體檔案或建議時、需要定義每個訊息的後援時，或需要 TTL 型過期處理時間敏感的內容時，請選擇此選項。
內容類型
RcsMessageContent 參數包含只有一種內容類型的Content物件，以及選用的訊息層級Suggestions清單。您無法在單一請求中合併多個內容類型。
| 內容類型 | 說明 | 其他資訊 |
|---|---|---|
| TextMessage | 最多 3，072 個字元的文字內文，以及選用的建議。與 SMS 訊息不同，RDS 文字訊息可以包含建議，並以單一訊息傳送，而不是分割為區段。 | 傳送 RCS 文字訊息 |
| FileMessage | HTTPS 或 Amazon S3 URL 參考的單一媒體檔案 （影像、影片、音訊或 PDF)。 | 傳送 RCS 檔案訊息 |
| RichCard | 具有選用媒體、標題、描述和最多 4 個建議的結構化卡片。 | 傳送 RCS 豐富的卡片 |
| 浮動切換 | 一組可捲動的 2 到 10 張卡片，每張都有自己的媒體、文字和建議。 | 傳送 RCS 輪跳功能 |
建議
建議是互動式晶片，收件人可以選擇採取動作。您可以為任何內容類型新增建議：訊息層級建議適用於整個訊息 （最多 11 個），而卡片層級建議適用於個別的豐富卡或浮動切換卡 （最多 4 個）。AWS最終使用者傳訊支援六個建議類型，包括回覆、連結和動作，例如撥打電話號碼或共用位置。如需建議類型的完整清單、其參數，以及如何接收建議點選，請參閱 設定 RCS 建議。
SendRcsMessage 請求概觀
SendRcsMessage 請求使用下列金鑰參數。
| 參數 | 必要 | 描述 |
|---|---|---|
DestinationPhoneNumber |
是 | E.164 格式的收件人電話號碼，例如 +12065550100。 |
OriginationIdentity |
是 | 要從中傳送的集區或 AWS RCS 代理程式的 ID 或 ARN。代理程式必須處於作用中狀態。 |
RcsMessageContent |
否 | 訊息內容。包含具有 TextMessage、RichCard、 FileMessage或 的Content物件Carousel，以及選用的頂層Suggestions清單。 |
FallbackConfiguration |
否 | 如果 RCS 交付未成功，要傳送的 SMS 或 MMS 訊息。包括必要的 Channel(SMS 或 MMS)MessageBody、MS MediaUrls的選用 ，以及OriginationIdentity電話號碼或寄件者 ID 的 。 |
TimeToLive |
否 | 如果訊息未傳遞，訊息過期之前的秒數。最小值為 1 秒，最大值為 172，800 秒 (48 小時）。建議值為 10 秒以上。 |
MessageFeedbackEnabled |
否 | 設定為 true 以啟用訊息的訊息意見回饋。當收件人收到訊息時，請呼叫 PutMessageFeedback操作來更新訊息狀態。 |
成功回應會傳回您用來關聯交付狀態事件MessageId的 。
注意
的後援SendRcsMessage是透過 為每個訊息設定FallbackConfiguration。如需完整的備用行為，請參閱 設定每則訊息簡訊或 MMS 後援。
訊息大小和計數限制
| 限制 | Value |
|---|---|
| 文字訊息內文 | 3，072 個字元 |
| 豐富的卡片標題 | 200 個字元 |
| 豐富的卡片描述 | 2,000 個字元 |
| 媒體檔案大小 | 100 MB |
| 媒體 URL 長度 | 2,000 個字元 |
| 每則訊息的建議 | 11 |
| 每張卡片的建議 | 4 |
| 建議顯示文字 | 25 個字元 |
| 後退資料 | 2,048 個字元 |
| 浮動切換卡 | 2 到 10 張卡片 |
| Time-to-live | 1 秒到 172，800 秒 (48 小時） |
如需所有內容類型的 RCS 限制，請參閱 訊息限制。
交付事件和收件人動作
AWS最終使用者傳訊會產生報告訊息交付狀態和收件人動作的事件，包括交付、讀取、失敗、過期和後退事件。當收件人選擇建議並包含 PostbackData值時，會產生後退事件。將這些事件路由到 Amazon SNS 主題、Amazon Data Firehose 交付串流或 Amazon CloudWatch Logs。如需詳細資訊，請參閱RCS 訊息事件。
最佳實務
將豐富的 RCS 訊息設計為對話式互動體驗。TimeToLive 為一次性密碼等時間敏感內容設定 、為必須到達收件人的訊息設定 SMS 或 MMS 後援，即使其裝置不支援 RCS、讓建議標籤保持簡短 （限制為 25 個字元），並在 中包含結構化識別符，PostbackData讓您的應用程式可以路由回應，而無需額外查詢。如需詳細指引，請參閱 RCS 最佳實務。
