# 获取离职待分配群列表(平台号)

[异步回调]获取离职待分配群列表

场景描述:

当企业成员离职后,该成员创建的客户群或其他企业用户创建后转让给该成员的客户群可作为群资源被分配给企业内其他成员。

离职的方法:

1、企业管理员将成员从企业通讯录中删除 2、企业成员主动离职后,企业管理员将其账号删除。

注意事项:

1、只有企业成员不存在于企业通讯录中,他的客户资源以及客户群资源才可以被离职分配继承。

2、微信用户创建的群聊后将群主转让给企业用户,企业用户离职后此类群不支持继承分配。

3、只有管理员可在客户群列表搜索到的群聊才支持群离职继承。

4、群聊创建成功后,群内有过历史聊天记录的群才支持继承。

请求方式:POST

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

body参数

{
    "robot_id": "机器人id"
}
字段 类型 必填 说明
robot_id string 机器人id

返回值:

{
    "data": {
        "serial_no": "xxxxxx"
    },
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
data json json返回值
   serial_no string 操作序列号
hint string 请求日志ID

处理结果,异步返回值:

{
    "event_type": 300035,
    "serial_no": "操作序列号",
    "robot_id": "机器人id",
    "err_code": 0,
    "err_msg": "success",
    "data": {
        "groups": [
            {
                "group_id": "群id",
                "name": "群名称",
                "base64_name": "BASE64编码过后的群名称",
                "owner_id": "群主id",
                "create_time": "创建时间",
                "group_photo": "群头像",
                "member_count": 12
            }
        ]
    }
}

返回说明

字段 类型 说明
event_type int 事件类型,300035
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_id string 机器人id
data object 返回数据
data.groups[x].group_id string 群id
data.groups[x].name string 群名称
data.groups[x].base64_name string BASE64编码过后的群名称
data.groups[x].owner_id string 群主id
data.groups[x].create_time string 创建时间
data.groups[x].group_photo string 群头像
data.groups[x].member_count int 群成员数量

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/GetAssignableGroups \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
    "robot_id": "机器人id"
}'
最后更新时间: 2023/5/24 10:48:59