本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
傳送 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 陣列支援六個動作類型:Reply、OpenUrl、DialPhone、RequestLocation、 ShowLocation和 CreateCalendarEvent。您可以在單一訊息中混合不同的建議類型。如需每種類型的完整詳細資訊,請參閱 設定 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 指定備用通道 (SMS 或 MMS)、備用訊息內文,以及用於備用訊息的起始身分 (電話號碼或寄件者 ID)。
備用是選用的。如果您省略 ,FallbackConfiguration且收件人無法接收 RCS,則不會傳送訊息。
如需設定備用行為的詳細資訊,請參閱 傳送豐富的 RCS 訊息。
文字訊息限制
| 資源 | 限制 | 備註 |
|---|---|---|
訊息內文 (Body) |
3,072 個字元 (UTF-8) | 必要. 必須至少包含 1 個字元。 |
| 每則訊息的建議 | 11 | 回應和動作的合併總數。 |
建議顯示文字 (Text) |
25 個字元 | 適用於所有建議類型。 |
後退資料 (PostbackData) |
2,048 個字元 | 所有建議類型都需要。 |
何時使用文字訊息
TextMessage 用於:
-
訂單確認、運送更新和預約提醒等通知。
-
一次性密碼和驗證碼。
-
以建議晶片提供回覆選項的對話提示,啟用引導式互動,無需任意文字輸入。
-
內容不需要影像或結構化配置的簡短狀態更新。
對於需要具有標題和描述的影像、影片或結構化配置的訊息,請改用豐富的卡片或浮動切換。請參閱傳送豐富的 RCS 訊息。