将群运维操作标准化，便于集成到 SCRM 或风控系统
本文介绍外部群成员移除、管理员添加等群模块 API 的调用方式与集成要点。
功能说明
外部群运营中，经常需要根据规则移除违规成员、调整管理员。手动操作难以规模化。
平台提供/room/removeRoomMember、/room/roomAddAdmin等群模块接口，通过isOuterRoom: 1标识外部群，传入 roomId 与 memberList 即可批量执行。所有群操作与消息、联系人接口共用同一网关地址和 Token 鉴权，便于在现有后端服务中统一封装 SDK。
涉及接口
method | 功能 |
|---|---|
| 移除群成员 |
| 添加群管理员 |
快速上手
步骤 | 操作 | 预期结果 |
|---|---|---|
1 | 获取目标外部群的 roomId | 获得有效群 ID |
2 | 确认执行节点为该群成员且具有管理权限 | 权限校验通过 |
3 | 调用移除成员接口 | 接口返回成功 |
4 | 在客户端验证成员列表变化 | 目标成员已不在群内 |
5 | 可选：调用添加管理员接口 | 管理员列表已更新 |
代码示例
移除成员
curl -X POST http://manager.qiweapi.com/qiwe/api/qw/doApi \ -H "X-QIWEI-TOKEN: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "method": "/room/removeRoomMember", "params": { "guid": "你的设备ID", "roomId": "1081449970753", "isOuterRoom": 1, "memberList": ["168873249850"] } }'添加管理员
curl -X POST http://manager.qiweapi.com/qiwe/api/qw/doApi \ -H "X-QIWEI-TOKEN: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "method": "/room/roomAddAdmin", "params": { "guid": "你的设备ID", "roomId": "10814449970753", "memberList": ["168885698850"] } }'落地场景
广告或违规账号自动移出外部服务群
活动群结束后批量清理临时成员
将核心运营人员设为群管理员
与内容审核系统联动，命中规则即触发移群
答疑
问：移除失败，提示权限不足？
执行节点账号需具备群主或管理员身份，且对目标成员有操作权限。
问：isOuterRoom 必须传 1 吗？
操作外部群时建议显式传 1，内部群传 0 或不传，具体以文档为准。
问：memberList 一次最多多少个？
建议单次不超过文档限制，大批量操作分批调用并加间隔。
问：误移除能否通过 API 恢复？
需使用「邀请入群」或「添加群成员」类接口重新邀请，无法一键撤销。
延伸链接
想继续往下做，可以从这里开始：
查看 API 文档 — 完整接口说明、Webhook 配置与快速开始
访问官网平台 — 注册账号、扫码登录节点、在线调试
