当前公开契约 · 群聊

企业微信添加群成员 API

拉人进群。⚠️ 入参是 userIdList（数组），不是单个 userId。内部同事与外部联系人都可以拉。 ⚠️ 对外部成员是异步的：同步一律返回 code = 0，真实结果看回调 —— 成功推 contentType = 1002（入群），失败推 contentType = 1037，失败原因在其 content.hex 里（例如「账号处于异常状态，无法加入外部群聊」）。所以不能拿返回码当成功判据，要么读回调，要么回读群成员列表。

进入控制台试用查看完整契约

POST实例字段：appid更新：2026-10-11

请求地址

POST https://api.qingluanbot.com/qingluan/api/room/addMember

请求示例

curl -X POST 'https://api.qingluanbot.com/qingluan/api/room/addMember' \
  -H 'QL-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "appid": "we_xxxxxxxxxxxxxxx",
  "roomId": 10000000000000024,
  "userId": 1000000000000018
}'

请求参数

字段	类型	要求	说明
`appid`	string	必填	青鸾实例 ID，形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
`roomId`	integer	必填	群 ID。取自「创建群聊」或「查询我的客户群」。注意查询接口返回的是字符串，回传时需转整数。
`userIdList`	array<integer>	可选	要拉进群的用户 ID 列表。必须是数组。
`userId`	integer	可选	用户 ID。同事取通讯录 vid，外部联系人取 uin。

响应判断

能力层接口返回包含 code、message、time 与 data 等字段；请以 code=0 判断业务成功。HTTP 200 只表示网关已返回响应，不能替代业务状态判断。

可能的响应状态

HTTP 状态	公开契约说明
`200`	原样返回（code = 0 即成功）
`403`	受控接口，需通过控制台配置
`404`	appid 不存在或无权访问

200 响应示例

{
  "code": 0,
  "data": {}
}

接入步骤

在青鸾开发者控制台创建或查看 API Key。
在「实例与回调」接入企业微信账号，取得 appid。
请求头携带 QL-Key，按当前契约提交 JSON 请求。
读取响应中的 code；仅当 code=0 时按成功流程处理。

把企业微信能力接入你的系统

从 API Key、appid 到首个 code=0 响应，可在开发者控制台完成配置与验证。

打开开发者控制台