登录
基础
连接微信
办公添加指定客服账号的接待人员，每个客服账号目前最多可添加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至少需要填其中一个
权限说明:
调用的应用需要满足如下的权限
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「 微信客服- 可调用接口的应用」中 |
| 第三方应用 | 具有“微信客服->管理账号、分配会话和收发消息”权限 |
| 代开发自建应用 | 具有“微信客服->管理账号、分配会话和收发消息”权限 |
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
返回结果:
{
"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 | 结果信息 |
基础连接微信办公基础连接微信办公基础连接微信办公