添加指定客服帐号的接待人员,每个客服帐号目前最多可添加2000个接待人员,20个部门。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/servicer/add?access_token=ACCESS_TOKEN
请求实例:
{
"open_kfid": "kfxxxxxxxxxxxxxx",
"userid_list": ["zhangsan", "lisi"],
"department_id_list": [2, 4]
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
open_kfid | 是 | 客服帐号ID |
userid_list | 否 | 接待人员userid列表。第三方应用填密文userid,即open_userid 可填充个数:0 ~ 100。超过100个需分批调用。 |
department_id_list | 否 | 接待人员部门id列表 可填充个数:0 ~ 100。超过100个需分批调用。 |
userid_list和department_id_list至少需要填其中一个
权限说明:
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"result_list": [
{
"userid": "zhangsan",
"errcode": 0,
"errmsg": "success"
},
{
"userid": "lisi",
"errcode": 0,
"errmsg": "ignored"
},
{
"department_id": 2,
"errcode": 0,
"errmsg": "success"
},
{
"department_id": 3,
"errcode": 0,
"errmsg": "ignored"
}
]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int | 返回码 |
errmsg | string | 错误码描述 |
result_list | arrary | 操作结果 |
result_list.userid | string | 接待人员的userid |
result_list.department_id | int | 接待人员部门的id |
result_list.errcode | int | 该userid的添加结果 |
result_list.errmsg | string | 结果信息 |