2025 年 WhatsApp 定价迁移

历史参考：这些规则说明了 2025 年 7 月 1 日向单条消息计费的迁移，在各 WABA 所在时区的午夜生效。它们不会取代当前定价规则或当前定价集成指南。特别是服务额度和效用类消息规则已于 2026 年 10 月 1 日发生变更。

定价说明

采用单条消息计费后，我们平台上的商家将按以下方式收费：

按已送达的营销消息模板计费
按已送达的身份验证消息模板计费
按已送达的效用类消息模板计费（如果在客户服务窗口之外送达）

说明

商家可以使用free-form 消息和效用类消息模板免费回复用户
商家可以使用free entry points 消息免费回复用户

定价示例说明

如果商家发送 1 条营销类消息和 1 条效用类消息，则每个类别各产生 1 次费用。

当客户服务窗口处于开启状态时，商家可以免费发送自由格式消息或效用类消息。

客户服务窗口是一个 24 小时计时器，从用户发送消息时开始，并在收到每次新的用户消息时重置。只要客户服务窗口处于开启状态，商家就可以通过自由格式消息或效用类消息免费回复用户。自由格式消息是指除模板消息以外的任何消息类型。

当用户通过点击进入 WhatsApp 的广告或 Facebook 页面操作按钮向商家发送消息，且商家在 24 小时内回复时，该回复会开启一个 72 小时（3 天）的free entry point窗口，在此窗口内消息模板不收费。

完整示例说明

单条消息计费 Webhook

自 2025 年 7 月 1 日起，WhatsApp 消息更新 Webhook将实施以下变更：

修改现有的 conversation 字段
添加新的计费相关字段

Webhook 参数变更规范

字段名称	数据类型	描述
pricingModel	String	新属性。可能的值包括： * `"PMP"`——表示适用单条消息计费。 * `"CBP"` ——表示适用基于会话的计费。
pricingType	String	新属性。仅在 PMP（单条消息计费）模式下提供。可能的值包括： * `regular` ——表示该消息计费。 * `free_customer_service` ——表示该消息免费，原因是其为在客户服务窗口内发送的效用类消息模板或非模板消息。 * `free_entry_point` ——表示该消息免费，原因是其属于免费入口点会话的一部分。
whatsappMessage.conversation	Object	在 PMP（单条消息计费）模式下，将不再返回 conversation 对象。

CBP 模式 Webhook 示例

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.message.updated",
  "apiVersion": "v2",
  "createTime": "2022-03-01T12:00:00.000Z",
  "whatsappMessage":  {
    "id": "63f5d602367ea403f8175a6c",
    "wamid": "wamid.BgNODYxN...",
    "wabaId": "whatsapp-business-account-id",
    "from": "+16315551111",
    "to": "+16315552222",
    "status": "read",
    "type": "template",
    "template": {
      "name": "login_otp",
      "language": {
        "code": "en_US",
        "policy": "deterministic"
      }
    },
    "conversation": {
      "id": "8078ed05301c40a08d3d1845c94ca18b",
      "type": "REGULAR",
      "originType": "authentication",
      "expireTime": "2022-03-02T12:00:00.000Z"
    },
    "regionCode": "GB",
    "pricingCategory": "authentication_international",
    "pricingModel": "CBP",
    "totalPrice": 0.085,
    "currency": "USD",
    "createTime": "2022-03-01T12:00:00.000Z",
    "sendTime": "2022-03-01T12:00:01.000Z",
    "deliverTime": "2022-03-01T12:00:02.000Z",
    "readTime": "2022-03-01T12:00:02.000Z",
    "externalId": "ext_123456"
  }
}

PMP 模式 Webhook 示例

{
  "id": "evt_djeIQXaQPQyUcRFi",
  "type": "whatsapp.message.updated",
  "apiVersion": "v2",
  "createTime": "2022-03-01T12:00:00.000Z",
  "whatsappMessage":  {
    "id": "63f5d602367ea403f8175a6c",
    "wamid": "wamid.BgNODYxN...",
    "wabaId": "whatsapp-business-account-id",
    "from": "+16315551111",
    "to": "+16315552222",
    "status": "read",
    "type": "template",
    "template": {
      "name": "login_otp",
      "language": {
        "code": "en_US",
        "policy": "deterministic"
      }
    },
    "regionCode": "GB",
    "pricingCategory": "authentication_international",
    "pricingModel": "PMP",
    "pricingType": "regular",
    "totalPrice": 0.085,
    "currency": "USD",
    "createTime": "2022-03-01T12:00:00.000Z",
    "sendTime": "2022-03-01T12:00:01.000Z",
    "deliverTime": "2022-03-01T12:00:02.000Z",
    "readTime": "2022-03-01T12:00:02.000Z",
    "externalId": "ext_123456"
  }
}

过渡期边界情况

如果您与用户之间开启的效用类会话跨越了向单条消息计费切换的时间点（即会话在切换前开启，但直到切换后才结束），则在切换后且会话开启期间向该用户发送的效用类模板将免费，但仍归属于该处于开启状态的会话。这些消息的 pricingModel 将为 CBP ，并且在状态消息 Webhook 中，效用类会话 ID 将分配给 conversation.id。一旦会话关闭，后续向该用户发送的效用类消息将遵循上述的新行为。

开始使用

指南

接口

Webhooks

2025 年 WhatsApp 定价迁移

定价说明

单条消息计费 Webhook

过渡期边界情况

​定价说明

​单条消息计费 Webhook

​过渡期边界情况

定价说明

单条消息计费 Webhook

过渡期边界情况