> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 2025 年 WhatsApp 定价迁移
> 2025 年 7 月历史单条消息计费规则、回调字段、示例及过渡期特殊情况。
历史参考：这些规则说明了 2025 年 7 月 1 日向
单条消息计费的迁移，在各 WABA 所在时区的午夜生效。它们
不会取代[当前定价规则](/zh/documentation/pricing-and-billing/whatsapp-pricing-and-billing)
或[当前定价集成指南](/zh/api-reference/guides/whatsapp-platform/whatsapp-message-pricing-integration-guide)。
特别是服务额度和效用类消息规则已于
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](/zh/api-reference/guides/examples/webhook-examples/whatsapp-message-updated-webhook-examples)将实施以下变更：
* 修改现有的 conversation 字段
* 添加新的计费相关字段
**Webhook 参数变更规范**
| 字段名称 | 数据类型 | 描述 |
| - | - | - |
| pricingModel | String | 新属性。可能的值包括： \* `"PMP"`——表示适用单条消息计费。 \* `"CBP" `——表示适用基于会话的计费。 |
| pricingType | String | 新属性。仅在 PMP（单条消息计费）模式下提供。可能的值包括： \* `regular` ——表示该消息计费。 \* `free_customer_service` ——表示该消息免费，原因是其为在客户服务窗口内发送的效用类消息模板或非模板消息。 \* `free_entry_point `——表示该消息免费，原因是其属于免费入口点会话的一部分。 |
| whatsappMessage.conversation | Object | 在 PMP（单条消息计费）模式下，将不再返回 conversation 对象。 |
**CBP 模式 Webhook 示例**
```shell theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"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 示例**
```shell theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"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。一旦会话关闭，后续向该用户发送的效用类消息将遵循上述的新行为。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.