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

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

透過AWS最終使用者傳訊中的 `SendRcsMessage` API 動作，您可以透過 RCS (Rich Communication Services) 傳送豐富的互動式內容給收件人。豐富的 RCS 訊息超越純文字，包括豐富的卡片、輪跳功能、媒體檔案，以及收件人選擇採取動作的建議。這些互動式元素將單向通知轉換為雙向對話體驗，例如讓收件人確認預約、瀏覽產品目錄，或共用其位置而不離開對話。

當您需要交付視覺效果豐富的互動式內容`SendRcsMessage`時，請使用 ，例如具有影像和動作按鈕的產品卡、具有行事曆建議的預約確認、檔案附件或收件人捲動的多項目輪跳功能。每個`SendRcsMessage`請求都包含任何文字內容的個別文字內文，並且可以為裝置不支援 RCS 的收件人包含選用的 SMS 或 MMS 備用。

對於不需要豐富格式的純文字訊息，請改用 `SendTextMessage` API 動作。 只`SendTextMessage`接受文字內容，讓請求更簡單，而且它適用於根據收件人功能在 RCS 和 SMS 之間自動選取的訊息集區。如需詳細資訊，請參閱[傳送 RCS 訊息](rcs-send-message.md)。

**重要**  
您可以在支援 RCS 的所有國家`SendRcsMessage`/地區使用 RCS 訊息。如需目前的清單，請參閱 [RCS 支援的國家/地區](rcs-supported-countries.md)。

**Topics**
+ [先決條件](#rcs-rich-messaging-prerequisites)
+ [在 SendTextMessage 和 SendRcsMessage 之間進行選擇](#rcs-rich-messaging-choosing)
+ [內容類型](#rcs-rich-messaging-content-types)
+ [建議](#rcs-rich-messaging-suggestions)
+ [SendRcsMessage 請求概觀](#rcs-rich-messaging-api)
+ [訊息大小和計數限制](#rcs-rich-messaging-limits)
+ [交付事件和收件人動作](#rcs-rich-messaging-events)
+ [最佳實務](#rcs-rich-messaging-best-practices)
+ [文字訊息](rcs-text-messages.md)
+ [檔案訊息](rcs-file-messages.md)
+ [多張卡片](rcs-rich-cards.md)
+ [輪跳功能](rcs-carousels.md)
+ [建議](rcs-suggestions.md)
+ [訊息過期](rcs-message-expiration.md)
+ [每則訊息後援](rcs-fallback-per-message.md)
+ [訊息事件](rcs-events.md)
+ [傳入媒體](rcs-inbound-media.md)
+ [最佳實務](rcs-best-practices.md)
+ [主控台豐富的訊息](rcs-console-rich-messaging.md)

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

傳送豐富的 RCS 訊息之前，請先完成 中的 RCS 設定步驟[RCS 入門](rcs-getting-started.md)。除了處於**作用中**狀態的已註冊 AWS RCS 代理程式之外，請確認下列事項：
+ 若要在傳送給生產收件人之前驗證豐富的內容，請將已註冊的測試裝置新增至您的測試代理程式，並向其傳送測試訊息。如需詳細資訊，請參閱[測試 RCS 訊息](rcs-testing.md)。
+ 設定事件目的地 (Amazon SNS 主題或 Amazon Data Firehose 交付串流） 以接收交付狀態事件。如果您的訊息包含互動式元素，例如建議，則需要事件目的地，因為收件人選擇會以後退事件的形式交付到您的應用程式。如需詳細資訊，請參閱[AWS 最終使用者傳訊簡訊中的事件目的地](configuration-sets-event-destinations.md)。
+ 如果您設定 SMS 或 MMS 備用，並傳送具有 SMS 提取風險的目的地，請將保護組態建立關聯，以將選擇退出和國家/地區規則套用至備用訊息。如需詳細資訊，請參閱[AWS 最終使用者簡訊簡訊中的詐騙防護](protect.md)。

## 在 SendTextMessage 和 SendRcsMessage 之間進行選擇
<a name="rcs-rich-messaging-choosing"></a>

這兩個 API 動作都可以透過 RCS 傳遞訊息，但其用途不同。 會`SendTextMessage`假設每則訊息都以 SMS 形式傳遞，也可以透過 RCS 傳遞，進而提供更簡單的請求合約。 會`SendRcsMessage`假設豐富的 RCS 內容，並新增`SendTextMessage`沒有的功能，包括媒體和結構化內容類型、具有time-to-live(TTL) 的訊息過期，以及每則訊息 SMS 或 MMS 後援。


**SendTextMessage 相較於 SendRcsMessage**  

| 功能 | 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 型過期處理時間敏感的內容時，請選擇此選項。

## 內容類型
<a name="rcs-rich-messaging-content-types"></a>

`RcsMessageContent` 參數包含只有一種內容類型的`Content`物件，以及選用的訊息層級`Suggestions`清單。您無法在單一請求中合併多個內容類型。


**RCS 內容類型**  

| 內容類型 | 說明 | 其他資訊 | 
| --- | --- | --- | 
| TextMessage | 最多 3，072 個字元的文字內文，以及選用的建議。與 SMS 訊息不同，RDS 文字訊息可以包含建議，並以單一訊息傳送，而不是分割為區段。 | [傳送 RCS 文字訊息](rcs-text-messages.md) | 
| FileMessage | HTTPS 或 Amazon S3 URL 參考的單一媒體檔案 （影像、影片、音訊或 PDF)。 | [傳送 RCS 檔案訊息](rcs-file-messages.md) | 
| RichCard | 具有選用媒體、標題、描述和最多 4 個建議的結構化卡片。 | [傳送 RCS 豐富的卡片](rcs-rich-cards.md) | 
| 浮動切換 | 一組可捲動的 2 到 10 張卡片，每張都有自己的媒體、文字和建議。 | [傳送 RCS 輪跳功能](rcs-carousels.md) | 

## 建議
<a name="rcs-rich-messaging-suggestions"></a>

建議是互動式晶片，收件人可以選擇採取動作。您可以為任何內容類型新增建議：訊息層級建議適用於整個訊息 （最多 11 個），而卡片層級建議適用於個別的豐富卡或浮動切換卡 （最多 4 個）。AWS最終使用者傳訊支援六個建議類型，包括回覆、連結和動作，例如撥打電話號碼或共用位置。如需建議類型的完整清單、其參數，以及如何接收建議點選，請參閱 [設定 RCS 建議](rcs-suggestions.md)。

## SendRcsMessage 請求概觀
<a name="rcs-rich-messaging-api"></a>

`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 後援](rcs-fallback-per-message.md)。

## 訊息大小和計數限制
<a name="rcs-rich-messaging-limits"></a>


**RCS 訊息限制**  

| 限制 | 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 限制，請參閱 [訊息限制](sms-limitations.md)。

## 交付事件和收件人動作
<a name="rcs-rich-messaging-events"></a>

AWS最終使用者傳訊會產生報告訊息交付狀態和收件人動作的事件，包括交付、讀取、失敗、過期和後退事件。當收件人選擇建議並包含 `PostbackData`值時，會產生後退事件。將這些事件路由到 Amazon SNS 主題、Amazon Data Firehose 交付串流或 Amazon CloudWatch Logs。如需詳細資訊，請參閱[RCS 訊息事件](rcs-events.md)。

## 最佳實務
<a name="rcs-rich-messaging-best-practices"></a>

將豐富的 RCS 訊息設計為對話式互動體驗。`TimeToLive` 為一次性密碼等時間敏感內容設定 、為必須到達收件人的訊息設定 SMS 或 MMS 後援，即使其裝置不支援 RCS、讓建議標籤保持簡短 （限制為 25 個字元），並在 中包含結構化識別符，`PostbackData`讓您的應用程式可以路由回應，而無需額外查詢。如需詳細指引，請參閱 [RCS 最佳實務](rcs-best-practices.md)。