微信公众号
客服管理
目录
1.1 获取客服基本信息
1.2 添加客服账号
1.3 邀请绑定客服账号
1.4 设置客服信息
1.5 上传客服头像
1.6 删除客服账号
1.7 客服管理接口返回码说明
# 获取客服基本信息
调用说明
http请求方式: GET https://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_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"
}
]
}
参数说明
调用说明
http请求方式: GET https://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" ,
"accepted_case" : 1
},
{
"kf_account" :
"test2@test" ,
"status" : 1,
"kf_id" :
"1002" ,
"accepted_case" : 2
}
]
}
参数说明
# 添加客服账号
调用说明
http请求方式: POST https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN POST数据示例如下:
{
"kf_account" : "test1@test",
"nickname" : "客服1"
}
参数说明
返回说明
返回数据示例(正确时的JSON返回结果):
{
"errcode"
: 0,
"errmsg"
:
"ok"
}
主要返回码
# 邀请绑定客服账号
新添加的客服账号是不能直接使用的,只有客服人员用微信号绑定了客服账号后,方可登录Web客服进行操作。此接口发起一个绑定邀请到客服人员微信号,客服人员需要在微信客户端上用该微信号确认后账号才可用。尚未绑定微信号的账号可以进行绑定邀请操作,邀请未失效时不能对该账号进行再次绑定微信号邀请。
调用说明
http请求方式: POST https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN POST数据示例如下:
{
"kf_account" : "test1@test",
"invite_wx" : "test_kfwx"
}
参数说明
返回说明
返回数据示例(正确时的JSON返回结果):
{
"errcode"
: 0,
"errmsg"
:
"ok"
}
主要返回码
# 设置客服信息
调用说明
http请求方式: POST https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN POST数据示例如下:
{
"kf_account" : "test1@test",
"nickname" : "客服1"
}
参数说明
返回说明
返回数据示例(正确时的JSON返回结果):
{
"errcode"
: 0,
"errmsg"
:
"ok"
}
主要返回码
# 上传客服头像
调用说明
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"
参数说明
返回说明
返回数据示例(正确时的JSON返回结果):
{
"errcode"
: 0,
"errmsg"
:
"ok"
}
主要返回码
# 删除客服账号
调用说明
http请求方式: GET https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT
参数说明
返回说明
返回数据示例(正确时的JSON返回结果):
{
"errcode"
: 0,
"errmsg"
:
"ok"
}
主要返回码