消息事件

私聊消息

事件数据

字段名 数据类型 可能的值 说明
time number (int64) - 事件发生的时间戳
self_id number (int64) - 收到事件的机器人 QQ 号
post_type string message 上报类型
message_type string private 消息类型
sub_type string friendgroupother 消息子类型,如果是好友则是 friend,如果是群临时会话则是 group
message_id number (int32) - 消息 ID
user_id number (int64) - 发送者 QQ 号
message message - 消息内容
raw_message string - 原始消息内容
font number (int32) - 字体
sender object - 发送人信息

其中 sender 字段的内容如下:

字段名 数据类型 说明
user_id number (int64) 发送者 QQ 号
nickname string 昵称
sex string 性别,malefemaleunknown
age number (int32) 年龄

需要注意的是,sender 中的各字段是尽最大努力提供的,也就是说,不保证每个字段都一定存在,也不保证存在的字段都是完全正确的(缓存可能过期)。

快速操作

字段名 数据类型 说明 默认情况
reply message 要回复的内容 不回复
auto_escape boolean 消息内容是否作为纯文本发送(即不解析 CQ 码),只在 reply 字段是字符串时有效 不转义

群消息

事件数据

字段名 数据类型 可能的值 说明
time number (int64) - 事件发生的时间戳
self_id number (int64) - 收到事件的机器人 QQ 号
post_type string message 上报类型
message_type string group 消息类型
sub_type string normalanonymousnotice 消息子类型,正常消息是 normal,匿名消息是 anonymous,系统提示(如「管理员已禁止群内匿名聊天」)是 notice
message_id number (int32) - 消息 ID
group_id number (int64) - 群号
user_id number (int64) - 发送者 QQ 号
anonymous object - 匿名信息,如果不是匿名消息则为 null
message message - 消息内容
raw_message string - 原始消息内容
font number (int32) - 字体
sender object - 发送人信息

其中 anonymous 字段的内容如下:

字段名 数据类型 说明
id number (int64) 匿名用户 ID
name string 匿名用户名称
flag string 匿名用户 flag,在调用禁言 API 时需要传入

sender 字段的内容如下:

字段名 数据类型 说明
user_id number (int64) 发送者 QQ 号
nickname string 昵称
card string 群名片/备注
sex string 性别,malefemaleunknown
age number (int32) 年龄
area string 地区
level string 成员等级
role string 角色,owneradminmember
title string 专属头衔

需要注意的是,sender 中的各字段是尽最大努力提供的,也就是说,不保证每个字段都一定存在,也不保证存在的字段都是完全正确的(缓存可能过期)。尤其对于匿名消息,此字段不具有参考价值。

快速操作

字段名 数据类型 说明 默认情况
reply message 要回复的内容 不回复
auto_escape boolean 消息内容是否作为纯文本发送(即不解析 CQ 码),只在 reply 字段是字符串时有效 不转义
at_sender boolean 是否要在回复开头 at 发送者(自动添加),发送者是匿名用户时无效 at 发送者
delete boolean 撤回该条消息 不撤回
kick boolean 把发送者踢出群组(需要登录号权限足够),不拒绝此人后续加群请求,发送者是匿名用户时无效 不踢
ban boolean 把发送者禁言 ban_duration 指定时长,对匿名用户也有效 不禁言
ban_duration number 禁言时长 30 分钟

上一节 下一节
事件概述 通知事件