美國帳單模式

本文檔概述了美國營運商 RCS for Business 流量的計費模式。

美國帳單分類概述

所有發送到美國電話號碼或從美國電話號碼發送的訊息都會根據其格式自動分類為以下類型之一:

  • 富文本訊息(雙向)
  • 富媒體訊息(雙向)

多種類型的消息可以組合到一個會話中。有關會話的更多信息,請參閱會話計費(試點)

詳細規格請參考以下章節。

關於術語的說明

為了描述訊息流量的方向,美國營運商通常使用 MT/MO 術語。這些術語與 RCS for Business 文件中使用的 A2P/P2A 術語相對應:

  • MT(行動終端)是 A2P(應用程式到個人) :由企業發送的訊息。
  • MO(行動發起)是 P2A(人機互動) :由使用者發起的訊息或操作。

代理對個人 (A2P/MT) 事件計費

本節介紹代理程式發送的訊息(即 A2P 或 MT 訊息)的計費邏輯。

富媒體消息(A2P)

如果一則訊息包含以下元素的組合,則該訊息被歸類為富媒體訊息:

富文本訊息的計費邏輯

富媒體訊息是按用戶群計費的。

  • 段大小:1 個段 = 160 位元組的 UTF-8 編碼文字。
  • 計算方法:將訊息文字的 UTF-8 總位元組長度除以 160,並始終向上取整到最接近的整數。
  • 排除項:建議回覆或操作中的文字和回傳資料計入細分計數。
  • 例如:一條 300 位元組的文字訊息有 2 個段(300 / 160 = 1.875,向上取整為 2)。

位元組計數

一些 Unicode 字元(如表情符號或帶有重音符號的字母)是多位元組的,因此 UTF-位元組總數可能與字元數不同。

若要查看訊息的確切位元組數,請在下方鍵入或貼上訊息。

富媒體資訊(A2P)

如果一則訊息包含以下至少一項內容,則該訊息被歸類為富媒體訊息:

富媒體訊息的計費邏輯

富媒體訊息推播按單次固定費用收費。

  • 無論文字長度、卡片數量或媒體檔案大小如何,計費方式都相同。
  • 細分不適用。

A2P API 回應範例

這些範例顯示了代理程式發送的訊息在成功的 RBM API 呼叫回應中的richMessageClassification欄位。

RICH_MESSAGE的範例 API 回應

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 5
  }
}

RICH_MEDIA_MESSAGE的範例 API 回應

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

個人對代理商 (P2A/MO) 事件計費

本節涵蓋用戶發起的訊息和操作的計費(即 P2A 或 MO 訊息)。

富媒體消息(P2A)

如果使用者訊息僅包含文本,則該訊息被歸類為富文本訊息。這包括自由文字和點擊建議回覆後產生的文字。 (建議回覆的訊息有效負載中可能包含回傳資料標識符。)

計費邏輯:按用戶細分計費。有關細分數量計算的詳細信息,請參閱富媒體訊息的計費邏輯

富媒體資訊(P2A)

如果訊息包含上傳的檔案(圖像、影片、音訊),則該訊息被歸類為富媒體訊息。

計費邏輯:以單次固定費率計費。不進行分段計費。

建議操作點擊

使用者點擊任何建議操作都會產生一個計費事件,稱為「建議操作點擊」。 (建議操作的訊息有效負載中可能包含回傳資料標識符。)

計費邏輯:每次點擊產生一個計費事件。

特殊情況:共享位置

定位共享的獨特之處在於,它會產生兩個獨立的 P2A 計費事件:

P2A webhook 回應範例

這些範例顯示了傳送給代理程式的使用者發起事件的 webhook 中的richMessageClassification欄位。

使用者傳送的RICH_MESSAGE的範例 webhook

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "text": "Hello, world!",
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 1
  }
}

使用者傳送的RICH_MEDIA_MESSAGE的範例 webhook

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

SUGGESTED_ACTION_CLICK的範例 webhook

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

位置訊息的範例 webhook

這是共享位置流程中的第二個計費事件,在使用者從地圖共享其位置後發送。

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "location": {
      "latitude": 37.422000,
      "longitude": -122.084056
    },
    "richMessageClassification": {
        "classificationType": "RICH_MESSAGE",
        "segmentCount": 1
    }
}

會話計費(試點)

雖然現有的美國計費模式是按單一訊息收費,但會話計費試點引入了一種方法,將整個用戶到品牌和/或品牌到用戶的對話分組到一個可計費事件中:即p2a_sessiona2p_session

當在連續 24 小時內達到特定的交互閾值時,系統會記錄並計費一次會話事件。更多信息,請參閱“什麼是會話以及它是如何運作的”

技術和實施說明

  • 分段僅用於計費:長訊息將作為一個整體發送到用戶設備。分段計數是用於計費的虛擬計算;它不會影響訊息的發送或顯示方式。
  • 自動分類:訊息分類完全基於訊息內容自動進行,無法手動變更。
  • 推出:美國計費模式於 2025 年 7 月 15 日在 RCS for Business 平台上啟用。從該日期起,Google 的報告和 API 回應將反映新的分類。