使用 Webhooks 实时追踪对话

本指南介绍了如何使用 Webhooks 预估给定账单周期的对话总量。

开始阅读本指南之前，请确保您已了解 WhatsApp Business 开放平台专用 Webhooks。

使用编号追踪对话

只要商家在现有对话会话以外的时间给用户发送消息，系统就会生成对话编号。在带有此对话编号的第一条商家消息送达之后，系统便会发起为期 24 小时的对话会话，并收取费用。

消息发出和送达之间可能会有延迟，原因之一可能是用户手机在消息送达时处于关机状态。发生延迟时，对话处理方式如下：系统会在消息发出后“预先开启”对话会话，并将对应的对话编号与之关联。等消息送达后，对话会话的开始时间就会刷新。

下方插图介绍了一个极端示例。大部分消息会在发出后几秒内送达。

在发出后 30 天内都未送达的消息会遭到丢弃。如果对话编号来源于已发送但未送达的消息，则无需为相应对话支付费用。

如要预估成本，您需要 2 项信息：收信人的国家/地区代码以及对话类别。国家/地区代码和对话类别会共同用于确定费率。您可以在此处下载各个价目表。

如要了解特定对话的类别，请查看您 Webhooks 通知中的 pricing 对象。如需详细了解如何在 Webhooks 中识别对话类型，可以查看状态和定价通知。

获取对话类别和收信人的国家/地区代码后，计算 Webhooks 通知确认已送达的唯一对话编号的数量，从而计算账单周期内的对话总数。如果与对话编号关联的 Webhooks 通知仅有“已发送”消息状态，则无需为相应对话付费。

Total conversations per billing period

=

Number of unique conversation IDs associated with a webhook with status="delivered" and/or status="read" in that billing period.

在一些情况下，您可能只会收到“已读”或“已送达”状态的通知。这两种通知都可确认您的消息已经送达。在大部分情况下，您会同时收到已读回执和已送达回执。

如果对话跨越两个账单周期，则在对话进入第二个账单周期时，不会再产生额外费用。对话费用的账单周期由对话中第一条商家消息的送达时间戳决定（以 WhatsApp Business 商业帐号的时区为准）。

Webhooks 是实时追踪对话指标的最佳工具。