消息回调配置

消息回调把微信实例收到的消息推送到你的业务系统。先在控制台应用凭证页「收进来」填一个公网能访问的地址，再按回调字段解析文本、图片、文件、群聊和系统事件。

接入前确认

检查项	说明
回调地址可访问	Eyun 必须能从公网访问你的 HTTP / HTTPS 地址
尽快返回	回调接口只做校验、保存和返回，耗时业务放后台处理
去重	控制台配置的地址按请求头 X-Eyun-Event-Id 去重，消息按账号与 newMsgId 去重
本地联调	没有服务器时，先在「收进来」点「开始实时查看」看推送原文，或用临时公网地址测试

常用接口

接口	用途
设置回调地址	在控制台或用兼容接口配置推送地址，以及来源校验
取消回调地址	停止向当前地址推送消息
回调字典（优化版）	查看优化版回调结构
回调字典（原生版）	查看原生回调字段
Webhook 本地联调	没有公网服务器时临时测试

排查入口

• 收不到回调：先确认回调地址公网可访问，路径和协议完整。
• 回调重复：按上面的去重规则处理，同一事件只处理一次。
• 主动发送无回调：这是正常现象，只有对方或群成员发来的消息才会触发回调。