当前版本：v2.0

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

本章节用于说明：

回调消息结构

各类型消息判断方式

字段含义解析

一、回调消息常见问题

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

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

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

若测试失败：

检查服务是否运行

检查端口 / 防火墙 / 网关

检查公网地址

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

联系客服排查通道问题

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

判断逻辑：

$.isSelf == true

说明：

相同：自己发送

不同：他人发送

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

原因：

服务重启

历史消息同步

失败重试机制

解决方案（必须实现）：

去重Key = $.appid + $.newMsgId

二、消息结构总览

所有消息统一结构：

字段说明：

字段	含义
msgType	消息类型
appid	设备ID
wxid	当前微信账号
content	消息内容

三、通用字段说明（Data）

字段	含义
msgId	消息ID（旧）
newMsgId	消息唯一ID（推荐使用）
msgType	消息类型
fromUser	发送人
toUser	接收人
content	消息内容/XML
createTime	时间戳

四、消息类型说明

1. 文字消息

判断：

$.msgType = TEXT

2. 图片消息

判断：

$.msgType = IMAGE

3. 语音消息

判断：

$.msgType = VOICE

4. 视频消息

判断：

$.msgType = VIDEO

5. 表情消息

判断：

$.msgType = EMOJI

6. 位置消息

判断：

$.msgType = LOCATION

7. 名片消息

判断：

$.msgType = CARD

8. 好友验证消息

判断：

$.msgType = FRIEND_VERIFY

9. 好友确认消息

判断：

$.msgType = FRIEND_CONFIRM

10. 文件消息

判断：

$.msgType = FILE

11. 链接消息

判断：

$.msgType = LINK

12. 小程序消息

判断：

$.msgType = MINI_PROGRAM

13. 视频号消息

判断：

$.msgType = FINDER_FEED

14. 引用消息

判断：

$.msgType = QUOTE

15. 群公告消息

判断：

$.msgType = ANNOUNCEMENT

16. 转账消息

判断：

$.msgType = TRANSFER

17. 红包消息

判断：

$.msgType = RED_PACKET

18. 群聊邀请消息

判断：

$.msgType = GROUP_INVITE

19. 聊天记录消息

判断：

$.msgType = CHAT_RECORD

20. 其他应用消息

判断：

$.msgType = APP_MSG

21. 下载文件消息

判断：

$.msgType = DOWNLOAD

22. 上传文件消息

判断：

$.msgType = UPLOAD

23. 被移出群聊消息

判断：

$.msgType = REMOVE_FROM_GROUP

24. 群解散消息

判断：

$.msgType = GROUP_DISMISS

25. 修改群名称消息

判断：

$.msgType = GROUP_NAME_CHANGE

26. 群待办消息

判断：

$.msgType = GROUP_TODO

27. 撤回消息

判断：

$.msgType = REVOKE_MSG

28. 拍一拍消息

判断：

$.msgType = PAT_MSG

29. 其他系统消息

判断：

$.msgType = SYSTEM

30. 重连成功消息

判断：

$.msgType = RECONNECT_SUCCESS

31. 长链开启成功消息

判断：

$.msgType = LONG_SUCCESS

32. 重连失败消息

判断：

$.msgType = RECONNECT_FAIL

33. 长链开启失败消息

判断：

$.msgType = LONG_FAIL

34. 登录异常消息

判断：

$.msgType = LOGIN_ERROR

35. 退出微信消息

判断：

$.msgType = LOGOUT

36. 登录成功消息

判断：

$.msgType = LOGIN_SUCCESS

37. 长链开启通知消息

判断：

$.msgType = Long_Serve_Start_Success

38. 长链关闭通知消息

判断：

$.msgType = Long_Serve_Close

39. 未知类型消息

判断：

$.msgType = UNKNOWN

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

先判断 MsgType

MsgType=49 再解析 XML

所有消息必须去重

XML 是核心（不要忽略）

NewMsgId 才是唯一ID

回调结构说明 v2.0

一、回调消息常见问题#

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

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

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

二、消息结构总览#

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

四、消息类型说明#

1. 文字消息#

2. 图片消息#

3. 语音消息#

4. 视频消息#

5. 表情消息#

6. 位置消息#

7. 名片消息#

8. 好友验证消息#

9. 好友确认消息#

10. 文件消息#

11. 链接消息#

12. 小程序消息#

13. 视频号消息#

14. 引用消息#

15. 群公告消息#

16. 转账消息#

17. 红包消息#

18. 群聊邀请消息#

19. 聊天记录消息#

20. 其他应用消息#

21. 下载文件消息#

22. 上传文件消息#

23. 被移出群聊消息#

24. 群解散消息#

25. 修改群名称消息#

26. 群待办消息#

27. 撤回消息#

28. 拍一拍消息#

29. 其他系统消息#

30. 重连成功消息#

31. 长链开启成功消息#

32. 重连失败消息#

33. 长链开启失败消息#

34. 登录异常消息#

35. 退出微信消息#

36. 登录成功消息#

37. 长链开启通知消息#

38. 长链关闭通知消息#

39. 未知类型消息#

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