View a markdown version of this page

傳送 RCS 豐富的卡片 - AWS 最終使用者傳訊簡訊

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

傳送 RCS 豐富的卡片

豐富的卡片將媒體、文字和建議的動作合併為單一結構化訊息。收件人會在訊息用戶端中將卡片視為原生 UI 元素,提供類似應用程式的體驗。使用多張卡片來呈現鼓勵互動的資訊,例如產品詳細資訊、預訂確認或促銷優惠。

重要

您可以在支援 RCS 的所有國家/地區使用 RCS 豐富媒體傳訊 (包括豐富卡)。如需詳細資訊,請參閱傳送豐富的 RCS 訊息

若要將多張卡片分組為可捲動集,請參閱 傳送 RCS 輪跳功能

何時使用 RTF 卡

豐富的卡片非常適合從具有互動式元素的視覺化配置中受益的訊息。常用案例包括:

  • 產品展示:在一個訊息中顯示影像、產品名稱、價格和購買按鈕。

  • 預訂確認:使用行事曆連結和指示按鈕顯示預訂詳細資訊。

  • 預約詳細資訊:目前日期、時間、位置和確認或重新排程的選項。

  • 促銷優惠:重點介紹媒體的交易,以及明確的行動呼籲。

如果您的訊息只需要包含選用建議的文字,請傳送 RCS 文字訊息改用 。如果您需要在沒有其他卡片結構的情況下傳送檔案,請參閱 傳送 RCS 檔案訊息

豐富的卡片元件

獨立實物卡包含下列元件。中至少Description需要其中一個 MediaTitle、 或 CardContent

豐富的卡片元件
元件 必要 說明
Media 卡片內顯示的影像、GIF 或影片。支援的格式包括 JPEG、PNG、GIF 和 MP4。 檔案大小上限為 100 MB。
Title 卡片的簡短標題。最多 200 個字元。
Description 內文文字提供其他詳細資訊。最多 2,000 個字元。
Suggestions 最多 4 個連接到卡片的建議動作或回應。請參閱 設定 RCS 建議

卡片方向

CardOrientation 欄位控制媒體和文字內容之間的配置關係。此欄位為必填。

VERTICAL

媒體會顯示在卡片頂端,標題、描述和建議如下。垂直方向是跨平台相容性的建議預設值。

HORIZONTAL

媒體會顯示在卡片的左側或右側,並在其旁邊顯示文字內容。媒體區域的固定寬度為 128 個獨立於密度的像素 (DP)。使用 ThumbnailImageAlignment控制媒體是否出現在左側或右側。

警告

水平方向會導致 iOS 裝置上的影像截斷。使用跨平台部署的VERTICAL方向。

媒體和高度

Media 物件包含 FileUrl(必要)ThumbnailUrl、選用 和選用Height值。FileUrl 必須符合模式^(https://|s3://).+$,且最多可達 2,000 個字元。媒體檔案大小上限為 100 MB。

如需支援的媒體格式、交付選項和 S3 預先簽章 URLs的詳細資訊,請參閱 傳送 RCS 檔案訊息

媒體高度值
Height 大小 說明
SHORT 112 DP 精簡顯示。用於縮圖或當文字內容是主要焦點時。
MEDIUM 168 DP 平衡顯示。建議大多數使用案例使用預設值。
TALL 264 DP 最大顯示區域。當媒體是主要內容時使用。
注意

iOS 會以相同的方式轉譯所有媒體高度值,忽略指定的高度設定。使用 TALL將 Android 裝置上的顯示區域最大化,同時在 iOS 上維持可接受的轉譯。

卡片層級建議

您可以將最多 4 個建議包含在CardContent.Suggestions陣列中,以連接至豐富的卡片。卡片層級建議會顯示在卡片內容的正下方。

除了卡片層級建議之外,您可以在RcsMessageContent結構的最上層Suggestions陣列中包含最多 11 個訊息層級建議。訊息層級建議會在整個訊息下方顯示為持久性晶片。

如需建議類型的完整清單 (包括 ReplyOpenUrlDialPhoneRequestLocation、 和 CreateCalendarEvent)ShowLocation,請參閱 設定 RCS 建議

RcsMessageContent 結構

下列 JSON 顯示獨立豐富卡的 RcsMessageContent 參數結構。將此 JSON 做為字串傳遞至 CLI AWS中的 --rcs-message-content 參數,或做為 SDK 中的 RcsMessageContent 參數。

{ "Content": { "RichCard": { "StandaloneCard": { "CardOrientation": "VERTICAL", "CardContent": { "Title": "Your card title", "Description": "Additional details about the card content.", "Media": { "FileUrl": "https://example.com/image.jpg", "ThumbnailUrl": "https://example.com/thumb.jpg", "Height": "MEDIUM" }, "Suggestions": [ { "Reply": { "Text": "Confirm", "PostbackData": "confirm_action" } }, { "OpenUrl": { "Text": "View details", "PostbackData": "view_details", "Url": "https://www.example.com/details" } } ] } } } }, "Suggestions": [ { "Reply": { "Text": "Help", "PostbackData": "help_menu" } } ] }

在此結構中:

  • Content.RichCard.StandaloneCard 包含卡片定義。

  • CardOrientation 是必要項目,並接受 VERTICALHORIZONTAL

  • ThumbnailImageAlignment 是選用的,僅適用於水平卡。

  • CardContent.Suggestions 保留卡片層級建議 (最多 4 個)。

  • 最上層Suggestions陣列會保留訊息層級建議 (最多 11 個)。

傳送多張卡片

使用 SendRcsMessage API 動作來傳送豐富的卡片。將集區或 AWSRCS 代理程式指定為 ,--origination-identity並將豐富的卡片 JSON 結構傳遞為 --rcs-message-content 參數。

跨平台轉譯

Android 和 iOS 裝置之間有豐富的卡轉譯。請遵循這些建議以取得一致的結果:

跨平台建議
建議 Reason
使用VERTICAL方向 水平方向會導致 iOS 上的影像截斷。
使用TALL媒體高度 iOS 會忽略高度值。 會將 Android 上的顯示區域TALL最大化。
將標題保留為 3 行或更少 在啟用可存取性設定的情況下,防止 iOS 上的媒體裁切。
使用連結OpenUrl的建議 描述文字中的 URLs 無法在任一平台上按一下。
在 iOS 上測試 GIF 媒體 確認靜態第一個影格轉譯可接受。

豐富的卡片限制

豐富的卡片限制
資源 限制
標題長度 200 個字元
描述長度 2,000 個字元
卡片層級建議 每張卡 4 個
訊息層級建議 每則訊息 11 個
訊息承載總計 250 KB
媒體檔案大小 100 MB
FileUrl 長度 2,000 個字元