消息回调
消息回调说明
1.
2.
3.
消息格式
{
"appId": "消息所属设备的AppId",
"wxid": "接收消息微信账号的wxid",
"msgFlag": "消息类型，目前支持AddMsg|ModContact|DelContact",
"msgData": "消息具体数据，不同类型消息的数据结构不同"
}AddMsg消息
消息格式
{
"msg_type": 1,
"from_user_name": {
"str": "发送人wxid"
},
"to_user_name": {
"str": "接收人wxid"
}
"content": {
"str": "消息内容"
},
"new_msg_id": 5671465775673464000,
"msg_id": 1135049119,
"msg_seq": 817202053,
"create_time": 1780293948,
"img_buf": {
"len": 0
},
"img_status": 1,
"msg_source": "<msgsource>\n\t<pua>1</pua>\n\t<eggIncluded>1</eggIncluded>\n\t<silence>1</silence>\n\t<membercount>87</membercount>\n\t<signature>N0_V1_z3Eas3gN|v1_VY9XpTw+</signature>\n\t<tmp_node>\n\t\t<publisher-id></publisher-id>\n\t</tmp_node>\n</msgsource>\n",
"status": 3,
}消息排重
如何判断是否自己发的消息
如何判断群消息和发送人
发送人wxid:内容 的形式，可用来解析发送人AddMsg 部分消息类型及标志
| 类型 | 标志 | 消息内容 |
|---|---|---|
| 文本消息 | msg_type = 1 | 从 content.str 里取消息内容 |
| 图片消息 | msg_type = 3 | 从 content.str 里取 xmlmsg, img_buf.buffer 里取缩略图数据 |
| 语音消息 | msg_type = 34 | 从 content.str 里取 xmlmsg；短语音数据可以直接从 img_buf.buffer 里取到，长语音取不到，需另行下载 |
| 视频消息 | msg_type = 43 | 从 content.str 里取 xmlmsg |
| 链接消息 | msg_type = 49, xmlmsg 中 appmsg.type = 5 | 从 content.str 里取 xmlmsg |
| 文件消息 | msg_type = 49, xmlmsg 中 appmsg.type = 6 | 从 content.str 里取 xmlmsg |
| 聊天记录 | msg_type = 49, xmlmsg 中 appmsg.type = 19 | 从 content.str 里取 xmlmsg |
| 小程序消息 | msg_type = 49, xmlmsg 中 appmsg.type = 33 | 从 content.str 里取 xmlmsg |
| 视频号消息 | msg_type = 49, xmlmsg 中 appmsg.type = 51 | 从 content.str 里取 xmlmsg |
| 引用消息 | msg_type = 49, xmlmsg 中 appmsg.type = 57 | 从 content.str 里取 xmlmsg |
| 群公告 | msg_type = 49, xmlmsg 中 appmsg.type = 87 | 从 content.str 里取 xmlmsg |
| 转账消息 | msg_type = 49, xmlmsg 中 type = 2000 | 从 content.str 里取 xmlmsg |
| 红包消息 | msg_type = 49, xmlmsg 中 type = 2001 | 从 content.str 里取 xmlmsg |
| 表情动画 | msg_type = 47 | 从 content.str 里取 xmlmsg |
| 位置消息 | msg_type = 48 | 从 content.str 里取 xmlmsg |
| 名片消息 | msg_type = 42 | 从 content.str 里取 xmlmsg |
| 加好友请求 | msg_type = 37 | 从 content.str 里取 xmlmsg |
| 消息撤回 | msg_type = 10002, xmlmsg 中 sysmsg.type = "revokemsg" | 从 content.str 里取 xmlmsg |
| 群拍一拍 | msg_type = 10002, xmlmsg 中 sysmsg.type = "pat" | 从 content.str 里取 xmlmsg |
ModContact 消息
{
"addContactScene": 0,
"additionalContactList": {
"item": {}
},
"albumFlag": 0,
"albumStyle": 0,
"bigHeadImgUrl": "大尺寸头像",
"bitMask": 4294967295,
"bitVal": 3,
"chatRoomNotify": 0,
"chatroomAccessType": 0,
"chatroomInfoVersion": 0,
"chatroomMaxCount": 0,
"chatroomStatus": 0,
"chatroomVersion": 0,
"city": "Changping",
"contactType": 0,
"country": "CN",
"customizedInfo": {
"brand_flag": 0
},
"deleteContactScene": 0,
"deleteFlag": 0,
"domainList": {},
"encryptUserName": "v3_020b3826fd03010000000000f2be13fd86767b000000501ea9a3dba12f95f6b60a0536a1adb6752fb86c5864dc33b388282b89c7632d6c018326c1328cae00d9cc4b7d04546546118fc56e745288bf1df6f5de@stranger",
"extFlag": 0,
"hasWeiXinHdHeadImg": 1,
"imgBuf": {
"len": 0
},
"imgFlag": 1,
"level": 1,
"newChatroomData": {
"info_mask": 0,
"member_count": 0,
"unknow": {}
},
"nickName": {
"str": "昵称"
},
"personalCard": 1,
"phoneNumListInfo": {
"count": 0
},
"province": "Beijing",
"pyinitial": {
"str": "xxx"
},
"quanPin": {
"str": "xxx"
},
"remark": {},
"remarkPyinitial": {},
"remarkQuanPin": {},
"roomInfoCount": 0,
"sex": 1,
"smallHeadImgUrl": "小尺寸头像",
"snsUserInfo": {
"sns_bgimg_id": "",
"sns_bgobject_id": 12417959280734180000,
"sns_flag": 1,
"sns_flagex": 2689,
"sns_privacy_recent": 0
},
"source": 1000015,
"userName": {
"str": "wxid"
},
"verifyFlag": 0,
"weiboFlag": 0
}DelContact 消息
{
"deleteContactScene": 0,
"userName": {
"str": "好友或群的id"
}修改于 2026-06-15 07:21:54