美國帳單報表

本頁說明 RCS for Business 建立的資料檔案,可協助美國電信業者根據美國 RBM 架構進行帳單結算和稽核。如要進一步瞭解美國 RBM 架構,請參閱 usrbm.org。

帳單報表是可計費事件的匯總報表,「可計費」只是指事件符合收費資格。電信業者會決定是否收取可計費事件的費用,以及收費方式。如果美國電信業者目前正在使用 RCS for Business,就能存取帳單報表。

如要進一步瞭解美國帳單分類模型,請參閱「美國帳單常見問題」。

檔案生成

詳情請參閱「檔案生成」。

檔案儲存空間和存取權

詳情請參閱「檔案儲存空間和存取權」。

檔案可用性

詳情請參閱「檔案可用性」。

帳單報表

帳單報表會記錄可計費事件,並根據代理程式的帳單類別和傳送的訊息類型計算費用。只要電信業者目前正在使用 RCS 企業訊息,就能查看帳單報表。

帳單報表包含機密資訊,但不含使用者個人識別資訊 (PII),例如 MSISDN、雜湊 MSISDN 或任何使用者專屬 ID。

帳單類別與可收費事件

瞭解代理程式的帳單類別和可計費事件之間的差異,是瞭解代理程式計費方式的關鍵。

  • 帳單類別是您在建立代理程式時選擇的固定分類。這會決定代理的計費方式:按訊息計費 (非對話式代理) 或按工作階段計費 (對話式代理)。
  • 收費事件是指 RCS for Business 代理與使用者之間的互動,系統會追蹤這些互動以利計費 (例如 rich_message)。

美國代理商帳單類別

建立代理時,擁有者會根據代理與使用者的互動方式,設定代理的帳單類別。帳單類別不會限制代理可傳送的訊息數量或類型。但會決定系統如何針對訊息向服務專員收費。下表說明兩大主要帳單類別。

帳單類別 服務專員類型 應用實例 計費方式
非對話 主要傳送單向訊息的代理程式。
  • 動態密碼
  • 快訊
  • 促銷優惠
系統會針對傳送給使用者的每則訊息收費。
對話式 這類服務專員的設計目的是與使用者來回對話,無論對話由誰發起。
  • 尋找合適的產品
  • 預訂票券
  • 疑難排解
按工作階段計費:如果符合工作階段條件,24 小時工作階段期間內的所有豐富訊息和互動式多媒體訊息都會按固定費率計費,不論訊息長度或區隔。

按訊息計費:如果不符合工作階段條件,或訊息超出 24 小時工作階段期間,系統會根據個別電信業者的價目表,按豐富訊息或互動式多媒體訊息的費率逐一計費。

對話式和非對話式代理

代理的帳單類別有兩種:對話式和非對話式。

  • 非對話式服務專員傳送給使用者的每則訊息都會計費。

    • 如果代理程式不常收到回覆,最適合使用這個類別。
  • 對話式代理程式會以固定費率計費,只要觸發工作階段,就會將 24 小時內的所有訊息(包括觸發工作階段的訊息) 納入工作階段。如果訊息不屬於 24 小時工作階段,對話式代理程式仍可能產生費用。

    • 這個類別最適合與使用者進行多輪對話的服務專員。

工作階段計費邏輯

在美國計費模式下,如果在 24 小時內交換 4 則豐富或互動式多媒體訊息 (包括至少 2 則 MO 訊息和至少 1 則 MT 訊息),就會觸發工作階段。達到這個門檻後,該 24 小時內的所有訊息都會以單一工作階段計費。如果訊息不屬於工作階段或無法觸發工作階段,系統會按照個別電信業者的價目表,以標準每則訊息費率收取豐富或互動式多媒體訊息費用。

下圖顯示對話式代理程式的 A2P 帳單結算週期示例。

  • MT (Mobile Terminated) 是商家傳送的訊息。
  • MO (Mobile Originated) 是指使用者發起的訊息或動作。

美國帳單 - 工作階段

可計費事件

訊息傳送流程會依據來源和方向分類。美國電信業者通常使用 MT/MO 術語來描述訊息流量的方向。這些字詞對應於 RCS for Business 說明文件通篇使用的 A2P/P2A 術語。以下是這些字詞的對應關係:

  • A2P (應用程式對個人) 是 MT (行動裝置終止):商家傳送的訊息。
  • P2A (Person-to-Application) 是 MO (Mobile Originated):使用者發起的訊息或動作。
事件 說明 非對話式代理 對話式代理
a2p_rich_message 僅含文字、建議回覆或特定建議動作 (撥號、在瀏覽器中開啟網址) 的訊息。 一律視為個別計費事件。

系統會根據訊息片段計費 (1 個片段等於 160 個 UTF-8 位元組)。

除非成為工作階段的一部分,否則會視為個別計費事件。
p2a_rich_message 使用者傳送的訊息,僅包含任意形式的文字,或輕觸建議回覆後產生的文字。 一律視為個別計費事件。

根據區隔按訊息收費。

除非成為工作階段的一部分,否則會視為個別計費事件。
a2p_rich_media_message 客服專員傳送的訊息含有媒體 (圖片、影片、音訊)、複合式資訊卡、輪播或複雜動作 (例如「查看位置」)。 一律視為個別計費事件。

無論大小或內容為何,都以單一固定費率事件計費。

除非成為工作階段的一部分,否則會視為個別計費事件。
p2a_rich_media_message 使用者傳送的訊息,內含上傳的媒體檔案 (圖片、影片、音訊)。 一律視為個別計費事件。

以單一固定費率事件計費。

除非成為工作階段的一部分,否則會視為個別計費事件。
p2a_suggested_action 使用者輕觸任何建議動作 (例如「查看地點」),但不是建議回覆。 一律視為個別計費事件。

每次點擊都會產生一個可計費事件。

系統會將其視為個別可計費事件,且每次點擊都會產生一個可計費事件,除非該事件成為工作階段的一部分。
a2p_session 24 小時的互動時間範圍,從啟動工作階段觸發條件並傳送第一則 MT 訊息時開始計算。詳情請參閱「什麼是工作階段,以及工作階段的運作方式」。 以上選項皆不適用,工作階段不適用於非對話式代理程式。 觸發後,24 小時內的所有訊息都會計入單一工作階段費用。24 小時工作階段中的任何可計費事件,都會指派給工作階段的可計費事件 ID。
p2a_session 24 小時的互動時間範圍,從工作階段觸發開始,到第一則訊息為 MO 為止。詳情請參閱「什麼是工作階段,以及工作階段的運作方式」。 以上選項皆不適用,工作階段不適用於非對話式代理程式。 觸發後,24 小時內的所有訊息都會計入單一工作階段費用。24 小時工作階段中的任何可計費事件,都會指派給工作階段的可計費事件 ID。

產生帳單報表

只有非測試人員流量的代理程式會產生計費事件。測試電話號碼的活動不會顯示在帳單報表中。

這些報表假設事件在傳送 A2P 訊息時會產生費用,而非在傳送訊息時。如果訊息未送達,或在送達前取消傳送,就不會觸發計費事件。

帳單報表格式

帳單報表會使用 rbm_billable_events_YYYY-MM-DD.csv 檔案名稱格式。檔案名稱中的日期是檔案生成日期。

報表中的每一行都是一筆記錄,代表單一可計費事件。A2P/P2A 工作階段會以多個資料列表示,每個資料列代表一則交換的訊息。與工作階段相關聯的每個資料列 (共用相同的 billing_event_id),都會在 mt_messages 和 mo_messages 欄中,回報整個 24 小時工作階段期間的 MT 和 MO 訊息總數。

檔案採用 UTF-8 編碼,不含位元組順序標記,並使用換行符號做為行尾。每個檔案的第一行是標題列,內含欄位名稱。

報表中的每筆記錄都包含下列資訊,適用於每個可計費事件。

欄位 格式 說明 範例
billing_event_id 字串 用來區分可計費事件的產生 ID。

同一工作階段的所有訊息都會有相同的 billing_event_id。

63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e
type 字串 活動類型:
  • a2p_rich_message
  • a2p_rich_media_message
  • p2a_rich_message
  • p2a_rich_media_message
  • p2a_suggested_action
  • p2a_rich_message
    agent_id 字串 參與活動的代理專屬 ID。 acme_342h23_agent@rbm.goog
    agent_owner 字串 建立代理商的合作夥伴帳戶現任擁有者的電子郵件地址。 marketing@xyzaggregator.com
    billing_party 字串 負責支付活動費用的對象。 電信業者
    max_duration_single_message 數字 使用者回覆服務專員訊息的最長時間 (以小時為單位)。如果超過這個時間,對話啟動視窗就會關閉,且訊息會歸類為 single_message 事件。不適用於美國的個別即時訊息模型。 24
    max_duration_a2p_conversation 數字 在工作階段試用期間,這項指標會反映從觸發序列中的第一則訊息起算的 24 小時工作階段時間範圍。時間長度以小時為單位。 24
    max_duration_p2a_conversation 數字 在工作階段試用期間,這項指標會反映從觸發序列中的第一則訊息起算的 24 小時工作階段時間範圍。 24
    start_time YYYY-mm-ddTHH:00:00Z

    活動開始的 UTC 日期/時間 (ISO 8601)。如果是工作階段,這是觸發序列中第一則訊息的時間戳記。

    A2P

  • 如果是 a2p_rich_message 和 a2p_rich_media_message 等非工作階段事件,這是指訊息傳送給使用者的時間。
  • 如果是 a2p_session 事件,這就是系統將對話中的第一則訊息傳送給使用者的時間。
  • P2A

  • 如果是 p2a_rich_message 和 p2a_rich_media_message 等非工作階段事件,這是指使用者傳送訊息的時間。
  • 如果是 p2a_session 事件,這是指使用者傳送對話中第一則訊息的時間。
  • 2025-05-20T08:00:00Z
    duration 數字 時間長度僅適用於工作階段,並以分鐘為單位。如果事件不是工作階段事件,值為 0。 45
    mt_messages 數字 事件中的行動裝置終端 (A2P) 訊息數。如果是工作階段,每個共用相同 billing_event_id 的資料列,都會顯示整個工作階段的 MT 訊息總數。 5
    mo_messages 數字 活動中以行動裝置發送 (P2A) 的訊息數量。如果是工作階段,每個共用相同 billing_event_id 的資料列,都會顯示整個工作階段的 MO 訊息總數。 3
    size_kilobytes 數字 活動中附加至郵件的所有檔案大小,四捨五入至最接近的 KB (1 KB 等於 1024 個位元組)。 912
    agent_name 字串 參與活動的代理程式名稱。 ACME Brand
    owner_name 字串 建立代理程式的合作夥伴帳戶現任擁有者名稱。 XYZ Aggregator
    segment_count 數字 a2p_rich_message events 和 p2a_rich_message 事件的計算片段數 (1 個片段等於 160 個 UTF-8 位元組)。如果事件不是上述任一項,值為 0。 5
    session_type 字串 工作階段類型:
  • a2p_session
  • p2a_session
  • 如果活動不符合工作階段資格,這個欄位會留空。
    a2p_session

    帳單報表示例

    您可以下載範例報告:

    一般檔案大小

    有效 RCS for Business 合作夥伴的每日報表大小,取決於他們在電信業者網路中產生的活動量。