社区
学习
工具库
AI工具
休闲
搜索
简体中文
搜索
logo
  • 登录
  • 注册
密码重置成功

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

工具标签
微信公众平台开发概述
微信公众平台开发概述 微信开发者规范 微信公众号接口权限说明 微信公众号接口调用频次限制说明
开始开发
微信开发者平台接入指南 微信公众平台 接口域名说明 微信公众平台 获取access_token 获取微信服务器IP地址 报警排查指引 接口测试号申请
微信自定义开发
自定义菜单创建接口 自定义菜单查询接口 自定义菜单删除接口 自定义菜单事件推送 个性化菜单接口 获取自定义菜单配置接口
消息管理
接收普通消息 接收事件推送 被动回复用户消息 消息加解密说明 客服消息 高级群发接口 模板消息接口 模板消息运营规范 获取公众号的自动回复规则
微信网页开发
微信网页授权 微信网页开发样式库 微信JS-SDK说明文档 微信web开发者工具
素材管理
新增临时素材 获取临时素材 新增永久素材 删除永久素材 修改永久图文素材 获取素材总数 获取素材列表
用户管理
用户标签管理 设置用户备注名 获取用户基本信息(UnionID机制) 获取用户列表 获取用户地理位置 黑名单管理
账号管理
生成带参数的二维码 长链接转短链接接口 微信认证事件推送
数据统计
用户分析数据接口 图文分析数据接口 消息分析数据接口 接口分析数据接口
微信卡券接口说明
微信卡券接口 创建卡券 投放卡券 核销卡券 管理卡券 卡券事件推送 会员卡专区（一） 会员卡专区（二） 朋友的券专区 特殊票券 第三方开发者模式 卡券错误码
微信门店
微信门店接口
微信小店
微信小店接口 语义理解接口
微信设备功能
微信服务号设备功能介绍 如何新增产品型号
新版客服功能
将消息转发到微信客服 微信客服管理 微信会话控制 微信获取聊天记录
微信摇一摇周边
申请开通微信摇一摇 微信设备ID 微信摇一摇页面管理 微信摇一摇上传图片素材 管理设备与页面的关联关系 微信摇一摇数据统计 摇一摇关注的JSAPI 摇一摇事件通知 html5页面获取设备信息 微信摇一摇获取设备及用户信息 摇一摇红包介绍说明 摇一摇周边错误码
微信连WIFI
微信连Wi-Fi开发者指引 Wi-Fi硬件鉴权协议接口说明 Wi-Fi软件服务管理接口说明 开通微信连Wi-Fi插件 Wi-Fi门店管理 Wi-Fi设备管理 配置微信WiFi联网方式 微信商家主页管理 Wi-Fi数据统计 连网后下发消息 微信卡券投放 微信Wi-Fi接口返回错误码 微信连网过程常见错误码
微信扫一扫
微信扫一扫接入指南 微信上进行商品创建 微信商品发布 微信商品管理 扫一扫事件推送 一物一码专区 扫一扫错误码 在线帮助工具
首页 后端开发 PHP 微信公众平台开发者文档 微信会话控制
目录
工具标签
微信公众平台开发概述
微信公众平台开发概述 微信开发者规范 微信公众号接口权限说明 微信公众号接口调用频次限制说明
开始开发
微信开发者平台接入指南 微信公众平台 接口域名说明 微信公众平台 获取access_token 获取微信服务器IP地址 报警排查指引 接口测试号申请
微信自定义开发
自定义菜单创建接口 自定义菜单查询接口 自定义菜单删除接口 自定义菜单事件推送 个性化菜单接口 获取自定义菜单配置接口
消息管理
接收普通消息 接收事件推送 被动回复用户消息 消息加解密说明 客服消息 高级群发接口 模板消息接口 模板消息运营规范 获取公众号的自动回复规则
微信网页开发
微信网页授权 微信网页开发样式库 微信JS-SDK说明文档 微信web开发者工具
素材管理
新增临时素材 获取临时素材 新增永久素材 删除永久素材 修改永久图文素材 获取素材总数 获取素材列表
用户管理
用户标签管理 设置用户备注名 获取用户基本信息(UnionID机制) 获取用户列表 获取用户地理位置 黑名单管理
账号管理
生成带参数的二维码 长链接转短链接接口 微信认证事件推送
数据统计
用户分析数据接口 图文分析数据接口 消息分析数据接口 接口分析数据接口
微信卡券接口说明
微信卡券接口 创建卡券 投放卡券 核销卡券 管理卡券 卡券事件推送 会员卡专区（一） 会员卡专区（二） 朋友的券专区 特殊票券 第三方开发者模式 卡券错误码
微信门店
微信门店接口
微信小店
微信小店接口 语义理解接口
微信设备功能
微信服务号设备功能介绍 如何新增产品型号
新版客服功能
将消息转发到微信客服 微信客服管理 微信会话控制 微信获取聊天记录
微信摇一摇周边
申请开通微信摇一摇 微信设备ID 微信摇一摇页面管理 微信摇一摇上传图片素材 管理设备与页面的关联关系 微信摇一摇数据统计 摇一摇关注的JSAPI 摇一摇事件通知 html5页面获取设备信息 微信摇一摇获取设备及用户信息 摇一摇红包介绍说明 摇一摇周边错误码
微信连WIFI
微信连Wi-Fi开发者指引 Wi-Fi硬件鉴权协议接口说明 Wi-Fi软件服务管理接口说明 开通微信连Wi-Fi插件 Wi-Fi门店管理 Wi-Fi设备管理 配置微信WiFi联网方式 微信商家主页管理 Wi-Fi数据统计 连网后下发消息 微信卡券投放 微信Wi-Fi接口返回错误码 微信连网过程常见错误码
微信扫一扫
微信扫一扫接入指南 微信上进行商品创建 微信商品发布 微信商品管理 扫一扫事件推送 一物一码专区 扫一扫错误码 在线帮助工具

微信会话控制

收藏 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

相关视频

免费 最新ThinkPHP 5.1全球首发视频教程(60天成就PHP大牛线上培训班课)
免费 简单聊聊PHP创业那点事
免费 大型实战天龙八部之开发Mini版MVC框架仿糗事百科网站
免费 Web前端开发极速入门
免费 登录验证与经典留言板
免费 PHP实战开发极速入门： PHP快速创建[小型商业论坛]
热AI工具
Undress AI Tool
Undress AI Tool

免费脱衣服图片

AI Clothes Remover
AI Clothes Remover

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

Undresser.AI Undress
Undresser.AI Undress

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

ArtGPT
Stock Market GPT
Stock Market GPT

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

显示更多
热门文章
如何将 jQuery 的拖放事件正确迁移到原生 JavaScript 1 个月前     By DDD
记事本升级、更便宜的 YouTube TV 以及 Nova Launcher 的新主人：新闻综述 3 周前     By DDD
精灵宝可梦 Pokopia 中铁矿石的获取方法 4 周前     By Jack chen
解决Python安装包时multidict构建失败的错误 4 周前     By DDD
如何在Golang中应用外观模式(Facade) Go语言简化复杂系统的API 3 周前     By DDD
显示更多
热门话题
# 抖音等级价目表1-75
20518
7
# wifi显示无ip分配
13631
4
# 虚拟手机号接收验证码
11966
4
# gmail邮箱登陆入口在哪里
8993
17
# windows安全中心怎么关闭
8505
7
显示更多
热门工具
记事本++7.3.1
记事本++7.3.1

好用且免费的代码编辑器

SublimeText3汉化版
SublimeText3汉化版

中文版，非常好用

禅工作室 13.0.1
禅工作室 13.0.1

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

Dreamweaver CS6
Dreamweaver CS6

视觉化网页开发工具

SublimeText3 Mac版
SublimeText3 Mac版

神级代码编辑软件(SublimeText3)

显示更多