多客服功能－客服管理

安哥网络

多客服功能－客服管理
目录

• 1 获取客服基本信息
• 2 获取在线客服接待信息
• 3 添加客服账号
• 4 设置客服信息
• 5 上传客服头像
• 6 删除客服账号
• 7 客服管理接口返回码说明
  

获取客服基本信息开发者通过本接口，根据AppID获取公众号中所设置的客服基本信息，包括客服工号、客服昵称、客服登录账号。开发者利用客服基本信息，结合客服接待情况，可以开发例如“指定客服接待”等功能。
接口调用说明
http请求方式: GEThttps://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN返回说明
返回数据示例（正确时的JSON返回结果）： {    "kf_list" : [       {          "kf_account" : "test1@test",          "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",          "kf_id" : "1001",          "kf_nick" : "ntest1"       },       {          "kf_account" : "test2@test",          "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",          "kf_id" : "1002",          "kf_nick" : "ntest2"       },       {          "kf_account" : "test3@test",          "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",          "kf_id" : "1003",          "kf_nick" : "ntest3"       }    ] }

参数	说明
kf_account	完整客服账号，格式为：账号前缀@公众号微信号
kf_nick	客服昵称
kf_id	客服工号

错误时微信会返回错误码等信息，请根据错误码查询错误信息:全局返回码说明
获取在线客服接待信息开发者通过本接口，根据AppID获取公众号中当前在线的客服的接待信息，包括客服工号、客服登录账号、客服在线状态（手机在线、PC客户端在线、手机和PC客户端全都在线）、客服自动接入最大值、客服当前接待客户数。开发者利用本接口提供的信息，结合客服基本信息，可以开发例如“指定客服接待”等功能；结合会话记录，可以开发”在线客服实时服务质量监控“等功能。
接口调用请求说明
http请求方式: GEThttps://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN返回说明
返回数据示例（正确时的JSON返回结果）：{   "kf_online_list": [       {           "kf_account": "test1@test",            "status": 1,            "kf_id": "1001",            "auto_accept": 0,            "accepted_case": 1       },       {           "kf_account": "test2@test",            "status": 1,            "kf_id": "1002",            "auto_accept": 0,            "accepted_case": 2       }   ]}

参数	说明
kf_account	完整客服账号，格式为：账号前缀@公众号微信号
status	客服在线状态  1：pc在线，2：手机在线。若pc和手机同时在线则为 1+2=3
kf_id	客服工号
auto_accept	客服设置的最大自动接入数
accepted_case	客服当前正在接待的会话数

错误时微信会返回错误码等信息，请根据错误码查询错误信息:全局返回码说明
添加客服账号通过本接口可为公众号添加客服账号，每个公众号最多添加10个客服账号，如有额外需要可申请扩容。
接口调用请求说明
http请求方式: POSThttps://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKENPOST数据说明
POST数据示例如下： {    "kf_account" : "test1@test",    "nickname" : "客服1",    "password" : "pswmd5" }

参数	是否必须	说明
kf_account	是	完整客服账号，格式为：账号前缀@公众号微信号，账号前缀最多10个字符，必须是英文或者数字字符。如果没有公众号微信号，请前往微信公众平台设置。
nickname	是	客服昵称，最长6个汉字或12个英文字符
password	是	客服账号登录密码，格式为密码明文的32位加密MD5值

返回说明
返回数据示例（正确时的JSON返回结果）： {    "errcode" : 0,    "errmsg" : "ok" }错误时微信会返回错误码等信息，请根据错误码查询错误信息:全局返回码说明
设置客服信息接口调用请求说明
http请求方式: POSThttps://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKENPOST数据说明
POST数据示例如下： {    "kf_account" : "test1@test",    "nickname" : "客服1",    "password" : "pswmd5" }

参数	是否必须	说明
kf_account	是	完整客服账号，格式为：账号前缀@公众号微信号
nickname	是	客服昵称，最长6个汉字或12个英文字符
password	是	客服账号登录密码，格式为密码明文的32位加密MD5值

返回说明
返回数据示例（正确时的JSON返回结果）： {    "errcode" : 0,    "errmsg" : "ok" }错误时微信会返回错误码等信息，请根据错误码查询错误信息:全局返回码说明

上传客服头像开发者可调用本接口来上传图片作为客服人员的头像，头像图片文件必须是jpg格式，推荐使用640*640大小的图片以达到最佳效果。
接口调用请求说明
http请求方式: POST/FORMhttp://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT调用示例（使用curl命令，用FORM表单方式上传一个多媒体文件）：curl -F media=@test.jpg "https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT"参数说明

参数	是否必须	说明
kf_account	是	完整客服账号，格式为：账号前缀@公众号微信号
media	是	form-data中媒体文件标识，有filename、filelength、content-type等信息

返回说明
返回数据示例（正确时的JSON返回结果）： {    "errcode" : 0,    "errmsg" : "ok" }错误时微信会返回错误码等信息，请根据错误码查询错误信息:全局返回码说明
删除客服账号接口调用请求说明
http请求方式: GEThttps://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT参数说明

参数	是否必须	说明
kf_account	是	完整客服账号，格式为：账号前缀@公众号微信号

返回说明
返回数据示例（正确时的JSON返回结果）： {    "errcode" : 0,    "errmsg" : "ok" }错误时微信会返回错误码等信息，请根据错误码查询错误信息:全局返回码说明

客服管理接口返回码说明

返回码	说明
0	成功(no error)
61451	参数错误(invalid parameter)
61452	无效客服账号(invalid kf_account)
61453	账号已存在(kf_account exsited)
61454	账号名长度超过限制(前缀10个英文字符)(invalid kf_acount length)
61455	账号名包含非法字符(英文+数字)(illegal character in kf_account)
61456	账号个数超过限制(10个客服账号)(kf_account count exceeded)
61457	无效头像文件类型(invalid file type)

多客服功能－客服管理
摘自：http://mp.weixin.qq.com/wiki/9/6 ... 043ada035cc935.html