# 获取离职待分配群列表(平台号)
[异步回调]获取离职待分配群列表
场景描述:
当企业成员离职后,该成员创建的客户群或其他企业用户创建后转让给该成员的客户群可作为群资源被分配给企业内其他成员。
离职的方法:
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"
}'
← 设置群内昵称 客户群离职继承(平台号) →