Skip to content

群管理操作

对微信群聊执行管理员维护或群主转让操作。

接口地址: POST /operateChatRoom

前置条件

  • 微信实例已登录,并已获得可用的 wId
  • 当前微信实例是目标群的群主,或具备对应管理权限。
  • 添加/删除管理员可传多个 wcId;转让群主时只能传一个 wcId
  • 转让群主属于高风险操作,执行前应完成二次确认。

请求参数

参数名必选类型说明
wIdstring登录实例标识
chatRoomIdstring群 ID
wcIdstring群成员微信 ID,多个用英文逗号分隔
typeint1 添加群管理员,支持多个;2 删除群管理员,支持多个;3 转让群主,仅限一个

响应参数

参数名类型说明
codestring1000 成功,1001 失败
messagestring反馈信息
datanull成功或失败时通常为空

请求示例

json
{
  "wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
  "chatRoomId": "24608539283@chatroom",
  "wcId": "wxid_0zssg6z7ivlm22",
  "type": 3
}

成功响应

json
{
  "message": "成功",
  "code": "1000",
  "data": null
}

错误响应

json
{
  "message": "失败",
  "code": "1001",
  "data": null
}

使用建议

  • 管理员变更和群主转让都应记录操作人、目标成员、操作类型和结果。
  • type: 3 转让群主后,当前微信实例可能不再具备原群主权限。
  • 操作后建议调用 获取群信息 同步最新群主和成员权限状态。