获取接待人员列表

GET

/cgi-bin/kf/servicer/list

服务端API企业内部开发第三方应用开发

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

权限说明:

企业需要使用“微信客服”secret所获取的accesstoken来调用（accesstoken如何获取？）

第三方应用需具有“微信客服权限->获取基础信息”权限

代开发自建应用需具有“微信客服权限->获取基础信息”权限

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://qyapi.weixin.qq.com/cgi-bin/kf/servicer/list?access_token=&open_kfid=XXX'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "servicer_list": [
    {
      "userid": "zhangsan",
      "status": 0
    },
    {
      "userid": "lisi",
      "status": 1
    },
    {
      "department_id": 2
    },
    {
      "department_id": 3
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

open_kfid

客服帐号ID

必需

示例值:

XXX

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

错误码描述

必需

servicer_list

array [object {3}]

必需

客服帐号的接待人员列表

userid

string

必需

接待人员的userid。第三方应用获取到的为密文userid，即open_userid

status

integer

必需

接待人员的接待状态。0:接待中,1:停止接待。注：企业内部开发，需有该客服账号的管理权限；第三方/代开发应用需具有“管理帐号、分配会话和收发消息”权限，且有该客服账号的管理权限，才可获取

department_id

integer

接待人员部门的id

必需

修改于 2022-12-01 09:19:19

删除接待人员

概述