Webhook事件⭐ - QiWe开放平台

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

如何配置回调地址？

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

方式一：后台手动配置 (推荐)
登录管理后台 -> Token中心 -> 点击 [设置回调地址]。

方式二：API 接口配置
调用设置回调地址接口进行远程配置。

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

开发要求与规范

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

要求项	描述
请求方式	POST (`application/json`)
响应耗时	必须在 3秒内完成响应，否则系统会判定超时并丢弃该消息。
响应内容	无需特定格式，直接返回空字符串或 HTTP 200 即可。
网络环境	必须发布在公网（第三方可访问）。测试环境建议使用内网穿透工具。
消息范围	接收好友/群消息、手机端发送的消息（多端同步）；接口发送的消息不触发回调。

调试小贴士

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

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

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