第三方应用开发 服务端API 微信客服 客服帐号管理 获取客服帐号列表
获取客服帐号列表

获取客服帐号列表,包括所有的客服帐号的客服ID、名称和头像。

请求方式: POST(HTTPS)

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

请求示例:

{
	"offset": 0,
    "limit": 100
}

当客服较多时,需要使用参数offsetlimit 分页获取,注意offset是以0为起点,这里以图例简单说明:
page_size/page_index图示说明当获取到的 account_list中的账号数量小于 指定的limit 的时候,表示已经没有更多的数据,此时应终止获取。

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证
offsetuint32分页,偏移量, 默认为0
limituint32分页,预期请求的数据量,默认为100,取值范围 1 ~ 100

权限说明:

 

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
	"account_list": [
        {
            "open_kfid": "wkAJ2GCAAASSm4_FhToWMFea0xAFfd3Q",
            "name": "咨询客服",
            "avatar": "https://wework.qpic.cn/wwhead/duc2TvpEgSSjibPZlNR6chpx9W3dtd9Ogp8XEmSNKGa6uufMWn2239HUPuwIFoYYZ7Ph580FPvo8/0"
        }
    ]
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
account_listobj[]帐号信息列表
account_list.open_kfidstring客服帐号ID
account_list.namestring客服名称
account_list.avatarstring客服头像URL
上一篇
修改客服帐号
下一篇
获取客服帐号链接