消息回调配置

消息回调配置用于把微信实例收到的消息推送到你的业务系统。先设置一个可公网访问的 HTTP 地址，再按回调字段解析文本、图片、文件、群聊和系统事件。

接入前确认

检查项	说明
回调地址可访问	平台必须能从公网访问你的 HTTP / HTTPS 地址
服务快速响应	回调接口只做校验、入队和返回，耗时业务异步处理
幂等处理	使用 newMsgId 或业务唯一键排重，避免重复触发
本地联调	没有服务器时，先用临时公网地址测试回调格式

常用接口

接口	用途
设置 HTTP 回调地址	配置消息推送地址
取消消息接收	停止向当前地址推送消息
回调字段释义	查看优化版回调结构
原生消息释义	查看原生回调字段
Webhook 本地联调	没有公网服务器时临时测试

排查入口

• 收不到回调：先确认回调地址公网可访问，路径和协议完整。
• 回调重复：业务系统必须按消息 ID 做幂等。
• 主动发送无回调：这是正常现象，只有对方或群成员发来的消息才会触发回调。