摘要
Wati 中的 Webhook 允许您通过将事件数据发送到您的服务器来接收有关消息及其状态的实时更新。本指南介绍了您可以跟踪哪些事件、如何设置 webhook 以及基于会话的回调如何工作，以便您可以可靠地处理系统中的消息活动。
操作说明
Webhooks 可以捕获哪些事件？
当发生以下事件时，Wati webhook 可以通知您的系统：
收到的消息
已发送的消息（模板消息和会话消息）
消息状态更新：
已发送
已送达
已读
这些事件作为回调负载发送到您配置的 webhook URL。
如何在 Wati 中添加 webhook
请按照以下步骤设置 webhook：
登录到您的 Wati 仪表板。
转到连接器，然后在顶部导航菜单中单击 Webhooks。
单击添加 Webhook。
输入您的完整 webhook URL。
将状态设置为已启用。
选择你要捕获的事件。
单击保存。
如何测试您的 webhook
添加 webhook 后，您可以测试连接：
使用触发示例回调选项。
Wati 将向您的 webhook URL 发送一个示例负载。
验证您的服务器是否正确接收和处理该负载。
了解基于会话的 webhook
在 WhatsApp Business API 中，对话被跟踪为 24 小时会话。会话在传送商业消息时开始。
会话类型
活跃会话
企业和客户至少交换了一条消息。
示例：企业发送模板消息，客户回复。
非活跃会话
只有一方发送了消息，另一方没有回应。
示例：企业发送模板消息，但客户没有回复。
注意：Webhook 回调可能会根据会话是处于活动状态还是非活动状态而有所不同。
Webhook 响应和重试逻辑
为确保可靠的传递，您的 webhook 必须正确响应。
您的服务器必须返回
200 OK响应，以确认已收到该事件。
如果未收到
200响应：Wati 会重试发送该事件。
可以重试最多 144 次。
重试尝试以 10 分钟的间隔运行。
如果超过 100 次连续失败：
该 webhook 被标记为有缺陷。
您将收到一封电子邮件通知。
如果所有重试尝试都失败，则将不再发送该事件。
最佳实践
确保您的 webhook 端点始终可用并响应迅速。
记录传入的负载，以便于调试。
处理重复的事件，因为重试可能会多次发送相同的负载。
验证传入的请求，以确保它们来自 Wati。
此设置可帮助您使系统与 Wati 中的实时消息活动保持同步。
常见问题解答 (FAQ)
Webhooks 概述
1. Wati 中的 webhooks 有什么作用？
Wati 中的 Webhooks 通过将事件数据传送到配置的 webhook URL，向您的服务器发送有关消息及其状态的实时更新。
2. Wati webhooks 可以捕获哪些类型的事件？
Wati webhooks 可以捕获以下事件：
收到的消息
已发送的消息（模板消息和会话消息）
消息状态更新，包括已发送、已送达和已读
Webhook 设置和测试
3. 如何在 Wati 中添加和测试 webhook？
在 Wati 中添加和测试 webhook：
登录到您的 Wati 仪表板。
转到连接器，然后单击 Webhooks。
单击添加 Webhook。
输入您的 webhook URL 并将状态设置为已启用。
选择您要捕获的事件，然后单击保存。
使用触发示例回调选项发送示例负载。
验证您的服务器是否正确接收和处理该负载。
基于会话的 webhooks
4. 什么是 WhatsApp Business API 中的会话？
会话是一个 24 小时的对话窗口，当传送商业消息时开始。
5. 活跃会话和非活跃会话有什么区别？
当企业和客户至少交换了一条消息时，会发生活跃会话。当只有一方发送了消息而另一方没有回复时，会发生非活跃会话。
Webhook 可靠性和重试
6. 您的服务器必须返回什么响应才能成功传递 webhook？
您的服务器必须返回 200 OK 响应才能确认已收到 webhook 事件。
7. 如果您的服务器未返回 200 OK 响应会发生什么？
如果您的服务器未返回 200 OK 响应，Wati 会在 10 分钟的时间间隔内重试发送该事件最多 144 次。
8. 如果 webhook 传送一直失败会发生什么？
如果超过 100 次连续失败，则 webhook 会被标记为有缺陷，并发送一封电子邮件通知。如果所有重试尝试都失败，则将不再发送该事件。
最佳实践
9. 如何确保可靠的 webhook 处理？
为确保可靠的 webhook 处理：
使您的 webhook 端点保持可用并响应迅速
记录传入的负载以进行调试
处理重复的事件，因为重试可能会多次发送相同的负载
验证传入的请求以确认它们来自 Wati