消息订阅收发 - WTAPI开发文档

消息订阅与收发

Webhook 配置 · 接收约定 · 主动发送 · 常见问题

何时启用消息订阅？

需要实时监听私聊 / 群聊、做自动回复、群成员管控、入退群自动化时，必须配置消息订阅（回调）。仅主动调用发送接口、不关心接收事件时，可不配回调。

如何配置回调地址？

控制台：登录后进入 Token 回调 / 访问控制，填写公网 Webhook URL。
接口：调用登录模块「设置回调地址」（如 POST /finder/v2/api/login/setCallback），Body 常用字段含 token、callbackUrl。
绑定生效后，该 Token 下已登录微信实例收到的事件，会统一 POST 到该地址。

服务端回调开发规范

如何主动发送消息？

建议先拉取通讯录（好友 / 群）到本地，再调用消息模块对应发送接口。联调时先发给「文件传输助手」或自己的微信号。鉴权、appId 约定见「接入开发规范」。

如何接收消息并做自动回复？

配置全局回调 → 解析 TypeName / MsgType → 业务判断 → 再调发送接口回复。字段详解见「回调信息速览」「回调消息详解」。先打印原始 JSON 再建模，避免猜字段。

收不到推送时优先检查什么？