登录
基础
连接微信
办公获取某个客服账号的接待人员列表
请求方式: 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 |
基础连接微信办公基础连接微信办公基础连接微信办公