阅读(471)
赞(0)
微信会话控制
2016-09-30 09:46:19 更新
会话控制
创建会话
此接口在客服和用户之间创建一个会话,如果该客服和用户会话已存在,则直接返回0。指定的客服帐号必须已经绑定微信号且在线。
调用说明
1 2 3 4 5 6 7 | http请求方式: POST https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN POST数据示例如下: { "kf_account" : "test1@test", "openid" : "OPENID" } |
参数说明
参数 | 说明 |
kf_account | 完整客服帐号,格式为:帐号前缀@公众号微信号 |
openid | 粉丝的openid |
返回说明
1 2 3 4 5 | 返回数据示例(正确时的JSON返回结果): { "errcode" : 0, "errmsg" : "ok" } |
关闭会话
调用说明
1 2 3 4 5 6 7 | http请求方式: POST https: //api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN POST数据示例如下: { "kf_account" : "test1@test" , "openid" : "OPENID" } |
参数说明
参数 | 说明 |
kf_account | 完整客服帐号,格式为:帐号前缀@公众号微信号 |
openid | 粉丝的openid |
返回说明
1 2 3 4 5 | 返回数据示例(正确时的JSON返回结果): { "errcode" : 0, "errmsg" : "ok" } |
主要返回码
返回码 | 说明 |
0 | 成功 |
65400 | API不可用,即没有开通/升级到新版客服功能 |
65401 | 无效的客服帐号 |
65402 | 帐号尚未绑定微信号,不能投入使用 |
65413 | 不存在对应用户的会话信息 |
65414 | 客户正在被其他客服接待 |
40003 | 非法的openid |
获取客户会话状态
此接口获取一个客户的会话,如果不存在,则kf_account为空。
调用说明
1 2 | http请求方式: GET https://api.weixin.qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID |
参数说明
参数 | 说明 |
openid | 粉丝的openid |
返回说明
1 2 3 4 5 6 7 8 9 10 11 12 13 | 返回数据示例(正确时的JSON返回结果): { "sessionlist" : [ { "createtime" : 123456789, "openid" : "OPENID" }, { "createtime" : 123456789, "openid" : "OPENID" } ] } |
获取未接入会话列表
调用说明
1 2 | http请求方式: GET https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN |
返回说明
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | 返回数据示例(正确时的JSON返回结果): { "count" : 150, "waitcaselist" : [ { "latest_time" : 123456789, "openid" : "OPENID" }, { "latest_time" : 123456789, "openid" : "OPENID" } ] } |
参数说明
参数 | 说明 |
count | 未接入会话数量 |
waitcaselist | 未接入会话列表,最多返回100条数据,按照来访顺序 |
openid | 粉丝的openid |
latest_time | 粉丝的最后一条消息的时间 |
返回码说明
返回码 | 说明 |
0 | 成功 |
65400 | API不可用,即没有开通或升级到新版客服功能 |
65401 | 无效客服帐号 |
65402 | 客服帐号尚未绑定微信号,不能投入使用 |
65413 | 不存在对应用户的会话信息 |
65414 | 粉丝正在被其他客服接待 |
65415 | 指定的客服不在线 |
40003 | 非法的openid |
← 微信客服管理