第三方应用开发 服务端API 微信客服 接待人员管理 获取接待人员列表
获取接待人员列表
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取接待人员列表
最后更新: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
		}
	]
}

参数说明:

参数类型说明
errcodeint返回码
errmsgstring错误码描述
servicer_listarrary客服账号的接待人员列表
servicer_list.useridstring接待人员的userid。第三方应用获取到的为密文userid,即open_userid
servicer_list.statusuint接待人员的接待状态。0:接待中,1:停止接待。
注:企业内部开发,需有该客服账号的管理权限;第三方/代开发应用需具有“管理账号、分配会话和收发消息”权限,且有该客服账号的管理权限,才可获取
servicer_list.stop_typeuint接待人员的接待状态为「停止接待」的子类型。0:停止接待,1:暂时挂起
servicer_list.department_iduint接待人员部门的id
上一篇
删除接待人员
下一篇
分配客服会话