# 设置群管理员(废弃)

[异步回调] 设置群管理员(废弃)

当机器人为群主时,可以调用此接口设置新增群内其他成员为管理员或移除群内管理员为普通群成员;

说明:

  1. 管理员必须是企业通讯录好友,且在群内,最多可设置3名管理员。
  2. 该接口执行的是覆盖操作,原有管理员均会被移除,传空则移除所有管理员
  3. 数据校验失败的管理员会在接口返回值中给出, 发起失败的管理员会在回调中给出

请求方式:POST

请求地址:https://$basehost/gateway/qopen/SetGroupChatAdmin

body参数

{
    "robot_id": "机器人id",
    "group_id": "群id",
    "admin_account_id_list": ["管理员id"]
}
字段 类型 必填 说明
robot_id string 机器人id
group_id string 群id
admin_account_id_list array 管理员id列表,最多三个

返回值:

{
    "data": {
        "serial_no": "xxxxxx",
        "fail_info_list": [
          {
            "account_id": "xxx",
            "desc": "非群成员"
          },
          {
            "account_id": "xxx",
            "desc": "客户不存在"
          }
        ]
    },
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
data json json返回值
data.fail_info_list array 失败列表
data.fail_info_list.account_id string 失败的成员id
data.fail_info_list.desc string 失败的原因
   serial_no string 操作序列号
hint string 请求日志ID

处理结果,异步返回值 encoding_content解密后的结构:

{
    "event_type": 40016,
    "serial_no": "操作序列号",
    "err_code": 0,
    "err_msg": "success",
    "data": {
        "robot_id": "机器人id",
    	"group_id": "群id",
    	"failed_account_id_list": ["设置失败的的成员列表"]
    }
}

说明

字段 类型 说明
event_type int 事件类型,40016
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_id string 机器人id
group_id string 群id
failed_account_id_list array 设置失败的的成员列表

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/SetGroupChatAdmin \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
        "robot_id": "机器人id",
        "group_id": "群id",
        "admin_account_id_list": ["管理员id"]
      }'
最后更新时间: 2023/10/11 10:54:55