美國帳單模式

本文將說明美國電信業者 RCS 企業專用流量的計費模式。

美國帳單分類總覽

系統會根據格式,自動將傳送給美國電話號碼或從美國電話號碼傳送的每則訊息,歸類為下列三種類型之一:

  • 複合式訊息 (雙向)
  • 互動式多媒體訊息 (雙向)
  • 建議動作點擊 (使用者發起)

如需詳細規格,請參閱下列章節。

術語注意事項

美國電信業者通常會使用 MT/MO 術語,說明訊息流量的方向。這些字詞對應於 RCS 企業通訊說明文件中使用的 A2P/P2A 術語:

  • MT (行動終端) 是 A2P (應用程式對個人):商家傳送的訊息。
  • MO (Mobile Originated) 是 P2A (Person-to-Application):使用者發起的訊息或動作。

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

本節說明代理程式傳送訊息 (即 A2P 或 MT 訊息) 的計費邏輯。

複合式訊息 (A2P)

如果訊息包含下列元素的組合,就會歸類為即時訊息:

複合式訊息的計費邏輯

系統會根據區隔向您收取豐富訊息費用。

  • 區段大小:1 個區段 = 160 個位元組的 UTF-8 編碼文字。
  • 計算方式:將訊息文字的 UTF-8 位元組總長度除以 160,然後一律四捨五入至最接近的整數。
  • 排除項目:建議的回覆或動作中的文字和回傳資料不會計入區隔數量。
  • 示例:300 位元組的簡訊有 2 個區段 (300 / 160 = 1.875,無條件進位至 2)。

位元組數

部分 Unicode 字元 (例如表情符號或帶重音符號的字母) 為多位元組,因此 UTF 位元組總數可能與字元數不同。

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

互動式多媒體訊息 (A2P)

如果訊息包含至少一個下列項目,就會歸類為互動式多媒體訊息:

Rich Media 訊息的計費邏輯

系統會將互動式多媒體訊息視為單一事件,並以固定費率計費。

  • 無論文字長度、卡片數量或媒體檔案大小為何,費用都相同。
  • 不適用區隔。

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"
  }
}

Person-to-Agent (P2A/MO) 事件計費

本節說明使用者發起的訊息和動作 (即 P2A 或 MO 訊息) 的帳單。

複合式訊息 (P2A)

如果使用者訊息只包含文字,系統會將其歸類為即時訊息。包括任意形式的文字,以及輕觸建議回覆後產生的文字。(建議回覆可能包含訊息酬載中的回傳資料 ID)。

計費邏輯:根據區隔計費。如要瞭解區隔數計算方式,請參閱複合式訊息的計費邏輯

互動式多媒體訊息 (P2A)

如果訊息含有上傳的檔案 (圖片、影片、音訊),就會歸類為多媒體訊息。

計費邏輯:系統會將這類事件視為單一事件,並以固定費率計費。不適用區隔。

建議動作點擊

使用者輕觸任何建議動作,就會產生一個可計費事件,稱為「建議動作點擊」。(建議採取的動作可能包括在訊息酬載中加入回傳資料 ID)。

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

特殊情況:分享位置資訊

定位分享功能會產生兩個不同的 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
    }
}

技術和導入注意事項

  • 區段僅供帳單用途:系統會將長訊息以單一單位傳送至使用者的裝置。區隔數量是為了計費而進行的虛擬計算,不會影響訊息的傳送或向使用者顯示方式。
  • 自動分類:系統會根據郵件內容自動分類,無法手動覆寫。
  • 推出:美國的帳單模式已於 2025 年 7 月 15 日在 RCS Business Messaging 平台啟用。自該日起,Google 的報表和 API 回應會反映新的分類。