appidstring必填青鸾实例 ID，形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"添加群成员
拉人进群。⚠️ 入参是 userIdList（数组），不是单个 userId。内部同事与外部联系人都可以拉。
POST
/qingluan/api/room/addMember接口说明
拉人进群。⚠️ 入参是 userIdList（数组），不是单个 userId。内部同事与外部联系人都可以拉。
⚠️ 对外部成员是异步的：同步一律返回 code = 0，真实结果看回调 —— 成功推 contentType = 1002（入群），失败推 contentType = 1037，失败原因在其 content.hex 里（例如「账号处于异常状态，无法加入外部群聊」）。所以不能拿返回码当成功判据，要么读回调，要么回读群成员列表。
请求参数
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type：application/json
请求参数。字段名区分大小写，请按文档原样传递。
至少满足以下一项约束 anyOf
此条件要求提供：
userIdList。此条件要求提供：
userId。
roomIdint64必填群聊 ID
群 ID。取自「创建群聊」或「查询我的客户群」。注意查询接口返回的是字符串，回传时需转整数。
字段示例：10000000000000000userIdListint64[]可选用户 ID 列表
要拉进群的用户 ID 列表。必须是数组。
数组元素 · int64
[1688000000000001]userIdinteger可选用户 ID。同事取通讯录 vid，外部联系人取 uin。
响应与结果确认
本接口为能力层原样返回，不统一增加青鸾外层信封。code = 0 仅表示请求被接受，不保证副作用已完成。
仅对查询接口可读的群资料，用获取群资料核对；部分设置开关需要在企业微信客户端确认，具体以本页说明为准。
响应字段与 HTTP 状态
HTTP 200
能力层原样返回；code = 0 仅表示请求已受理，业务结果须按接口说明确认。
application/json
查看响应字段定义
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断：HTTP 200 只表示请求已送达，成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码：0 表示成功，-1 表示失败；失败原因见 message。
0dataobject可选业务数据
接口无固定结构化返回数据；成功时通常为空对象或省略 data。
注意：恒为 null；生效证据来自回调 1002 的 vid 载荷。
detailstring可选错误详情
错误详情；无补充信息时通常为空字符串。
messagestring必填响应消息
业务结果消息。成功通常为 ok；企微错误通常为 错误码|错误信息。
"ok"timestring必填服务端时间
服务端时间，格式为 YYYY-MM-DD HH:mm:ss。
"2026-07-21 07:33:17"HTTP 403
受控接口，需通过控制台配置
HTTP 404
appid 不存在或无权访问