第三方应用开发 服务端API 微信客服 接待人员管理 获取接待人员列表
获取接待人员列表

获取某个客服帐号的接待人员列表

请求方式: GET(HTTPS)

请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/servicer/list?access_token=ACCESS_TOKEN&open_kfid=XXX

参数说明:

参数是否必须说明
access_token调用接口凭证
open_kfid客服帐号ID


权限说明:

  • 企业需要使用“微信客服”secret所获取的accesstoken来调用(accesstoken如何获取?
  • 第三方应用需具有“微信客服权限->获取基础信息”权限
  • 代开发自建应用需具有“微信客服权限->获取基础信息”权限

 

返回结果:

{
    "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.statusint接待人员的接待状态。0:接待中,1:停止接待。第三方应用需具有“管理帐号、分配会话和收发消息”权限才可获取
servicer_list.department_idint接待人员部门的id
上一篇
删除接待人员
下一篇
分配客服会话