微信会话控制

由 如此轻盈 创建，路飞 最后一次修改 2016-09-30 会话控制创建会话此接口在客服和用户之间创建一个会话，如果该客服和用户会话已存在，则直接返回0。指定的客服帐号必须已经绑定微信号且在线。调用说明1234567 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返回说明12345返回数据示例（正确时的JSON返回结果）： {    "errcode" : 0,    "errmsg" : "ok" }关闭会话调用说明1234567http请求方式: POST https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN POST数据示例如下： {    "kf_account" : "test1@test",    "openid" : "OPENID" }参数说明参数说明kf_account完整客服帐号，格式为：帐号前缀@公众号微信号openid粉丝的openid返回说明12345返回数据示例（正确时的JSON返回结果）： {    "errcode" : 0,    "errmsg" : "ok" }主要返回码返回码说明0成功65400API不可用，即没有开通/升级到新版客服功能65401无效的客服帐号65402帐号尚未绑定微信号，不能投入使用65413不存在对应用户的会话信息65414客户正在被其他客服接待40003非法的openid获取客户会话状态此接口获取一个客户的会话，如果不存在，则kf_account为空。调用说明12 http请求方式: GEThttps://api.weixin.qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID参数说明参数说明openid粉丝的openid返回说明12345 返回数据示例（正确时的JSON返回结果）： {    "createtime" : 123456789,    "kf_account" : "test1@test" }参数说明参数说明kf_account正在接待的客服，为空表示没有人在接待createtime会话接入的时间主要返回码返回码说明0成功65400API不可用，即没有开通/升级到新版客服功能40003非法的openid获取客服会话列表调用说明12 http请求方式: GEThttps://api.weixin.qq.com/customservice/kfsession/getsessionlist?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT参数说明参数说明kf_account完整客服帐号，格式为：帐号前缀@公众号微信号返回说12345678910111213 返回数据示例（正确时的JSON返回结果）： {    "sessionlist" : [       {          "createtime" : 123456789,          "openid" : "OPENID"       },       {          "createtime" : 123456789,          "openid" : "OPENID"       }    ] }获取未接入会话列表调用说明12http请求方式: GEThttps://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN返回说明1234567891011121314返回数据示例（正确时的JSON返回结果）： {    "count" : 150,    "waitcaselist" : [       {          "latest_time" : 123456789,          "openid" : "OPENID"       },       {          "latest_time" : 123456789,          "openid" : "OPENID"       }    ] }参数说明参数说明count未接入会话数量waitcaselist未接入会话列表，最多返回100条数据，按照来访顺序openid粉丝的openidlatest_time粉丝的最后一条消息的时间返回码说明返回码说明0成功65400API不可用，即没有开通或升级到新版客服功能65401无效客服帐号65402客服帐号尚未绑定微信号，不能投入使用65413不存在对应用户的会话信息65414粉丝正在被其他客服接待65415指定的客服不在线40003非法的openid