1. 首页
  2. 事件参考
  3. 请求事件
  4. 请求事件

请求事件

  • 发布于 2026-09-04
  • 0 次阅读

请求事件的 category 固定为 request,可通过 request 大类监听。

好友申请

QQ 推送好友申请提示后,框架会回读好友系统消息,以接口返回的数据生成事件,而不是猜测提示包字段。

api.on('friend_request_received', event => {
  console.log(event.user_id, event.comment)
})
{
  self_id,
  post_type: 'request',
  request_type: 'friend',
  sub_type: 'add',
  user_id,
  nickname,
  comment,
  source,
  flag,
  requested_at
}

flag 是不透明请求标识,调用 set_friend_add_request 时必须原样传回。

入群申请与邀请

api.on('group_request_received', event => {
  console.log(event.group_id, event.user_id, event.request_id)
})
字段 说明
group_id, group_name 目标群
user_id, nickname 申请者
comment 申请附言,存在时返回
request_id, request_type 原生请求标识
request_extra 附加请求标识,存在时返回
invitor_id, invitor_nickname 邀请者,邀请入群时返回

request_idrequest_typerequest_extra 应原样用于入群申请处理接口。