推送事件

事件本质上也是一种消息,故消息的公共属性在事件中也适用。

公共属性

每一种事件都包括以下属性:

name value
id 事件 id, 64 位整型。
source 事件的来源用户,即发送消息的用户。
target 事件的目标用户。
create_time 事件的发送时间,UNIX 时间戳
type event
event 事件的类型

关注事件

class wechatpy.events.SubscribeEvent(message)[源代码]

用户关注事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421140454

SubscribeEvent 的属性:

name value
event subscribe

取消关注事件

class wechatpy.events.UnsubscribeEvent(message)[源代码]

用户取消关注事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421140454

UnsubscribeEvent 的属性:

name value
event unsubscribe

未关注用户扫描带参数二维码事件

class wechatpy.events.SubscribeScanEvent(message)[源代码]

用户扫描二维码关注事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421140454

SubscribeScanEvent 的属性:

name value
event subscribe_scan
scene_id 带参数二维码 scene_id,去除了前缀 qrscene_
ticket 带参数二维码 ticket

已关注用户扫描带参数二维码事件

class wechatpy.events.ScanEvent(message)[源代码]

用户扫描二维码事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421140454

ScanEvent 的属性:

name value
event scan
scene_id 带参数二维码 scene_id
ticket 带参数二维码 ticket

上报地理位置事件

class wechatpy.events.LocationEvent(message)[源代码]

上报地理位置事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421140454

LocationEvent 的属性:

name value
event location
latitude 地理位置纬度
longitude 地理位置经度
precision 地理位置精度

点击菜单拉取消息事件

class wechatpy.events.ClickEvent(message)[源代码]

点击菜单拉取消息事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421140454

ClickEvent 的属性:

name value
event click
key 自定义菜单 key 值

点击菜单跳转链接事件

class wechatpy.events.ViewEvent(message)[源代码]

点击菜单跳转链接事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421140454

ViewEvent 的属性:

name value
event view
url 跳转链接 url

群发消息发送任务完成事件

class wechatpy.events.MassSendJobFinishEvent(message)[源代码]

群发消息任务完成事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1481187827_i0l21

MassSendJobFinishEvent 的属性:

name value
event masssendjobfinish
status 群发任务状态
total_count 发送的总粉丝数
filter_count 过滤后准备发送的粉丝数
sent_count 发送成功的粉丝数
error_count 发送失败的粉丝数

模板消息发送任务完成事件

class wechatpy.events.TemplateSendJobFinishEvent(message)[源代码]

模板消息任务完成事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1433751277

TemplateSendJobFinishEvent 的属性:

name value
event templatesendjobfinish
status 模板消息发送状态

扫码推事件

class wechatpy.events.ScanCodePushEvent(message)[源代码]

扫码推事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421141016

ScanCodePushEvent 的属性:

name value
event scancode_push
key 自定义菜单 key
scan_type 扫描类型
scan_result 扫描结果

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

class wechatpy.events.ScanCodeWaitMsgEvent(message)[源代码]

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

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421141016

ScanCodeWaitMsgEvent 的属性:

name value
event scancode_waitmsg
key 自定义菜单 key
scan_type 扫描类型
scan_result 扫描结果

弹出系统拍照发图事件

class wechatpy.events.PicSysPhotoEvent(message)[源代码]

弹出系统拍照发图的事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421141016

PicSysPhotoEvent 的属性:

name value
event pic_sysphoto
key 自定义菜单 key
count 发送的图片数量
pictures 图片列表

弹出拍照或者相册发图事件

class wechatpy.events.PicPhotoOrAlbumEvent(message)[源代码]

弹出拍照或者相册发图的事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421141016

PicPhotoOrAlbumEvent 的属性:

name value
event pic_photo_or_album
key 自定义菜单 key
count 发送的图片数量
pictures 图片列表

弹出微信相册发图器事件

class wechatpy.events.PicWeChatEvent(message)[源代码]

弹出微信相册发图器的事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421141016

PicWeChatEvent 的属性:

name value
event pic_weixin
key 自定义菜单 key
count 发送的图片数量
pictures 图片列表

弹出地理位置选择器事件

class wechatpy.events.LocationSelectEvent(message)[源代码]

弹出地理位置选择器的事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1421141016

LocationSelectEvent 的属性:

name value
event location_select
key 自定义菜单 key
location_x 地理位置纬度
location_y 地理位置经度
location 地理位置元组: (纬度, 经度)
scale 地理位置精度
label 地理位置信息字符串
poiname 朋友圈 POI 的名字,可能为空

微信认证事件推送

资质认证成功事件

class wechatpy.events.QualificationVerifySuccessEvent(message)[源代码]

资质认证成功事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1455785130

QualificationVerifySuccessEvent 的属性:

参数
event qualification_verify_success
expired_time 有效期,将于该时间戳认证过期

资质认证失败事件

class wechatpy.events.QualificationVerifyFailEvent(message)[源代码]

资质认证失败事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1455785130

QualificationVerifyFailEvent 的属性:

参数
event qualification_verify_fail
fail_time 失败发生时间
fail_reason 认证失败的原因

名称认证成功

class wechatpy.events.NamingVerifySuccessEvent(message)[源代码]

名称认证成功事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1455785130

NamingVerifySuccessEvent 的属性:

参数
event naming_verify_success
expired_time 有效期,将于该时间戳认证过期

名称认证失败

class wechatpy.events.NamingVerifyFailEvent(message)[源代码]

名称认证失败事件

客户端不打勾,但仍有接口权限。详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1455785130

NamingVerifyFailEvent 的属性:

参数
event naming_verify_fail
fail_time 失败发生时间
fail_reason 认证失败的原因

年审通知

class wechatpy.events.AnnualRenewEvent(message)[源代码]

年审通知事件

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1455785130

AnnualRenewEvent 的属性:

参数
event annual_renew
expired_time 有效期,将于该时间戳认证过期,需尽快年审

认证过期失效通知

class wechatpy.events.VerifyExpiredEvent(message)[源代码]

认证过期失效通知

详情请参阅 https://mp.weixin.qq.com/wiki?id=mp1455785130

VerifyExpiredEvent 的属性:

参数
event verify_expired
expired_time 有效期,表示已于该时间戳认证过期,需要重新发起微信认证

微信扫一扫事件

打开商品主页事件

class wechatpy.events.UserScanProductEvent(message)[源代码]

打开商品主页事件

详情请参考 https://mp.weixin.qq.com/wiki?id=mp1455872179

UserScanProductEvent 的属性:

参数
event user_scan_product
standard 商品编码标准
key 商品编码内容
country 用户在微信内设置的国家
province 用户在微信内设置的省份
city 用户在微信内设置的城市
sex 用户的性别,1为男性,2为女性,0代表未知
scene 打开商品主页的场景,1为扫码,2为其他打开场景(如会话、收藏或朋友圈)

进入公众号事件

class wechatpy.events.UserScanProductEnterSessionEvent(message)[源代码]

进入公众号事件

详情请参考 https://mp.weixin.qq.com/wiki?id=mp1455872179

UserScanProductEnterSessionEvent 的属性:

参数
event user_scan_product_enter_session
standard 商品编码标准
key 商品编码内容

地理位置信息异步推送事件

class wechatpy.events.UserScanProductAsyncEvent(message)[源代码]

地理位置信息异步推送事件

详情请参考 https://mp.weixin.qq.com/wiki?id=mp1455872179

UserScanProductAsyncEvent 的属性:

参数
event user_scan_product_async
standard 商品编码标准
key 商品编码内容
region_code 用户的实时地理位置信息

商品审核结果事件

class wechatpy.events.UserScanProductVerifyActionEvent(message)[源代码]

商品审核结果事件

详情请参考 https://mp.weixin.qq.com/wiki?id=mp1455872179

参数
event user_scan_product_async
standard 商品编码标准
key 商品编码内容
result 审核结果。verify_ok 表示审核通过,verify_not_pass 表示审核未通过
reason 审核未通过的原因

当用户在商品主页中关注公众号事件

class wechatpy.events.SubscribeScanProductEvent(message)[源代码]

用户在商品主页中关注公众号事件

详情请参考 https://mp.weixin.qq.com/wiki?id=mp1455872179

参数
event subscribe_scan_product
scene scanbarcode 为扫码场景,scanimage 为扫封面(图像)场景
standard 商品编码标准
key 商品编码内容

用户授权发票事件

class wechatpy.events.UserAuthorizeInvoiceEvent(message)[源代码]

用户授权发票事件 (会包含一个订单号,不成功就失败)

详情请参考 https://mp.weixin.qq.com/wiki?id=mp1497082828_r1cI2

参数
event user_authorize_invoice
success_order_id 授权成功的订单号
fail_order_id 授权失败的订单号
app_id 用于接收事件推送的公众号的AppId
auth_source 授权来源,web表示来自微信内H5,app标识来自app

发票状态更新事件

class wechatpy.events.UpdateInvoiceStatusEvent(message)[源代码]

发票状态更新事件

详情请参考 https://mp.weixin.qq.com/wiki?id=mp1497082828_r1cI2

参数
event update_invoice_status
status 发票报销状态
card_id 发票卡券 Card ID
code 发票卡券 Code

用户提交发票抬头事件

class wechatpy.events.SubmitInvoiceTitleEvent(message)[源代码]

用户提交发票抬头事件

详情请参考 https://mp.weixin.qq.com/wiki?id=mp1496554912_vfWU0

参数
event submit_invoice_title
title 抬头
phone 联系方式
tax_no 税号
addr 地址
bank_type 银行类型
bank_no 银行号码
attach 附加字段
title_type 抬头类型,InvoiceUserTitlePersonType为个人抬头,InvoiceUserTitleBusinessType为公司抬头