跳转到主要内容
YCloud 通过 WhatsApp 消息更新 Webhook 提供按条计费的信息。本指南介绍订阅事件、计费字段、扣费规则以及消息价格何时最终确定。 YCloud 仅对出站 WhatsApp 消息(从您的企业发送给用户的消息)收费。入站消息免费。

1. 订阅事件

YCloud 通过 whatsapp.message.updated 事件发送消息状态和计费更新。可在 YCloud 控制台的 开发者 → Webhook 下进行订阅。 以下请求通过 API 创建订阅。端点参考请参阅创建 Webhook 端点:
url 指定 Webhook 接收端点。事件处理和签名验证请参阅 Webhook 集成指南。

2. 计费字段

计费信息包含在回调的 whatsappMessage 对象中: 其他字段请参阅获取消息。

3. 计费规则

3.1 价格确定性

YCloud 根据消息状态报告预估价格或最终价格: 对于最高价格(Max Price)营销消息,有效价格上限为模板 maxBid 乘以国家乘数和单条消息乘数。最终扣费请使用 delivered/read 状态下的 totalPrice。配置请参阅 Max Price 集成指南,完整回调查看 已送达竞价示例。

3.2 计费和免费计费类型

YCloud 通过 pricingType 报告以下三种计费类型: 自 2026 年 10 月 1 日起,每个商业电话号码的服务额度按月重置。未使用的额度不可结转,且一对一与群组服务消息共享相同的额度。额度耗尽后,一对一服务消息将采用 regular 计费,除非符合免费入口点规则。 自同日起,客户服务窗口内的效用模板消息不再仅仅因为窗口处于开启状态而免费,也不受服务额度覆盖。符合免费入口点计费条件的消息将继续使用 free_entry_point。 当用户在 Android 或 iOS 版 WhatsApp 上通过点击进入 WhatsApp 的广告或 Facebook 页面上的 WhatsApp 按钮向企业发送消息,且企业在 24 小时内回复时,将开启免费入口点窗口。该窗口自企业回复起持续 72 小时。WhatsApp 桌面端和网页端客户端不适用于此入口点规则。

4. Webhook 载荷示例

以下回调摘录表示一对一消息。ID 和扣费金额仅用于说明,并非实际费率报价。有关完整有效负载,请参阅 WhatsApp Message Updated Webhook Examples。

4.1 营销消息:计费

已送达的营销消息使用 regular 定价。说明性最终金额为 0.05 USD。

4.2 服务消息:计费

自 2026 年 10 月 1 日起,当商业电话号码已用尽其每月 1,000 条免费服务消息额度,且该消息不符合免费入口点定价资格时,YCloud 会报告 pricingType=regular。说明性最终金额为 0.01 USD。

4.3 服务消息:免费额度内

自 2026 年 10 月 1 日起,对于属于商业电话号码每月 1,000 条免费服务消息额度涵盖的消息,YCloud 会报告 pricingType=free_customer_service 且最终金额为 0。

4.4 免费入口点消息

对于在 72 小时免费入口点窗口内送达的消息,YCloud 会报告 pricingType=free_entry_point、pricingCategory=referral_conversion 以及最终金额 0。