将群运维操作标准化便于集成到 SCRM 或风控系统本文介绍外部群成员移除、管理员添加等群模块 API 的调用方式与集成要点。功能说明外部群运营中经常需要根据规则移除违规成员、调整管理员。手动操作难以规模化。平台提供/room/removeRoomMember、/room/roomAddAdmin等群模块接口通过isOuterRoom: 1标识外部群传入 roomId 与 memberList 即可批量执行。所有群操作与消息、联系人接口共用同一网关地址和 Token 鉴权便于在现有后端服务中统一封装 SDK。涉及接口method功能/room/removeRoomMember移除群成员/room/roomAddAdmin添加群管理员快速上手步骤操作预期结果1获取目标外部群的 roomId获得有效群 ID2确认执行节点为该群成员且具有管理权限权限校验通过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 配置与快速开始访问官网平台 — 注册账号、扫码登录节点、在线调试
外部群成员管理 API：移除成员与权限维护
发布时间：2026/6/11 23:42:58
将群运维操作标准化便于集成到 SCRM 或风控系统本文介绍外部群成员移除、管理员添加等群模块 API 的调用方式与集成要点。功能说明外部群运营中经常需要根据规则移除违规成员、调整管理员。手动操作难以规模化。平台提供/room/removeRoomMember、/room/roomAddAdmin等群模块接口通过isOuterRoom: 1标识外部群传入 roomId 与 memberList 即可批量执行。所有群操作与消息、联系人接口共用同一网关地址和 Token 鉴权便于在现有后端服务中统一封装 SDK。涉及接口method功能/room/removeRoomMember移除群成员/room/roomAddAdmin添加群管理员快速上手步骤操作预期结果1获取目标外部群的 roomId获得有效群 ID2确认执行节点为该群成员且具有管理权限权限校验通过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 配置与快速开始访问官网平台 — 注册账号、扫码登录节点、在线调试
