php微信客服,微信客服管理 - 微信公众平台开发者文档

获取客服基本信息

调用说明

返回说明

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

参数说明参数说明

kf_account完整客服帐号，格式为：帐号前缀@公众号微信号

kf_nick客服昵称

kf_id客服编号

kf_headimgurl客服头像

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

则此处显示微信号

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

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

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

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

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

过期“expired”

获取客服基本信息

调用说明

返回说明

参数说明参数说明

kf_account完整客服帐号，格式为：帐号前缀@公众号微信号

status客服在线状态，目前为：1、web 在线

kf_id客服编号

accepted_case客服当前正在接待的会话数

添加客服帐号

调用说明

参数说明参数说明

kf_account完整客服帐号，格式为：帐号前缀@公众号微信号，帐号前缀最多10个字符，必须是英文、数字字符或者下划线，后缀为公众号微信号，长度不超过30个字符

nickname客服昵称，最长16个字

返回说明

主要返回码返回码说明

0成功

65400API不可用，即没有开通/升级到新客服功能

65403客服昵称不合法

65404客服帐号不合法

65405帐号数目已达到上限，不能继续添加

65406已经存在的客服帐号

邀请绑定客服帐号

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

调用说明

参数说明参数说明

kf_account完整客服帐号，格式为：帐号前缀@公众号微信号

invite_wx接收绑定邀请的客服微信号

返回说明

主要返回码返回码说明

0成功

65400API不可用，即没有开通/升级到新版客服

65401无效客服帐号

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

65408本公众号已发送邀请给该微信号

65409无效的微信号

65410邀请对象绑定公众号客服数量达到上限(目前每个微信号最多可以绑定5个公众号客服帐号)

65411该帐号已经有一个等待确认的邀请，不能重复邀请

65412该帐号已经绑定微信号，不能进行邀请

设置客服信息

调用说明

参数说明参数说明

kf_account完整客服帐号，格式为：帐号前缀@公众号微信号

nickname客服昵称，最长16个字

返回说明

主要返回码返回码说明

0成功

65400API不可用，即没有开通/升级到新版客服功能

65401无效客服帐号

65403客服昵称不合法

上传客服头像

调用说明

参数说明参数说明

kf_account完整客服帐号，格式为：帐号前缀@公众号微信号

mediaform-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完整客服帐号，格式为：帐号前缀@公众号微信号返回说明

主要返回码返回码说明

0成功

65400API不可用，即没有开通/升级到新版客服功能

65401无效客服帐号

客服管理接口返回码说明返回码说明

0成功

65400API不可用，即没有开通/升级到新版客服功能

65401无效客服帐号

65403客服昵称不合法

65404客服帐号不合法

65405帐号数目已达到上限，不能继续添加

65406已经存在的客服帐号