微信公众平台的开发者文档
微信公众平台的开发者文档
  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. 微信扫一扫常见问题
阅读(28k) 书签 赞(0) 我要纠错

微信平台开发 接收事件推送

2019-03-14 11:40 更新

接收事件推送

在微信用户和公众号产生交互的过程中，用户的某些操作会使得微信服务器通过事件推送的形式通知到开发者在开发者中心处设置的服务器地址，从而开发者可以获取到该信息。其中，某些事件推送在发生后，是允许开发者回复用户的，某些则不允许，详细说明请见本页末尾的微信推送消息与事件说明。

关注/取消关注事件

用户在关注与取消关注公众号时，微信会把这个事件推送到开发者填写的URL。方便开发者给用户下发欢迎消息或者做帐号的解绑。

微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次。

关于重试的消息排重，推荐使用FromUserName + CreateTime 排重。

假如服务器无法保证在五秒内处理并回复，可以直接回复空串，微信服务器不会对此作任何处理，并且不会发起重试。


推送XML数据包示例：

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

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，subscribe(订阅)、unsubscribe(取消订阅)

使用网页调试工具调试该接口

扫描带参数二维码事件

用户扫描带场景值二维码时，可能推送以下两种事件：

  1. 如果用户还未关注公众号，则用户可以关注公众号，关注后微信会将带场景值关注事件推送给开发者。

  2. 如果用户已经关注公众号，则微信会将带场景值扫描事件推送给开发者。

1. 用户未关注时，进行关注后的事件推送

推送XML数据包示例：

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[subscribe]]></Event>
<EventKey><![CDATA[qrscene_123123]]></EventKey>
<Ticket><![CDATA[TICKET]]></Ticket>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，subscribe
EventKey事件KEY值，qrscene_为前缀，后面为二维码的参数值
Ticket二维码的ticket，可用来换取二维码图片

2. 用户已关注时的事件推送

推送XML数据包示例：

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[SCAN]]></Event>
<EventKey><![CDATA[SCENE_VALUE]]></EventKey>
<Ticket><![CDATA[TICKET]]></Ticket>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，SCAN
EventKey事件KEY值，是一个32位无符号整数，即创建二维码时的二维码scene_id
Ticket二维码的ticket，可用来换取二维码图片

使用网页调试工具调试该接口

上报地理位置事件

用户同意上报地理位置后，每次进入公众号会话时，都会在进入时上报地理位置，或在进入会话后每5秒上报一次地理位置，公众号可以在公众平台网站中修改以上设置。上报地理位置时，微信会将上报地理位置事件推送到开发者填写的URL。

推送XML数据包示例：

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[LOCATION]]></Event>
<Latitude>23.137466</Latitude>
<Longitude>113.352425</Longitude>
<Precision>119.385040</Precision>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，LOCATION
Latitude地理位置纬度
Longitude地理位置经度
Precision地理位置精度

使用网页调试工具调试该接口

自定义菜单事件

用户点击自定义菜单后，微信会把点击事件推送给开发者，请注意，点击菜单弹出子菜单，不会产生上报。

点击菜单拉取消息时的事件推送

推送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>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，event
Event事件类型，VIEW
EventKey事件KEY值，设置的跳转URL

使用网页调试工具调试该接口

消息调试接口

以上内容是否对您有帮助：
← 微信平台 接收普通消息
微信平台 被动回复用户消息 →
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号