invite_group_members

邀请指定好友或来源群成员加入目标群。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

user_ids 必须非空。邀请受当前账号的群权限和上游安全验证约束，返回邀请结果不保证所有目标已加入。

适用协议

Android（手机 / 平板）/ Linux QQ。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "invite_group_members",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321,
    "user_ids": [234567890]
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
group_id	integer	是	目标群号
user_ids	integer[]	是	QQ 号数组
source_group_id	integer	否	来源群；0 或省略时从好友解析目标，非零时从该群成员解析

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
success	boolean	操作是否成功
error_code	integer	上游结果码
error_message	string	上游错误说明
group_id	integer	目标群号
current_max_msg_seq	integer	当前最大消息序列号
verification_required	boolean	是否需要额外验证
verification_url	string	验证地址
verification_type	integer	上游验证类型
security_url	string	安全验证地址
security_prompt	string	安全验证提示