# 企业成员客户数量扩容(平台号)

[异步回调]企业成员客户数量扩容接口

说明:因企业微信用户首次客户好友上限值为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": "申请扩容传入的申请留言"
}'
最后更新时间: 2023/5/24 10:48:59