搜索
  • 登录
  • 注册
密码重置成功

关注您感兴趣的项目并了解有关它们的最新消息

微信会话控制

收藏 105
阅读 40458
更新时间 2016-09-11

会话控制

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
热AI工具
Undress AI Tool
Undress AI Tool

免费脱衣服图片

AI Clothes Remover
AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undresser.AI Undress
Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

Stock Market GPT
Stock Market GPT

人工智能驱动投资研究,做出更明智的决策

热门工具
记事本++7.3.1
记事本++7.3.1

好用且免费的代码编辑器

SublimeText3汉化版
SublimeText3汉化版

中文版,非常好用

禅工作室 13.0.1
禅工作室 13.0.1

功能强大的PHP集成开发环境

Dreamweaver CS6
Dreamweaver CS6

视觉化网页开发工具

SublimeText3 Mac版
SublimeText3 Mac版

神级代码编辑软件(SublimeText3)