Webhook 事件 ⭐

Q：什么时候需要消息订阅服务？

当业务涉及消息交互（如自动回复、群管理等）时，需要使用消息订阅服务。

通过订阅消息回调，您可以实时获取：

• 群消息内容
• 好友消息内容

并基于消息内容执行对应操作，例如：自动回复、踢人、拉人等。

Q：回调服务怎么配置？

1. 登录 API 后台系统
2. 进入「访问控制」
3. 填写并保存您的回调地址

配置成功后，该 Token 下所有已登录的微信机器人在接收到消息时，都会自动转发到您设置的回调地址。

Q：回调接口有哪些要求？

• 回调方式：以 POST（application/json）发送至您配置的回调地址
• 调试建议：直接打印请求 Body，即可查看完整消息结构
• 响应要求：必须在 3 秒内返回，否则本次回调将被丢弃（可返回空字符串）

回调行为说明

• 接口发送的消息 不会触发回调（回调仅用于接收消息）
• 手机端发送的消息 会触发回调（属于多端同步行为）

验证机制

• 配置成功后，系统会发送一条内容为“验证回调地址是否可用”的回调请求
• 若验证失败，请确认：
  • 回调接口是否已部署至公网
  • 接口是否可正常访问（可使用 Apifox 进行测试）

注意事项

• 回调接口必须为公网可访问地址
• 内网穿透仅建议用于临时测试（可能存在延迟或丢消息风险）

若需查看各类回调字段说明，请参考 回调结构说明