获取接待人员列表

GET

http://127.0.0.1/cgi-bin/kf/servicer/list

第三方应用开发/微信客服/接待人员管理

最后修改时间：2022-08-30 03:03:37

责任人：未设置

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

权限说明:

企业需要使用“微信客服”secret所获取的accesstoken来调用（accesstoken如何获取？）
第三方应用需具有“微信客服权限->获取基础信息”权限

文档ID: 31064
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/94645
https://open.work.weixin.qq.com/api/doc/90001/90143/94697

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

open_kfid

string

客服帐号ID

必需

示例值:

XXX

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'http://127.0.0.1/cgi-bin/kf/servicer/list?access_token={{accesstoken}}&open_kfid=XXX'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

servicer_list

array [object {2}]

可选

客服帐号的接待人员列表

userid

string

可选

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

status

integer <int32>

可选

接待人员的接待状态。0:接待中,1:停止接待。第三方应用需具有“管理帐号、分配会话和收发消息”权限才可获取

errmsg

string

可选

示例

{
  "errcode": 0,
  "servicer_list": [
    {
      "userid": "string",
      "status": 0
    }
  ],
  "errmsg": "string"
}

删除接待人员

分配客服会话-获取会话状态