Skip to content

事件概览

当 QQ 上发生了事情(有人发消息、有人入群、有人撤回……),icqq-rust-onebot 会把这些事件推送给你的程序。

推送方式

取决于你的配置:

  • HTTP POST —— Bot 向你配置的 post_url 发 POST 请求
  • 正向 WebSocket —— 通过已建立的 WS 连接直接推送
  • 反向 WebSocket —— 通过 Bot 主动连出的 WS 连接推送

公共字段

每个事件都包含以下公共字段:

字段类型说明
post_typestring事件大类:message / notice / request / meta_event
timenumber事件发生的时间戳(秒)
self_idnumber收到事件的 Bot QQ 号

事件分类

类型post_type说明详情
消息事件message收到私聊、群聊消息查看详情
通知事件notice群成员变动、撤回、禁言、戳一戳等查看详情
请求事件request好友申请、入群申请/邀请查看详情
元事件meta_event心跳、生命周期查看详情

注意事项

  • message_id 始终是字符串(见 message_id 说明
  • message 字段始终是段数组raw_message 是纯文本(仅文本段拼接),不含 CQ 码
  • QQ 频道(guild)相关字段的 id 全部为字符串