WhatsApp webhook 定價物件:type、category 與 billable(2026)
定價物件附於狀態 webhook 中,說明 Meta 如何為一則訊息分類:billable(即將棄用)、pricing_model PMP、type(regular、free_customer_service、free_entry_point 或 free_group_customer_service)、category,例如 marketing、utility、authentication 或 service,以及可選的 subtype paid_exempt。自 2026 年 10 月 1 日起,regular 標示每一則收費訊息,包括服務訊息。
easyCoexistence 透過 Coexistence 將你的 WhatsApp Business 應用程式號碼連接至 Meta 的 Cloud API,並把載有此物件的狀態 webhook 傳送到你的伺服器,讓你自己的系統統計用量。
目前 webhook 的 pricing_model 為逐則計費(PMP);CBP 只會出現於 2025 年 7 月 1 日之前發送的 webhook。
自 2026 年 10 月 1 日起,每個商業電話號碼每月於 Meta 免費額度內的已送達服務訊息免費。
收費訊息的 type,包括超出號碼免費額度後送達的服務訊息。
subtype 標示因機構屬合資格政府或非牟利組織而免費的服務訊息。
webhook 中的分級詳情;用量分級資訊請參閱 Meta 指定的 pricing_analytics 欄位。
定價物件出現在哪裡?
只出現在部分狀態中:Meta 會隨 sent 狀態,以及 delivered 或 read 其中一個一併提供。Meta 參考文件中的 v24.0 範例顯示 sent 狀態缺少此物件,因為它是隨 delivered webhook 送來的。failed 狀態從不附帶此物件。因此應將定價視為訊息的屬性,以 wamid 為鍵,無論哪個狀態帶來,只記錄一次。以下是 Meta 提供的服務訊息定價物件範例,分別顯示號碼每月免費額度用完前後的情況:
// Service message delivered while the number is within its free tier
"pricing": {
"billable": false,
"pricing_model": "PMP",
"type": "free_customer_service",
"category": "service"
}
// Service message delivered after the number's free tier has been used
"pricing": {
"billable": true,
"pricing_model": "PMP",
"type": "regular",
"category": "service"
}自 2026 年 10 月 1 日起,type 的值有何意義?
type 是回答 Meta 是否收費的欄位。自 2026 年 10 月 1 日起,其意義有所改變:Meta 開始對服務訊息,以及為回覆客戶而發送的 utility 訊息範本逐則收費。在此日期前編寫的程式碼,可能會把 free_customer_service 理解為開放時段內的回覆;現在它表示號碼每月免費額度內的一對一服務訊息。billable 仍會出現,但 Meta 表示將會棄用,並建議你將 type 與 category 一併閱讀。
| Through 30 Sep 2026 | From 1 Oct 2026 | |
|---|---|---|
| regular | A billable message | Billable, now including utility replies to customers and service messages past the number's monthly tier |
| free_customer_service | A utility template or non-template message sent in an open window | A one-to-one service message within the number's monthly tier |
| free_group_customer_service | Group utility or non-template message in an open group window | A group service message within the number's monthly tier |
| free_entry_point | Sent in an open free entry point window | Unchanged |
訊息可以有哪些 category?
category 指 Meta 收費時所適用的費率。對帳 Meta 的帳單時,應按此欄位分組,並同時參照客戶號碼的所在國家,因為費率因市場而異。每則訊息只有一個 category,且只收一次費:不屬範本的訊息即使含推廣內容,仍屬服務訊息,不會另加一筆 marketing 費用。Meta 列出的值如下:
如何從 webhook 計算收費?
webhook 只告訴你哪些訊息可收費,以及屬於哪個 category,並不顯示費用金額。要建立與 Meta 帳單相符的用量視圖,請按訊息及 category 計算,再套用 Meta 公布的各市場費率;或讀取 Meta 的 pricing_analytics 欄位,該欄位提供逐則明細及分級資料。
- 以 wamid 去重,因為定價可能隨多個狀態送達,而重試亦會重複發送 webhook。
- 當 type 為 regular 時,將該訊息計為已收費;按 category 及收件人所在國家分組。
- 忽略失敗的訊息:Meta 只對已送達的訊息收費。
- 自 v24.0 起,除免費入口點時段外,預期不會有 conversation 物件;時段內的 id 在每個時段中唯一。
這對 Coexistence 號碼上的 AI 回覆有何影響?
你的 AI 或自動化程式透過 API 發送的每則回覆,都屬於非範本訊息,因此其 category 為 service:在號碼每月免費額度內,顯示為 free_customer_service,超出後則顯示為 regular。你的 AI 透過 send_template 發送的範本,則帶有各自的 category。Meta 的 Coexistence 指南中有一項對成本很重要的差異:擁有者在 WhatsApp Business 應用程式中輸入的訊息,不受客戶服務時段限制,也不影響 Cloud API 的收費。
Meta 會按商業帳戶本身的 WhatsApp Business Account 逐則收費,並按 category 及國家計算;easyCoexistence 從不加價,而 AI 用量則由你的 AI 供應商以你自己的金鑰計費。
常見錯誤
- 每次出現都計算定價物件。同一則訊息的多個狀態都可能帶有它,因此應按 wamid 只計一次。
- 只讀取 billable。Meta 正在棄用此欄位,並要求你同時使用 type 與 category。
- 保留 10 月前對 free_customer_service 的理解。自 2026 年 10 月 1 日起,它標示號碼每月免費額度內的服務訊息。
- 期望 payload 中有金額。物件只列出 category;費率須參照 Meta 的費率表或 pricing_analytics。
Meta 的收費仍保留在你自己的 WhatsApp Business Account 內,從不加價。每個號碼每月 US$ 9 起,號碼越多越便宜,最低降至 US$ 0.75,並提供首 3 天免費試用。
常見問題
哪個帳戶為訊息付費?
發送該訊息的 WhatsApp Business Account。當多個帳戶透過同一號碼發送時,Meta 會把每筆收費歸於發送該訊息的帳戶,並使用該帳戶自己的付款方式與消費上限。
什麼是 marketing_lite?
這是透過 Meta 的 Marketing Messages API for WhatsApp 發送的訊息所用的 category 及 type 定價。它屬於獨立的發送途徑,專供行銷範本使用,並提供獨立的定價選項,例如每次送達的最高價格。
每則訊息定價何時取代了對話計費?
於 2025 年 7 月 1 日。在此日期前發送的 webhook 可能顯示 pricing_model 為 CBP,即按對話計費;之後的則顯示 PMP。仍按對話 id 分組收費的程式碼需要更新。
免費額度每月會重置嗎?
會。Meta 每月為每個商業電話號碼提供 1,000 則已送達的服務訊息,不結轉;額度於 WhatsApp Business Account 所在時區的午夜重置。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期