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

微信 自定义菜单事件推送

2018-07-27 09:53 更新

自定义菜单事件推送

用户点击自定义菜单后，微信会把点击事件推送给开发者，请注意，点击菜单弹出子菜单，不会产生上报。请注意，第3个到第8个的所有事件，仅支持微信iPhone5.4.1以上版本，和Android5.4以上版本的微信用户，旧版本微信用户点击后将没有回应，开发者也不能正常接收到事件推送。

推送XML数据包示例：点击菜单拉取消息时的事件推送

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[CLICK]]></Event>
<EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，CLICK
EventKey事件KEY值，与自定义菜单接口中KEY值对应


点击菜单跳转链接时的事件推送

推送XML数据包示例：

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[VIEW]]></Event>
<EventKey><![CDATA[www.qq.com]]></EventKey>
<MenuId>MENUID</MenuId>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，VIEW
EventKey事件KEY值，设置的跳转URL
MenuID指菜单ID，如果是个性化菜单，则可以通过这个字段，知道是哪个规则的菜单被点击了。

scancode_push：扫码推事件的事件推送

推送XML数据包示例：

<xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090502</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[scancode_push]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<ScanCodeInfo><ScanType><![CDATA[qrcode]]></ScanType>
<ScanResult><![CDATA[1]]></ScanResult>
</ScanCodeInfo>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间（整型）
MsgType消息类型，event
Event事件类型，scancode_push
EventKey事件KEY值，由开发者在创建菜单时设定
ScanCodeInfo扫描信息
ScanType扫描类型，一般是qrcode
ScanResult扫描结果，即二维码对应的字符串信息


scancode_waitmsg：扫码推事件且弹出“消息接收中”提示框的事件推送

推送XML数据包示例：

<xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090606</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[scancode_waitmsg]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<ScanCodeInfo><ScanType><![CDATA[qrcode]]></ScanType>
<ScanResult><![CDATA[2]]></ScanResult>
</ScanCodeInfo>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，scancode_waitmsg
EventKey事件KEY值，由开发者在创建菜单时设定
ScanCodeInfo扫描信息
ScanType扫描类型，一般是qrcode
ScanResult扫描结果，即二维码对应的字符串信息


pic_sysphoto：弹出系统拍照发图的事件推送

推送XML数据包示例：

<xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090651</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[pic_sysphoto]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<SendPicsInfo><Count>1</Count>
<PicList><item><PicMd5Sum><![CDATA[1b5f7c23b5bf75682a53e7b6d163e185]]></PicMd5Sum>
</item>
</PicList>
</SendPicsInfo>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，pic_sysphoto
EventKey事件KEY值，由开发者在创建菜单时设定
SendPicsInfo发送的图片信息
Count发送的图片数量
PicList图片列表
PicMd5Sum图片的MD5值，开发者若需要，可用于验证接收到图片


pic_photo_or_album：弹出拍照或者相册发图的事件推送

推送XML数据包示例：

<xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090816</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[pic_photo_or_album]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<SendPicsInfo><Count>1</Count>
<PicList><item><PicMd5Sum><![CDATA[5a75aaca956d97be686719218f275c6b]]></PicMd5Sum>
</item>
</PicList>
</SendPicsInfo>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，pic_photo_or_album
EventKey事件KEY值，由开发者在创建菜单时设定
SendPicsInfo发送的图片信息
Count发送的图片数量
PicList图片列表
PicMd5Sum图片的MD5值，开发者若需要，可用于验证接收到图片


pic_weixin：弹出微信相册发图器的事件推送

推送XML数据包示例：

<xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090816</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[pic_weixin]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<SendPicsInfo><Count>1</Count>
<PicList><item><PicMd5Sum><![CDATA[5a75aaca956d97be686719218f275c6b]]></PicMd5Sum>
</item>
</PicList>
</SendPicsInfo>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，pic_weixin
EventKey事件KEY值，由开发者在创建菜单时设定
SendPicsInfo发送的图片信息
Count发送的图片数量
PicList图片列表
PicMd5Sum图片的MD5值，开发者若需要，可用于验证接收到图片


location_select：弹出地理位置选择器的事件推送

推送XML数据包示例：

<xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408091189</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[location_select]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<SendLocationInfo><Location_X><![CDATA[23]]></Location_X>
<Location_Y><![CDATA[113]]></Location_Y>
<Scale><![CDATA[15]]></Scale>
<Label><![CDATA[ 广州市海珠区客村艺苑路 106号]]></Label>
<Poiname><![CDATA[]]></Poiname>
</SendLocationInfo>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，location_select
EventKey事件KEY值，由开发者在创建菜单时设定
SendLocationInfo发送的位置信息
Location_XX坐标信息
Location_YY坐标信息
Scale精度，可理解为精度或者比例尺、越精细的话 scale越高
Label地理位置的字符串信息
Poiname朋友圈POI的名字，可能为空
微信自定义菜单事件推送
以上内容是否对您有帮助：
← 微信 自定义菜单删除接口
微信公众平台 个性化菜单接口 →
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号