微信会话控制


会话控制

201610171124143832.png

创建会话

此接口在客服和用户之间创建一个会话，如果该客服和用户会话已存在，则直接返回0。指定的客服帐号必须已经绑定微信号且在线。

调用说明

1
2
3
4
5
6
7
 http请求方式: POST 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

返回说明

 POST数据示例如下：
1
2
3
4
5
返回数据示例（正确时的JSON返回结果）：
 {
    "errcode" : 0,
    "errmsg" : "ok"
 }
 https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN
 {🎜🎜    "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请求方式: POSThttp请求方式: POST
 https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
 POST数据示例如下：
 {
    "kf_account" : "test1@test",
    "openid" : "OPENID"
 }

参数说明

参数说明
kf_account完整客服帐号，格式为：帐号前缀@公众号微信号
openid粉丝的openid

返回说明

 POST数据示例如下：
1
2
3
4
5
返回数据示例（正确时的JSON返回结果）：
 {
    "errcode" : 0,
    "errmsg" : "ok"
 }
 https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
 {


    "kf_account" : "test1@test",

    "openid" : "OPENID" }参数说明参数说明kf_account完整客服帐号，格式为：帐号前缀@公众号微信号openid粉丝的openid12345
返回说明
🎜返回数据示例（正确时的JSON返回结果）：🎜🎜 {🎜🎜    "errcode" : 0,🎜🎜    "errmsg" : "ok"🎜🎜 }🎜🎜🎜🎜🎜🎜主要返回码🎜🎜🎜🎜🎜🎜返回码🎜🎜说明🎜🎜🎜🎜0🎜🎜成功🎜🎜🎜🎜65400🎜🎜API不可用，即没有开通/升级到新版客服功能🎜🎜🎜🎜65401🎜🎜无效的客服帐号🎜🎜🎜🎜65402🎜🎜帐号尚未绑定微信号，不能投入使用🎜🎜🎜🎜65413🎜🎜不存在对应用户的会话信息🎜🎜🎜🎜65414🎜🎜客户正在被其他客服接待🎜🎜🎜🎜40003🎜🎜非法的openid🎜🎜🎜🎜

获取客户会话状态

此接口获取一个客户的会话，如果不存在，则kf_account为空。

调用说明

1
2
 http请求方式: GET http请求方式: GET
https://api.weixin.qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID
https://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完整客服帐号，格式为：帐号前缀@公众号微信号返回说
1
2
3
4
5
6
7
8
9
10
11
12
13
 返回数据示例（正确时的JSON返回结果）： 返回数据示例（正确时的JSON返回结果）：
 {
    "sessionlist" : [
       {
          "createtime" : 123456789,
          "openid" : "OPENID"
       },
       {
          "createtime" : 123456789,
          "openid" : "OPENID"
       }
    ]
 }

获取未接入会话列表

调用说明

    "sessionlist" : [
1
2
http请求方式: GET
https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN
 {
       {🎜🎜          "createtime" : 123456789,🎜🎜          "openid" : "OPENID"🎜🎜       },🎜🎜       {🎜🎜          "createtime" : 123456789,🎜🎜          "openid" : "OPENID"🎜🎜       }🎜🎜    ]🎜🎜 }🎜🎜🎜🎜🎜🎜获取未接入会话列表🎜🎜调用说明🎜🎜🎜🎜🎜🎜1🎜🎜2🎜🎜🎜🎜http请求方式: GET🎜🎜https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN🎜🎜🎜🎜🎜

返回说明

    <代码>“计数” <代码>：150，
1
2
3
4
5
6
7
8
9
10
11
12
13
14
返回数据示例（正确时的JSON返回结果）：返回数据示例（正确时的JSON返回结果）：
 {
    "count" : 150,
    "waitcaselist" : [
       {
          "latest_time" : 123456789,
          "openid" : "OPENID"
       },
       {
          "latest_time" : 123456789,
          "openid" : "OPENID"
       }
    ]
 }
 {
<代码>    <代码>“waitcaselist” <代码>： [


<代码>       {

          "latest_time" : 123456789,           "openid" : "OPENID"       },       {          "latest_time" : 123456789,          < /code>"openid" : "OPENID"       }    ] }参数说明参数说明
🎜count🎜🎜未接入会话数量🎜🎜🎜🎜waitcaselist🎜🎜未接入会话列表，最多返回100条数据，按照来访顺序🎜🎜🎜🎜openid🎜🎜粉丝的openid🎜🎜🎜🎜最新_时间🎜 🎜粉丝最后一条消息的时间🎜🎜🎜🎜

返回码说明

返回码说明
0成功
65400API不可用，即没有开通或升级到新版客服功能
65401无效客服帐号
65402客服帐号尚未绑定微信号，不能投入使用
65413不存在对应用户的会话信息
65414粉丝正在被其他客服接待
65415指定的客服不在线
40003非法的openid
←
→

PHP中文网

首页首页课程课程文章文章问答问答词典词典手册手册下载下载搜索搜索APP下载 APP下载