手册

微信公众平台开发概述

微信公众平台开发概述微信开发者规范微信公众号接口权限说明微信公众号接口调用频次限制说明

开始开发

微信开发者平台接入指南微信公众平台接口域名说明微信公众平台获取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 微信公众平台开发者文档

微信会话控制

阅读41837

更新时间2022-04-11

微信客服管理

微信获取聊天记录

会话控制

创建会话

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

调用说明

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

返回说明

返回数据示例（正确时的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"

}

参数说明

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

返回说明

返回数据示例（正确时的JSON返回结果）：

{

"errcode" : 0,

"errmsg" : "ok"

}

主要返回码

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

获取客户会话状态

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

调用说明

1 2	`http请求方式: GET` `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完整客服帐号，格式为：帐号前缀@公众号微信号返回说

返回数据示例（正确时的JSON返回结果）：

{

"sessionlist" : [

{

"createtime" : 123456789,

"openid" : "OPENID"

},

{

"createtime" : 123456789,

"openid" : "OPENID"

}

]

}

获取未接入会话列表

调用说明

1 2	`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"

}

]

}

参数说明

参数	说明
count	未接入会话数量
waitcaselist	未接入会话列表，最多返回100条数据，按照来访顺序
openid	粉丝的openid
latest_time	粉丝的最后一条消息的时间

返回码说明

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

微信客服管理

微信获取聊天记录