> 微信公众号开发手册 > 微信客服管理

客服管理

微信客服管理


获取客服基本信息

调用说明

1
2
http请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN

返回说明

返回数据示例(正确时的JSON返回结果):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
    "kf_list" : [
       {
          "kf_account" : "test1@test",
          "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",
          "kf_id" : "1001",
          "kf_nick" : "ntest1",
          "kf_wx" : "kfwx1"
       },
       {
          "kf_account" : "test2@test",
          "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",
          "kf_id" : "1002",
          "kf_nick" : "ntest2",
          "kf_wx" : "kfwx2"
       },
       {
          "kf_account" : "test3@test",
          "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",
          "kf_id" : "1003",
          "kf_nick" : "ntest3",
          "invite_wx" : "kfwx3",
          "invite_expire_time" : 123456789,
          "invite_status" : "waiting"
       }
    ]
 }

参数说明

参数 说明
kf_account 完整客服帐号,格式为:帐号前缀@公众号微信号
kf_nick 客服昵称
kf_id

客服编号

kf_headimgurl 客服头像
kf_wx

如果客服帐号已绑定了客服人员微信号,

则此处显示微信号

invite_wx

如果客服帐号尚未绑定微信号,但是已经发起了一个绑定邀请,

则此处显示绑定邀请的微信号

invite_expire_time

如果客服帐号尚未绑定微信号,但是已经发起过一个绑定邀请,

邀请的过期时间,为unix 时间戳

invite_status

邀请的状态,有等待确认“waiting”,被拒绝“rejected”,

过期“expired”


获取客服基本信息

调用说明

1
2
http请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN

返回说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
返回数据示例(正确时的JSON返回结果):
{
   "kf_online_list": [
       {
           "kf_account""test1@test"
           "status": 1, 
           "kf_id""1001"
           "accepted_case": 1
       },
       {
           "kf_account""test2@test"
           "status": 1, 
           "kf_id""1002"
           "accepted_case": 2
       }
   ]
}

参数说明

参数 说明
kf_account 完整客服帐号,格式为:帐号前缀@公众号微信号
status 客服在线状态,目前为:1、web 在线
kf_id 客服编号
accepted_case 客服当前正在接待的会话数

添加客服帐号

调用说明

1
2
3
4
5
6
7
http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN
POST数据示例如下:
 {
    "kf_account" : "test1@test",
    "nickname" : "客服1"
 }

参数说明

参数 说明
kf_account 完整客服帐号,格式为:帐号前缀@公众号微信号,帐号前缀最多10个字符,必须是英文、数字字符或者下划线,后缀为公众号微信号,长度不超过30个字符
nickname 客服昵称,最长16个字

返回说明

1
2
3
4
5
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 }

主要返回码

返回码 说明
0 成功
65400 API不可用,即没有开通/升级到新客服功能
65403 客服昵称不合法
65404 客服帐号不合法
65405 帐号数目已达到上限,不能继续添加
65406 已经存在的客服帐号

邀请绑定客服帐号

新添加的客服帐号是不能直接使用的,只有客服人员用微信号绑定了客服账号后,方可登录Web客服进行操作。此接口发起一个绑定邀请到客服人员微信号,客服人员需要在微信客户端上用该微信号确认后帐号才可用。尚未绑定微信号的帐号可以进行绑定邀请操作,邀请未失效时不能对该帐号进行再次绑定微信号邀请。

调用说明

1
2
3
4
5
6
7
http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN
POST数据示例如下:
 {
    "kf_account" : "test1@test",
    "invite_wx" : "test_kfwx"
 }

参数说明

参数 说明
kf_account 完整客服帐号,格式为:帐号前缀@公众号微信号
invite_wx 接收绑定邀请的客服微信号

返回说明

1
2
3
4
5
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 }

主要返回码

返回码 说明
0 成功
65400 API不可用,即没有开通/升级到新版客服
65401 无效客服帐号
65407 邀请对象已经是本公众号客服
65408 本公众号已发送邀请给该微信号
65409 无效的微信号
65410 邀请对象绑定公众号客服数量达到上限(目前每个微信号最多可以绑定5个公众号客服帐号)
65411 该帐号已经有一个等待确认的邀请,不能重复邀请
65412 该帐号已经绑定微信号,不能进行邀请

设置客服信息

调用说明

1
2
3
4
5
6
7
http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN
POST数据示例如下:
 {
    "kf_account" : "test1@test",
    "nickname" : "客服1"
 }

参数说明

参数 说明
kf_account 完整客服帐号,格式为:帐号前缀@公众号微信号
nickname 客服昵称,最长16个字

返回说明

1
2
3
4
5
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 }

主要返回码

返回码 说明
0 成功
65400 API不可用,即没有开通/升级到新版客服功能
65401 无效客服帐号
65403 客服昵称不合法


上传客服头像

调用说明

1
2
3
4
5
http请求方式: POST/FORM
https://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 等信息,文件大小为5M 以内


返回说明12345返回数据示例(正确时的JSON返回结果): {    "errcode" : 0,    "errmsg" : "ok" }主要返回码返回码说明0成功65400API不可用,即没有开通/升级到新版客服功能65401无效客服帐号65403客服昵称不合法40005不支持的媒体类型40009媒体文件长度不合法删除客服帐号调用说明12http请求方式: GEThttps://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT参数说明参数说明kf_account完整客服帐号,格式为:帐号前缀@公众号微信号返回说明
1
2
3
4
5
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 }

主要返回码

返回码

说明

0 成功
65400 API不可用,即没有开通/升级到新版客服功能
65401 无效客服帐号


客服管理接口返回码说明

返回码 说明
0 成功
65400 API不可用,即没有开通/升级到新版客服功能
65401 无效客服帐号
65403 客服昵称不合法
65404 客服帐号不合法
65405 帐号数目已达到上限,不能继续添加
65406 已经存在的客服帐号
65407

邀请对象已经是该公众号客服

65408

本公众号已经有一个邀请给该微信

65409 无效的微信号
65410 邀请对象绑定公众号客服数达到上限(目前每个微信号可以绑定5个公众号客服帐号)
65411 该帐号已经有一个等待确认的邀请,不能重复邀请
65412 该帐号已经绑定微信号,不能进行邀请
40005 不支持的媒体类型
40009 媒体文件长度不合法