手册目录

微信公众平台开发概述

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

开始开发

微信开发者平台接入指南微信公众平台接口域名说明微信公众平台获取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接口返回错误码微信连网过程常见错误码

微信扫一扫

微信扫一扫接入指南微信上进行商品创建微信商品发布微信商品管理扫一扫事件推送一物一码专区扫一扫错误码在线帮助工具

微信公众平台开发者文档

更新时间2022-04-11

将消息转发到微信客服微信会话控制

客服管理

获取客服基本信息

调用说明

1 2	`http请求方式: GET` `https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN`

返回说明

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

{

"kf_list" : [

{

"kf_account" : "test1@test",

"kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",

"kf_id" : "1001",

"kf_nick" : "ntest1",

"kf_wx" : "kfwx1"

},

{

"kf_account" : "test2@test",

"kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",

"kf_id" : "1002",

"kf_nick" : "ntest2",

"kf_wx" : "kfwx2"

},

{

"kf_account" : "test3@test",

"kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",

"kf_id" : "1003",

"kf_nick" : "ntest3",

"invite_wx" : "kfwx3",

"invite_expire_time" : 123456789,

"invite_status" : "waiting"

}

]

}

参数说明

参数	说明
kf_account	完整客服帐号，格式为：帐号前缀@公众号微信号
kf_nick	客服昵称
kf_id	客服编号
kf_headimgurl	客服头像
kf_wx	如果客服帐号已绑定了客服人员微信号，则此处显示微信号
invite_wx	如果客服帐号尚未绑定微信号，但是已经发起了一个绑定邀请，则此处显示绑定邀请的微信号
invite_expire_time	如果客服帐号尚未绑定微信号，但是已经发起过一个绑定邀请，邀请的过期时间，为unix 时间戳
invite_status	邀请的状态，有等待确认“waiting”，被拒绝“rejected”，过期“expired”

获取客服基本信息

调用说明

1 2	`http请求方式: GET` `https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN`

返回说明

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

{

"kf_online_list": [

{

"kf_account": "test1@test",

"status": 1,

"kf_id": "1001",

"accepted_case": 1

},

{

"kf_account": "test2@test",

"status": 1,

"kf_id": "1002",

"accepted_case": 2

}

]

}

参数说明

参数	说明
kf_account	完整客服帐号，格式为：帐号前缀@公众号微信号
status	客服在线状态，目前为：1、web 在线
kf_id	客服编号
accepted_case	客服当前正在接待的会话数