create_group

使用当前在线的安卓协议 Bot 创建普通 QQ 群。底层按 QQ 9.2.70 的创建群链路执行：先创建群聊，再按需邀请成员。

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

user_ids 可省略；邀请时最多 20 人，不得包含 0 或当前账号。创建成功后邀请失败不会撤销已创建的群，需检查 invite_success；invite 与 invite_error 仅在相应分支出现。

适用协议

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

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "create_group",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_name": "示例群"
  }
}

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

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
group_name	string	是	群名称
description	string	否	描述文字
group_option	integer	否	建群选项
group_class_ext	integer	否	群分类扩展值
group_type_flag	integer	否	群类型标识
user_ids	integer[]	否	QQ 号数组

返回值

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

字段	类型	说明
created	boolean	群是否已创建
group_id	integer	目标群号
group_uin	integer	上游群 UIN
group_name	string	群名称
owner_id	integer	群主 QQ 号
group_size	integer	群成员数量
invite_attempted	boolean	是否尝试邀请成员
invite_success	boolean	邀请是否成功
invite	object	邀请成员的上游响应
invite_error	string	邀请失败说明，失败时出现