美國帳單報表

本頁說明 RCS Business Messaging 建立的資料檔案,可協助美國電信業者根據美國 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 企業通訊說明文件所用的 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_messagesmo_messages 欄中,回報整個 24 小時工作階段間隔式時間區間的 MT 和 MO 訊息總數。

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

欄位 格式 說明 範例
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_messagea2p_rich_media_message 等非工作階段事件,這是指訊息傳送給使用者的時間。
  • 如果是 a2p_session 事件,這是指對話中的第一則訊息傳送給使用者的時間。
  • P2A

  • 如果是 p2a_rich_messagep2a_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 eventsp2a_rich_message 事件的計算片段數 (1 個片段等於 160 個 UTF-8 位元組)。如果事件不是上述任一項,值為 0。 5
    session_type 字串 工作階段類型:
  • a2p_session
  • p2a_session
  • 如果活動不符合工作階段資格,則此欄位會空白。
    a2p_session

    帳單報表範例

    您可以下載範例報表:

    一般檔案大小

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