Appearance
群管理操作
对微信群聊执行管理员维护或群主转让操作。
接口地址: POST /operateChatRoom
前置条件
- 微信实例已登录,并已获得可用的
wId。 - 当前微信实例是目标群的群主,或具备对应管理权限。
- 添加/删除管理员可传多个
wcId;转让群主时只能传一个wcId。 - 转让群主属于高风险操作,执行前应完成二次确认。
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
wId | 是 | string | 登录实例标识 |
chatRoomId | 是 | string | 群 ID |
wcId | 是 | string | 群成员微信 ID,多个用英文逗号分隔 |
type | 是 | int | 1 添加群管理员,支持多个;2 删除群管理员,支持多个;3 转让群主,仅限一个 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
code | string | 1000 成功,1001 失败 |
message | string | 反馈信息 |
data | null | 成功或失败时通常为空 |
请求示例
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转让群主后,当前微信实例可能不再具备原群主权限。- 操作后建议调用 获取群信息 同步最新群主和成员权限状态。
