当前版本：v1.0

当微信产生消息或系统事件时，服务端会通过 HTTP POST（JSON）方式，将数据推送至开发者配置的回调地址。

本章节用于说明：

回调消息结构

各类型消息判断方式

字段含义解析

一、回调消息常见问题

Q. 微信在线为什么没有消息推送？

当回调消息未能成功推送时：

使用 Apifox 向回调地址发送测试请求；

若测试失败：

检查服务是否运行

检查端口 / 防火墙 / 网关

检查公网地址

若测试成功但微信无消息：

联系客服排查通道问题

Q. 如何判断是否是自己发送的消息？

判断逻辑：

$.Data.FromUserName.string == $.Wxid

说明：

相同：自己发送

不同：他人发送

Q. 为什么同一条消息会重复回调？

原因：

服务重启

历史消息同步

失败重试机制

解决方案（必须实现）：

去重Key = $.Appid + $.Data.NewMsgId

二、消息结构总览

所有消息统一结构：

字段说明：

字段	含义
TypeName	消息类型
Appid	设备ID
Wxid	当前微信账号
Data	消息主体

三、通用字段说明（Data）

字段	含义
MsgId	消息ID（旧）
NewMsgId	消息唯一ID（推荐使用）
MsgType	消息类型
FromUserName.string	发送人
ToUserName.string	接收人
Content.string	消息内容/XML
CreateTime	时间戳
PushContent	展示内容
MsgSource	附加信息
ImgBuf.buffer	base64数据（部分消息）

四、消息类型说明

1. 文本消息

判断：

$.Data.MsgType = 1

说明：

内容：$.Data.Content.string

2. 图片消息

判断：

$.Data.MsgType = 3

说明：

图片信息：Content.string（XML）

缩略图：ImgBuf.buffer（base64）

3. 语音消息

判断：

$.Data.MsgType = 34

说明：

下载信息：Content XML

base64：可能存在

4. 视频消息

判断：

$.Data.MsgType = 43

说明：

CDN信息在 XML 中

5. emoji 表情

判断：

$.Data.MsgType = 47

说明：

使用 XML 中 md5 发送表情

6. 地理位置

判断：

$.Data.MsgType = 48

7. 名片消息

判断：

$.Data.MsgType = 42

说明：

可用于添加好友

8. 好友请求

判断：

$.Data.MsgType = 37

说明：

FromUserName = fmessage

五、AppMsg 类型（核心）

统一判断：


    $.Data.MsgType = 49

1. 公众号链接

判断：


    msg.appmsg.type = 5

说明：

需结合 title 区分群邀请

2. 文件（发送中）

判断：

msg.appmsg.type = 74

说明：

仅通知

不可下载

3. 文件（发送完成）

判断：


    msg.appmsg.type = 6

说明：

可下载 / 转发

4. 小程序

判断：


    msg.appmsg.type = 33 / 36

5. 引用消息

判断：

msg.appmsg.type = 57

6. 转账

判断：

msg.appmsg.type = 2000

7. 红包

判断：

msg.appmsg.type = 2001

8. 视频号

判断：

msg.appmsg.type = 51

六、系统消息

撤回消息

判断：

$.Data.MsgType = 10002
sysmsg.type = revokemsg

拍一拍

判断：

$.Data.MsgType = 10002
sysmsg.type = pat

群公告

判断：

sysmsg.type = mmchatroombarannouncememt

群待办

判断：

sysmsg.type = roomtoolstips

被移除群聊

判断：

$.Data.MsgType = 10000

踢出群聊

判断：

sysmsg.type = sysmsgtemplate

解散群聊

判断：


    sysmsg.type = sysmsgtemplate

修改群名

判断：

$.Data.MsgType = 10000

更换群主

判断：

$.Data.MsgType = 10000

七、联系人与系统事件

联系人变更

TypeName = ModContacts

删除好友

TypeName = DelContacts

退出群聊


    TypeName = DelContacts

掉线


    TypeName = Offline

✅ 总结（开发者必须掌握）

先判断 MsgType

MsgType=49 再解析 XML

所有消息必须去重

XML 是核心（不要忽略）

NewMsgId 才是唯一ID

回调结构说明v1.0

一、回调消息常见问题#

Q. 微信在线为什么没有消息推送？#

Q. 如何判断是否是自己发送的消息？#

Q. 为什么同一条消息会重复回调？#

二、消息结构总览#

三、通用字段说明（Data）#

四、消息类型说明#

1. 文本消息#

2. 图片消息#

3. 语音消息#

4. 视频消息#

5. emoji 表情#

6. 地理位置#

7. 名片消息#

8. 好友请求#

五、AppMsg 类型（核心）#

1. 公众号链接#

2. 文件（发送中）#

3. 文件（发送完成）#

4. 小程序#

5. 引用消息#

6. 转账#

7. 红包#

8. 视频号#

六、系统消息#

撤回消息#

拍一拍#

群公告#

群待办#

被移除群聊#

踢出群聊#

解散群聊#

修改群名#

更换群主#

七、联系人与系统事件#

联系人变更#

删除好友#

退出群聊#

掉线#

✅ 总结（开发者必须掌握）#

一、回调消息常见问题

Q. 微信在线为什么没有消息推送？

Q. 如何判断是否是自己发送的消息？

Q. 为什么同一条消息会重复回调？

二、消息结构总览

三、通用字段说明（Data）

四、消息类型说明

1. 文本消息

2. 图片消息

3. 语音消息

4. 视频消息

5. emoji 表情

6. 地理位置

7. 名片消息

8. 好友请求

五、AppMsg 类型（核心）

1. 公众号链接

2. 文件（发送中）

3. 文件（发送完成）

4. 小程序

5. 引用消息

6. 转账

7. 红包

8. 视频号

六、系统消息

撤回消息

拍一拍

群公告

群待办

被移除群聊

踢出群聊

解散群聊

修改群名

更换群主

七、联系人与系统事件

联系人变更

删除好友

退出群聊

掉线

✅ 总结（开发者必须掌握）