手册

微信公众平台开发概述

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

开始开发

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

扫一扫事件推送

阅读41563

更新时间2022-04-11

微信商品管理

一物一码专区

扫一扫事件推送

微信扫一扫

事件推送

用户打开商品主页，用户从商品主页关注或进入公众号等情况下均会触发事件推送。该事件将推送至商户填写的URL（登录微信公众平台=>开发者中心设置）。开发者可通过事件推送完成数据统计、用户身份识别等操作，实现更加精准的运营。

微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次。关于重试的消息排重，推荐使用FromUserName + CreateTime 排重。假如服务器无法保证在五秒内处理并回复，可以直接回复空串，微信服务器不会对此作任何处理，并且不会发起重试。

打开商品主页事件推送

当用户打开商品主页，无论是通过扫码，还是从其他场景（会话、收藏或朋友圈）打开，微信均会推送该事件到商户填写的URL。推送的内容包括用户基本信息，以及商品主页对应的码信息。

推送XML示例

推送参数说明

参数	说明
ToUserName	商户的公众号原始id。
FromUserName	用户的openid。
CreateTime	消息创建时间（整型）。
MsgType	消息类型，event。
Event	事件类型，user_scan_product为打开商品主页事件。
KeyStandard	商品编码标准。
KeyStr	商品编码内容。
Country	用户在微信内设置的国家。
Province	用户在微信内设置的省份。
City	用户在微信内设置的城市。
Sex	用户的性别，1为男性，2为女性，0代表未知。
Scene	打开商品主页的场景，1为扫码，2为其他打开场景（如会话、收藏或朋友圈）。
ExtInfo	调用“获取商品二维码接口”时传入的extinfo，为标识参数。

关注公众号事件推送

当用户在商品主页中关注公众号，微信会推送该事件到商户填写的URL。推送的内容包括关注用户的基本信息、时间、关注场景及对应的码信息。

推送XML示例

1433259128

推送参数说明

参数	说明
ToUserName	商户的公众号原始id。
FromUserName	用户的openid。
CreateTime	消息创建时间（整型）。
MsgType	消息类型，event。
Event	事件类型，subscribe为关注公众号事件。
EventKey	”分割。①scene表示场景：scanbarcode为扫码场景，scanimage为扫封面（图像）场景。②keystandard表示商品编码标准：barcode为条码。③keystr表示商品编码内容。④extinfo表示调用“获取商品二维码接口”时传入的extinfo，为标识参数。

进入公众号事件推送

当用户从商品主页进入公众号会话时，微信会推送该事件到商户填写的URL。推送的内容包括用户的基本信息、时间、关注场景及对应的条码信息。

推送XML示例

1433259128

推送参数说明

参数	说明
ToUserName	商户的公众号原始id。
FromUserName	用户的openid。
CreateTime	消息创建时间（整型）。
MsgType	消息类型，event。
Event	事件类型，user_scan_product_enter_session为进入公众号事件。
KeyStandard	商品编码标准。
KeyStr	商品编码内容。
ExtInfo	调用“获取商品二维码接口”时传入的extinfo，为标识参数。

地理位置信息异步推送

当用户打开商品主页，微信会将该用户实时的地理位置信息以异步事件的形式推送到商户填写的URL。商户可利用该信息做数据分析，形成差异化运营方案或指导生产。

推送的地理位置信息为“省”一级，如广东省。由于用户的网速影响，异步推送的响应速度可能较慢。

推送XML示例

1434541327

推送参数说明

参数	说明
ToUserName	商户的公众号原始id。
FromUserName	用户的openid。
CreateTime	消息创建时间（整型）。
MsgType	消息类型，event。
Event	事件类型，user_scan_product_async为异步事件。
KeyStandard	商品编码标准。
KeyStr	商品编码内容。
ExtInfo	调用“获取商品二维码接口”时传入的extinfo，为标识参数。
RegionCode	用户的实时地理位置信息（目前只精确到省一级），可在国家统计局网站查到对应明细：http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201504/t20150415_712722.html

商品审核结果推送

提交审核的商品，完成审核后，微信会将审核结果以事件的形式推送到商户填写的URL。

推送XML示例

1450429257

推送参数说明

参数	说明
ToUserName	商户的公众号原始id。
FromUserName	扫一扫审核系统。
CreateTime	消息创建时间（整型）。
MsgType	消息类型，event。
Event	事件类型，user_scan_product_verify_action为审核结果事件。
KeyStandard	商品编码标准。
KeyStr	商品编码内容。
Result	审核结果。verify_ok表示审核通过，verify_not_pass表示审核未通过。
ReasonMsg	审核未通过的原因。

微信商品管理

一物一码专区