添加/移除群内员工
接口说明
qwUserId）对指定群聊执行群成员操作，支持添加或移除群内员工。一次最多操作5个员工姓名。接口信息
请求参数
| 请求参数名 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| scrm_account_id | string | SCRM账号ID，如：W00000000516 | true |
| scrm_group_id | string | 群ID，如：wrXxxAAABBBccc123456 | true |
| qw_user_id | string | 托管员工企微ID（需要先授权），如：wonBvEDAAA9lHv80telxLj_YHPC6gDXA | true |
| action | int32 | 操作类型。1=添加群成员，2=移除群成员 | true |
| member_names | []string | 员工姓名列表，只按姓名生效，最多5个 | true |
请求说明
1.
memberNames 会自动去重2.
memberNames 中的空字符串会自动忽略3.
4.
5.
完整请求参数示例：添加群成员
{
"scrmAccountID": "W00000000516",
"scrmGroupID": "wrXxxAAABBBccc123456",
"qwUserId": "wonBvEDAAA9lHv80telxLj_YHPC6gDXA",
"action": 1,
"memberNames": [
"张三",
"李四"
]
}完整请求参数示例：移除群成员
{
"scrmAccountID": "W00000000516",
"scrmGroupID": "wrXxxAAABBBccc123456",
"qwUserId": "wonBvEDAAA9lHv80telxLj_YHPC6gDXA",
"action": 2,
"memberNames": [
"张三"
]
}响应参数
| 响应参数名 | 类型 | 说明 |
|---|---|---|
| status | int32 | 执行状态。1=成功，2=失败 |
| failureCode | string | 失败码，成功时为空 |
| failureReason | string | 失败原因，成功时为空 |
成功响应示例
{
"status": 1,
"failureCode": "",
"failureReason": ""
}失败响应示例
执行员工不存在
{
"status": 2,
"failureCode": "EXECUTOR_NOT_FOUND",
"failureReason": "未找到对应的员工，请确认qw_user_id是否正确且已配置在线IM账号"
}群不存在
{
"status": 2,
"failureCode": "GROUP_NOT_FOUND",
"failureReason": "未找到对应群聊，请确认scrm_group_id是否正确"
}下游执行失败
{
"status": 2,
"failureCode": "DOWNSTREAM_ACTION_FAILED",
"failureReason": "下游执行群成员操作失败: xxx"
}错误码说明
| 错误码 | 说明 | 处理建议 |
|---|---|---|
| EXECUTOR_NOT_FOUND | 未找到对应的执行员工 | 检查 qwUserId 是否正确，确认员工已授权且存在在线IM账号 |
| CHANNEL_NOT_SUPPORT | 不支持的渠道类型 | 检查该员工当前所在渠道是否支持群成员操作 |
| GROUP_NOT_FOUND | 未找到对应群聊 | 检查 scrmGroupID 是否正确 |
| GROUP_NOT_UNIQUE | 查询到多个群聊，无法唯一定位 | 检查群ID是否唯一、是否传错渠道群ID |
| GROUP_QUERY_FAILED | 查询群聊失败 | 查看服务端日志，排查下游查询异常 |
| DOWNSTREAM_ACTION_FAILED | 下游执行添加/移除失败 | 查看失败原因和服务端日志进一步排查 |
参数错误说明
scrmAccountID 为空scrmGroupID 为空qwUserId 为空action 非 1 或 2memberNames 清洗后为空memberNames 数量超过5个使用限制
1.
2.
3.
4.
5.
memberNames 中的空值会自动忽略，重复姓名会自动去重修改于 2026-03-18 02:15:19