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),以及可选的子类型 paid_exempt。自 2026 年 10 月 1 日起,regular 标记所有计费消息,包括服务消息。
easyCoexistence 通过 Coexistence 将你的 WhatsApp Business 应用号码连接到 Meta 的 Cloud API,并把携带该对象的状态 Webhook 转发到你的服务器,便于你自己的系统统计用量。
当前 Webhook 中的 pricing_model 表示按条计费;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 分组,并结合客户号码所属国家进行统计,因为各市场费率不同。每条消息只有一个 category,也只产生一次收费:非模板消息即使含有推广内容,仍是服务消息,不会产生额外的营销费用。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 账户收费,并按 category 和国家计价;easyCoexistence 从不加价。AI 用量由你的 AI 服务商按你自己的密钥计费。
常见错误
- 每次出现都计入定价对象。同一条消息的定价对象可能出现在多个状态中,应按 wamid 只计一次。
- 只读取 billable。Meta 正在弃用它,并要求你同时使用 type 和 category。
- 仍沿用 10 月前对 free_customer_service 的旧理解。自 2026 年 10 月 1 日起,它标注的是该号码每月免费额度内的服务消息。
- 期望负载中包含金额。该对象只标明 category;费率需从 Meta 的费率表或 pricing_analytics 获取。
Meta 的费用仍记在你自己的 WhatsApp Business 账户上,从不加价。每个号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
哪个账户为消息付费?
发送该消息的 WhatsApp Business 账户。当多个账户通过同一号码发送消息时,Meta 会将每笔费用记到发送该消息的账户上,并使用各自的付款方式和消费限额。
什么是 marketing_lite?
这是通过 WhatsApp 的 Marketing Messages API 发送的消息所使用的 category 和 type 定价,是一条独立的发送路径,用于营销模板,并有自己的定价选项,例如每次投递的最高价格。
按条计费何时取代了按会话计费?
2025 年 7 月 1 日。在该日期之前发送的 Webhook 可能显示 pricing_model 为 CBP,即基于会话的计费;之后的 Webhook 显示 PMP。仍按 conversation id 对费用分组的代码需要更新。
免费额度每月重置吗?
是的。Meta 为每个业务电话号码提供每月 1,000 条已送达的服务消息,不结转,于 WhatsApp Business 账户所在时区的午夜重置。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间