Skip to content

收发送消息说明

当前55消息类型对照表如下:

消息类型值文案常量名备注
0文本MESSAGE_TYPE_TEXT普通文本消息
1图片MESSAGE_TYPE_IMAGE单张图片
2语音MESSAGE_TYPE_VOICE语音消息
3视频MESSAGE_TYPE_VIDEO视频消息
4位置MESSAGE_TYPE_LOCATION位置消息
5名片MESSAGE_TYPE_NAMECARD好友/群名片
6系统消息MESSAGE_TYPE_SYSTEM系统消息
7文件MESSAGE_TYPE_FILE文件消息
8通知MESSAGE_TYPE_NOTICE系统通知
9动画表情MESSAGE_TYPE_DYNAMIC_IMAGEGIF/动态表情
10红包MESSAGE_TYPE_REDPACKET普通红包
11HTMLMESSAGE_TYPE_HTMLHTML 消息
12骰子MESSAGE_TYPE_SETIMAGE游戏骰子
13暂不支持该消息类型MESSAGE_TYPE_CHAT_TRANSFER转账消息(未支持显示)
14转账结果MESSAGE_TYPE_CHAT_TRANSFER_RESULT转账结果通知
15红包结果MESSAGE_TYPE_REDPACKET_RESULT红包领取结果
16HTML2MESSAGE_TYPE_HTML2HTML 消息(备用)
17图片列表MESSAGE_TYPE_IMAGE_LIST多图消息
18扑克牌MESSAGE_TYPE_ANIMATED_GAME扑克牌动画
19红包变化MESSAGE_TYPE_REDPACKET_CHANGE红包金额变化
20红包事件MESSAGE_TYPE_REDPACKET_EVENT红包相关事件
100流媒体MESSAGE_TYPE_STREAM流媒体消息
101-104系统提示MESSAGE_TYPE_SYSTEM_TIP / MESSAGE_TYPE_GROUP_TIP群提示或系统提示消息
201撤回成功MESSAGE_TYPE_RECALL_SUCCESS消息撤回成功提示
202错误提示MESSAGE_TYPE_ERROR_TIP系统错误提示
203撤回消息MESSAGE_TYPE_RECALL消息撤回
-1未知消息MESSAGE_TYPE_UNKNOW未知类型消息
-2未解密消息MESSAGE_TYPE_UNDECRYPT加密或未解密消息

发送消息

检测消息是否发送成功

⚠️消息发送失败时,websocket会回调readStatus: 0

json
{
	"operator": "msgListPropertyUpdate",
	"data": {
		"id": 389284,
		"type": "group",
		"list": [
			{
				"customMsgId": "30984532587",
				"updated": {
					"readStatus": 0               
				}
			}
		],
		"readStatus": 0  
	}
}

✅发送成功时,回调readStatus: 1

json
{
	"operator": "msgListPropertyUpdate",
	"data": {
		"id": 389284,
		"type": "group",
		"list": [
			{
				"customMsgId": "10441859254",
				"updated": {
					"MsgID": 4667081534,
					"readStatus": 1,
					"time": "1766222907461",
					"sendTime": "1766222907461"
				}
			}
		],
		"readStatus": 1   
	}
}

发送消息给好友

json
{
    "id": "webscoket消息id",
    "type": "sendMsg", 
    "data": {
        "id": 7237423, 
        "type": "friend", 
        "list": [
            {
                "type": "text", 
                "values": {
                    "chatType": 0, 
                    "content": "这里改成你的消息"
                }
            }
        ], 
        "quoteInfo": null
    }
}

发送消息到群组

json
{
  "id": "webscoket消息id",
  "type": "sendMsg",
  "data": {
    "id": 389284,
    "type": "group",
    "list": [
      {
        "type": "text",
        "values": {
          "chatType": 0,
          "content": "这里改成你的消息"
        }
      }
    ],
    "quoteInfo": null
  }
}

发送文件

json
{
    "id": "1",
    "type": "sendFile",
    "data": {
        "file": "C:/Users/rtuge/Desktop/b.mp4",  👈文件绝对路径
        "type": "group",                         👈如果是私聊填 'friend'
        "id": 389284                             👈对应群组或者好友id
    }
}

收取消息

新的文字消息

json
{
	"operator": "msgNew",
	"data": {
		"msgType": 0,
		"atUids": [],
		"atUsers": [],
		"links": [],
		"sendUid": 4008697,
		"groupId": 389284,
		"content": "[微笑]",
		"sendTime": 1766282269132,
		"msgId": 4688172503,
		"sendMember": {
			"user": {
				"uid": "4008697",
				"nickName": "ID采集机器人🤖",
				"icon": "http://r11.aiolet.xyz/common/pic/202507/27/44eff667aad9eaa434a0af55d9cd4048.jpg",
				"signature": "专业定制各类聊天软件自动化机器人",
				"identify": "--",
				"createTime": "1746527494000"
			},
			"groupId": "389284",
			"type": "MANAGE",
			"score": "1135394003000",
			"right": {
				"bfUpdateData": true,
				"bfJoinCheck": true,
				"bfPushNotice": true
			}
		},
		"contentMd5": "252049bb117c5bd3c77cac9051f1d198",
		"groupName": "huimei",
		"sentOverTime": 1766282269132,
		"customMsgId": "70790767392",
		"MsgID": 4688172503,
		"UserID": 4008697,
		"isSelf": true,
		"ChatType": 0,
		"chatType": 0,
		"id": 389284,
		"name": "huimei",
		"readStatus": 1,
		"time": 1766282269132,
		"type": "group",
		"user": {
			"uid": "4008697",
			"nickName": "ID采集机器人🤖",
			"icon": "http://r11.aiolet.xyz/common/pic/202507/27/44eff667aad9eaa434a0af55d9cd4048.jpg",
			"signature": "专业定制各类聊天软件自动化机器人",
			"identify": "--",
			"createTime": "1746527494000"
		}
	}
}

新的图片消息

json
{
	"operator": "msgNew",
	"data": {
		"msgType": 1,
		"atUids": [],
		"atUsers": [],
		"links": [],
		"sendUid": 4008697,
		"groupId": 389284,
		"content": "http://r11.aiolet.xyz/chat/pic/202512/21/2e11f6748829b59e3f11f9e1f71ccc10.jpeg||http://r11.aiolet.xyz/chat/pic/202512/21/48b807c116ffe851c96d43897e9813eb.jpeg||20310||0",
		"sendTime": 1766282182859,
		"msgId": 4688146125,
		"sendMember": {
			"user": {
				"uid": "4008697",
				"nickName": "ID采集机器人🤖",
				"icon": "http://r11.aiolet.xyz/common/pic/202507/27/44eff667aad9eaa434a0af55d9cd4048.jpg",
				"signature": "专业定制各类聊天软件自动化机器人",
				"identify": "--",
				"createTime": "1746527494000"
			},
			"groupId": "389284",
			"type": "MANAGE",
			"score": "1135394003000",
			"right": {
				"bfUpdateData": true,
				"bfJoinCheck": true,
				"bfPushNotice": true
			}
		},
		"contentMd5": "cc5c7d12c19bc3abe180f319197152f9",
		"groupName": "huimei",
		"sentOverTime": 1766282182859,
		"customMsgId": "10782894930",
		"MsgID": 4688146125,
		"UserID": 4008697,
		"isSelf": true,
		"ChatType": 1,
		"chatType": 1,
		"id": 389284,
		"name": "huimei",
		"fileKey": "fg187h7vj9wwsi42",
		"readStatus": 1,
		"time": 1766282182859,
		"type": "group",
		"user": {
			"uid": "4008697",
			"nickName": "ID采集机器人🤖",
			"icon": "http://r11.aiolet.xyz/common/pic/202507/27/44eff667aad9eaa434a0af55d9cd4048.jpg",
			"signature": "专业定制各类聊天软件自动化机器人",
			"identify": "--",
			"createTime": "1746527494000"
		}
	}
}

新的文件消息

json
{
	"operator": "msgNew",
	"data": {
		"msgType": 7,
		"atUids": [],
		"atUsers": [],
		"links": [],
		"sendUid": 4008697,
		"groupId": 389284,
		"content": "http://r11.aiolet.xyz/chat/file/202512/21/e158596ff68fd6a4669a7a7f02283a61.xml||ui.xml||11994",
		"sendTime": 1766282345669,
		"msgId": 4688196815,
		"sendMember": {
			"user": {
				"uid": "4008697",
				"nickName": "ID采集机器人🤖",
				"icon": "http://r11.aiolet.xyz/common/pic/202507/27/44eff667aad9eaa434a0af55d9cd4048.jpg",
				"signature": "专业定制各类聊天软件自动化机器人",
				"identify": "--",
				"createTime": "1746527494000"
			},
			"groupId": "389284",
			"type": "MANAGE",
			"score": "1135394003000",
			"right": {
				"bfUpdateData": true,
				"bfJoinCheck": true,
				"bfPushNotice": true
			}
		},
		"contentMd5": "903b2ddcb647933ba7ba0afa182cc381",
		"groupName": "huimei",
		"sentOverTime": 1766282345669,
		"customMsgId": "10735110335",
		"MsgID": 4688196815,
		"UserID": 4008697,
		"isSelf": true,
		"ChatType": 7,
		"chatType": 7,
		"id": 389284,
		"name": "huimei",
		"fileKey": "rpon4f3vp33bzh7h",
		"readStatus": 1,
		"fileName": "ui.xml",
		"fileSize": "11994",
		"size": "11994",
		"time": 1766282345669,
		"type": "group",
		"user": {
			"uid": "4008697",
			"nickName": "ID采集机器人🤖",
			"icon": "http://r11.aiolet.xyz/common/pic/202507/27/44eff667aad9eaa434a0af55d9cd4048.jpg",
			"signature": "专业定制各类聊天软件自动化机器人",
			"identify": "--",
			"createTime": "1746527494000"
		}
	}
}

🎲骰子消息

content内容解释

骰子消息由点数随机数构成

content点数
1||49672010571
2||49671926622
3||49671835133
4||49672342233
5||49672087093
6||49672652403
{
	"operator": "msgNew",
	"data": {
		"msgType": 12,
		"atUids": [],
		"atUsers": [],
		"links": [],
		"sendUid": 4008697,
		"groupId": 389284,
		"content": "1||4966349477",
		"sendTime": 1767006189933,
		"msgId": 4966349477,
		"sendMember": {
			"user": {
				"uid": "4008697",
				"nickName": "unknown",
				"icon": "http://r22.aiolet.xyz/common/pic/202512/29/35c3fd5007037906fdb972b6cd3d5ce1.jpg",
				"identify": "--",
				"createTime": "1746527494000"
			},
			"groupId": "389284",
			"type": "MANAGE",
			"score": "1135394003000",
			"right": {
				"bfUpdateData": true,
				"bfJoinCheck": true,
				"bfPushNotice": true
			}
		},
		"contentMd5": "7df4984661841fc912d7d62d59f71124",
		"groupName": "huimei",
		"sentOverTime": 1767006189933,
		"customMsgId": "60986865605",
		"MsgID": 4966349477,
		"UserID": 4008697,
		"isSelf": true,
		"ChatType": 12,
		"chatType": 12,
		"id": 389284,
		"name": "huimei",
		"readStatus": 1,
		"time": 1767006189933,
		"type": "group",
		"user": {
			"uid": "4008697",
			"nickName": "unknown",
			"icon": "http://r22.aiolet.xyz/common/pic/202512/29/35c3fd5007037906fdb972b6cd3d5ce1.jpg",
			"identify": "--",
			"createTime": "1746527494000"
		}
	}
}

文档基于 55 助手整理