View a markdown version of this page

傳送 RCS 文字訊息 - AWS 最終使用者傳訊簡訊

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

傳送 RCS 文字訊息

TextMessage 是您可以使用 SendRcsMessage API 傳送的最簡單內容類型。它包含純文字內文 (最多 3,072 個字元),以及顯示在訊息下方的互動式按鈕的選用建議晶片。

RCS 文字訊息與 SMS 有何不同

透過 傳送的文字訊息與透過 SendTextMessage(SMS) 傳送的文字訊息SendRcsMessage有兩種不同:

  • 建議晶片:您最多可以將 11 個建議晶片連接至 RCS 文字訊息。透過這些晶片,收件人可以在一個步驟中回覆、開啟 URL、撥打電話號碼、共用位置或建立行事曆事件。SMS 不支援建議。

  • 單一訊息傳遞:RDS 文字訊息會以單一訊息的形式送達,無論長度為何 (最多 3,072 個字元)。電信業者會將超過 160 個字元的 SMS 訊息分割成多個區段,這些區段可能無法按順序到達,或區段之間有延遲。

如需所有可用建議類型及其參數的詳細資訊,請參閱 設定 RCS 建議

文字訊息的 RcsMessageContent 結構

當您呼叫 時SendRcsMessage,您會傳遞訊息承載做為 RcsMessageContent 參數。對於文字訊息,將 Content 欄位設定為包含Body字串的TextMessage物件。若要包含建議晶片,請將Suggestions陣列新增為 的最上層同級。 Content

下列 JSON 程式碼片段顯示具有建議的文字訊息RcsMessageContent的 結構:

{ "Content": { "TextMessage": { "Body": "What would you like to do?" } }, "Suggestions": [ { "Reply": { "Text": "Check order status", "PostbackData": "action=check_order" } }, { "OpenUrl": { "Text": "View details", "PostbackData": "action=view", "Url": "https://example.com/orders/1234" } } ] }

在此範例中:

  • Content.TextMessage.Body 包含訊息文字 (必要,1 到 3,072 個字元)。

  • Suggestions 是頂層陣列 (選用,最多 11 個項目)。每個建議都需要一個Text欄位 (最多 25 個字元) 和一個PostbackData欄位 (最多 2,048 個字元)。

Suggestions 陣列支援六個動作類型:ReplyOpenUrlDialPhoneRequestLocationShowLocationCreateCalendarEvent。您可以在單一訊息中混合不同的建議類型。如需每種類型的完整詳細資訊,請參閱 設定 RCS 建議

傳送文字訊息

若要傳送 RCS 文字訊息,SendRcsMessage請使用下列必要參數呼叫 :

  • DestinationPhoneNumber:收件人的電話號碼為 E.164 格式。

  • OriginationIdentity:傳送訊息的集區 ID 或 AWS RCS 代理程式。

  • RcsMessageContent:包含 TextMessage 物件Content的 JSON 字串。

您可以使用 AWS CLI (aws pinpoint-sms-voice-v2 send-rcs-message) 或 boto3 pinpoint-sms-voice-v2用戶端等 AWS 開發套件來呼叫 API。

SMS 或 MMS 備用

如果收件人的裝置不支援 RCS 或在 RCS 頻道上暫時無法連線,您可以將訊息設定為回復為 SMS 或 MMS。若要啟用備用,請在SendRcsMessage請求中包含FallbackConfiguration物件。FallbackConfiguration 指定備用通道 (SMSMMS)、備用訊息內文,以及用於備用訊息的起始身分 (電話號碼或寄件者 ID)。

備用是選用的。如果您省略 ,FallbackConfiguration且收件人無法接收 RCS,則不會傳送訊息。

如需設定備用行為的詳細資訊,請參閱 傳送豐富的 RCS 訊息

文字訊息限制

資源 限制 備註
訊息內文 (Body) 3,072 個字元 (UTF-8) 必要. 必須至少包含 1 個字元。
每則訊息的建議 11 回應和動作的合併總數。
建議顯示文字 (Text) 25 個字元 適用於所有建議類型。
後退資料 (PostbackData) 2,048 個字元 所有建議類型都需要。

何時使用文字訊息

TextMessage 用於:

  • 訂單確認、運送更新和預約提醒等通知。

  • 一次性密碼和驗證碼。

  • 以建議晶片提供回覆選項的對話提示,啟用引導式互動,無需任意文字輸入。

  • 內容不需要影像或結構化配置的簡短狀態更新。

對於需要具有標題和描述的影像、影片或結構化配置的訊息,請改用豐富的卡片或浮動切換。請參閱傳送豐富的 RCS 訊息