添加接待人员
最后更新：2025/02/25
添加指定客服账号的接待人员，每个客服账号目前最多可添加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 ~ 20。 |
userid_list和department_id_list至少需要填其中一个
权限说明:
调用的应用需要满足如下的权限
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「 微信客服- 可调用接口的应用」中 |
| 第三方应用 | 具有“微信客服->管理账号、分配会话和收发消息”权限 |
| 代开发自建应用 | 具有“微信客服->管理账号、分配会话和收发消息”权限 |
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
- 只能通过API管理企业指定的客服账号。企业可在管理后台“微信客服-通过API管理微信客服账号”处设置对应的客服账号通过API来管理。
- 操作的客服账号对应的接待人员应在应用的可见范围内
返回结果:
{ "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 | 结果信息 |
删除接待人员
最后更新：2023/11/30
从客服账号删除接待人员
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/servicer/del?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和departmentid_list至少需要填其中一个
权限说明:
调用的应用需要满足如下的权限
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「 微信客服- 可调用接口的应用」中 |
| 第三方应用 | 具有“微信客服->管理账号、分配会话和收发消息”权限 |
| 代开发自建应用 | 具有“微信客服->管理账号、分配会话和收发消息”权限 |
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
- 只能通过API管理企业指定的客服账号。企业可在管理后台“微信客服-通过API管理微信客服账号”处设置对应的客服账号通过API来管理。
- 操作的客服账号对应的接待人员应在应用的可见范围内
返回结果:
{ "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 | 结果信息 |
获取接待人员列表
最后更新：2023/11/30
获取某个客服账号的接待人员列表
请求方式: GET(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/servicer/list?access_token=ACCESS_TOKEN&open_kfid=XXX
参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| open_kfid | 是 | 客服账号ID |
权限说明:
调用的应用需要满足如下的权限
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「 微信客服- 可调用接口的应用」中 |
| 第三方应用 | 具有“微信客服权限->获取基础信息”权限 |
| 代开发自建应用 | 具有“微信客服权限->获取基础信息”权限 |
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
- 操作的客服账号对应的接待人员应在应用的可见范围内
返回结果:
{ "errcode": 0, "errmsg": "ok", "servicer_list": [ { "userid": "zhangsan", "status": 0 }, { "userid": "lisi", "status": 1 }, { "department_id": 2 }, { "department_id": 3 } ]}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int | 返回码 |
| errmsg | string | 错误码描述 |
| servicer_list | arrary | 客服账号的接待人员列表 |
| servicer_list.userid | string | 接待人员的userid。第三方应用获取到的为密文userid，即open_userid |
| servicer_list.status | uint | 接待人员的接待状态。0:接待中,1:停止接待。注：企业内部开发，需有该客服账号的管理权限；第三方/代开发应用需具有“管理账号、分配会话和收发消息”权限，且有该客服账号的管理权限，才可获取 |
| servicer_list.stop_type | uint | 接待人员的接待状态为「停止接待」的子类型。0:停止接待,1:暂时挂起 |
| servicer_list.department_id | uint | 接待人员部门的id |