Webhook 事件回调

当您需要开发自动回复、入群欢迎、消息存档等功能时，需要配置「回调地址」。配置后，机器人收到的所有消息都会实时推送到您的服务器。

⚙️

如何配置回调地址？

您可以选择以下任意一种方式进行配置：

后台手动配置（推荐）

登录控制台 → 应用凭证 → 点击 [配置] 即可设置回调地址。

API 接口配置

调用设置回调地址接口进行程序化配置。

⚠️ 注意：配置成功后，该 Token 下登录的所有账号消息都会转发至此地址。

📋

开发要求与规范

为确保消息推送稳定，您的回调接口需满足以下条件：

⏱️

响应耗时

POST 请求（application/json）

必须在 3秒内 完成响应，否则系统会判定超时并丢弃该消息。

✅

响应内容

无需特定格式，直接返回空字符串或 HTTP 200 即可。

🌐

网络环境

必须发布在公网（第三方可访问）。测试环境建议使用内网穿透工具。

📬

消息范围

接收好友/群消息、手机端发送的消息；接口发送的消息不触发回调。

💡

调试小贴士

验证请求

配置成功后，系统会立即向您的接口发送一条包含 验证回调地址是否可用 的 JSON 数据。若收到此消息，说明配置成功。

排查失败

若提示「验证失败」，请先使用 Apifox 或 Postman 手动模拟 POST 请求，确认您的接口在公网环境下可以正常访问。

打印日志

开发初期，建议直接打印请求的 Body 体，这是了解消息结构最快的方法。

✅ 回调配置完成后，您可以在调试指南页面查看如何测试回调是否正常工作。

Webhook事件⭐

Webhook 事件回调#

如何配置回调地址？#

后台手动配置（推荐）#

API 接口配置#

开发要求与规范#

响应耗时#

响应内容#

网络环境#

消息范围#

调试小贴士#

验证请求#

排查失败#

打印日志#