# 企业成员客户数量扩容(平台号)
[异步回调]企业成员客户数量扩容接口
说明:因企业微信用户首次客户好友上限值为5000,成员客户好友达到4500时出现扩容提示(个人可添加客户数小于500时),可提前发起客户好友扩容。
调用说明:
按照扩容申请的步骤,当机器人可以添加的客户好友数量少于500个,则可通过向管理员发起扩容申请。因需要向企业管理员发起申请,所以可先调用接口获取企业管理员成功后,再调用扩容接口申请扩容。
具体说明:
- 扩容不需提交资料,一次支持扩容5000,会占用企业上限额度(企业剩余可添加客户数小于5000,那么成员申请个人扩容后,管理员需申请企业扩容,再申请个人扩容)(企业剩余可添加客户数即将达到临界点时,那么成员申请个人扩容后,管理员需申请企业扩容,再申请个人扩容)
- 服务人员好友关系默认上限5000人的,最多扩容至2w。已超过2w的, 向上以5k为单位,取一个上限,比如现在是2.2w好友,上限是2.5w。
请求方式:POST
请求地址:https://$basehost/gateway/qopen/ApplyIncreaseCustomerLimit
body参数:
{
"robot_id": "机器人id",
"admin_id": "企业管理员id",
"message": "申请扩容留言"
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
robot_id | string | 是 | 机器人id |
admin_id | string | 是 | 企业管理员id |
message | string | 否 | 申请扩容留言 |
返回值:
{
"data": {
"serial_no": "操作序列号"
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
serial_no | string | 请求序列号 |
hint | string | 请求日志ID |
处理结果,异步返回值:
{
"event_type": 200023,
"serial_no": "操作序列号",
"err_code": 0,
"err_msg": "success",
"robot_id": "机器人id",
"data": {
"admin_id": "企业管理员id",
"message": "申请扩容传入的申请留言"
}
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
event_type | int | 事件类型,200023 |
serial_no | string | 操作序列号 |
err_code | int | 状态码,0为正常,非0代表错误 |
err_msg | string | 错误信息 |
robot_id | string | 机器人id |
data | object | 返回数据 |
data.admin_id | string | 企业管理员id |
data.message | string | 申请扩容传入的申请留言 |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/ApplyIncreaseCustomerLimit \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id": "机器人id",
"admin_id": "企业管理员id",
"message": "申请扩容传入的申请留言"
}'