登录开始免费试用
Meta Tech Provider

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 转发到你的服务器,便于你自己的系统统计用量。

PMP

当前 Webhook 中的 pricing_model 表示按条计费;CBP 仅出现在 2025 年 7 月 1 日之前发送的 Webhook 中。

1,000

自 2026 年 10 月 1 日起,每个业务号码每月在 Meta 免费额度内已送达的服务消息。

regular

计费消息的 type,包括号码免费额度用完后送达的服务消息。

paid_exempt

subtype 标注的是服务消息,因机构属于符合资格的政府或非营利组织而免费。

0

Webhook 中的阶梯定价细节;Meta 建议查看 pricing_analytics 字段以获取用量阶梯信息。

定价对象出现在哪里?

只出现在部分状态中:Meta 在 sent 状态以及 delivered 或 read 之一中附带该对象。Meta 参考文档中的 v24.0 示例显示,sent 中没有该对象,因为它改由 delivered Webhook 附带。failed 状态从不附带该对象。因此,应把定价视为消息的属性,以 wamid 为键,无论哪个状态带来它,只记录一次。以下是 Meta 给出的服务消息定价对象示例,分别展示该号码每月免费额度耗尽前和耗尽后的情况:

Meta's examples: a service message in the free tier, then a charged one
// 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 2026From 1 Oct 2026
regularA billable messageBillable, now including utility replies to customers and service messages past the number's monthly tier
free_customer_serviceA utility template or non-template message sent in an open windowA one-to-one service message within the number's monthly tier
free_group_customer_serviceGroup utility or non-template message in an open group windowA group service message within the number's monthly tier
free_entry_pointSent in an open free entry point windowUnchanged

消息可以有哪些 category?

category 表示 Meta 收费时采用的费率档位。对账 Meta 账单时,应按 category 分组,并结合客户号码所属国家进行统计,因为各市场费率不同。每条消息只有一个 category,也只产生一次收费:非模板消息即使含有推广内容,仍是服务消息,不会产生额外的营销费用。Meta 列出的取值如下:

marketingMarketing template rate.
utilityUtility template rate.
authenticationAuthentication template rate.
authentication-internationalAuthentication-international rate.
serviceNon-template message sent in reply to a customer.
marketing_liteMarketing Messages API for WhatsApp pricing.
referral_conversionMessage in a free entry point window.
group_marketing, group_utility, group_serviceThe same categories for group messages.

如何根据 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 获取。
使用 EasyCoexistence 完成这些操作

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,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间