微信会话控制
会话控制
创建会话
此接口在客服和用户之间创建一个会话，如果该客服和用户会话已存在，则直接返回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请求方式: GEThttps://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请求方式: GEThttps://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 |