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