微信公众号
会话控制
创建会话
此接口在客服和用户之间创建一个会话,如果该客服和用户会话已存在,则直接返回0。指定的客服账号必须已经绑定微信号且在线。
调用说明
http请求方式: POST
https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN
POST数据示例如下:
{
"kf_account" : "test1@test",
"openid" : "OPENID"
}
参数说明
返回说明
返回数据示例(正确时的JSON返回结果):
{
"errcode" : 0,
"errmsg" : "ok"
}
关闭会话
调用说明
http请求方式: POST
https: //api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
POST数据示例如下:
{
"kf_account":"test1@test" ,
"openid": "OPENID"
}
参数说明
返回说明
返回数据示例(正确时的JSON返回结果):
{
"errcode"
: 0,
"errmsg"
:
"ok"
}
主要返回码
获取客户会话状态
此接口获取一个客户的会话,如果不存在,则kf_account为空。
调用说明
http请求方式: GET https://api.weixin.qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID
参数说明
返回说明
返回数据示例(正确时的JSON返回结果): { "createtime": 123456789, "kf_account": "test1@test" }
参数说明
主要返回码
获取客服会话列表
调用说明
http请求方式: GET https://api.weixin.qq.com/customservice/kfsession/getsessionlist?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT |
参数说明
返回说明
返回数据示例(正确时的JSON返回结果):
{
"sessionlist" : [
{
"createtime" : 123456789,
"openid" : "OPENID"
},
{
"createtime" : 123456789,
"openid" : "OPENID"
}
]
}
获取未接入会话列表
调用说明
http请求方式: GET https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN
返回说明
返回数据示例(正确时的JSON返回结果):
{
"count" : 150,
"waitcaselist" : [
{
"latest_time" : 123456789,
"openid" : "OPENID"
},
{
"latest_time" : 123456789,
"openid" : "OPENID"
}
]
}
参数说明
返回码说明