Skip to content

message对象属性表

51Ding edited this page May 7, 2018 · 6 revisions

message对象的详细信息

公共的属性(所有消息都有的属性)
属性 描述
ToUserName 开发者微信号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间 (整型)
MsgType 消息类型,不同的类型对应不同的值
MsgId 消息id,64位整型

【普通消息】

文本消息
属性 描述
MsgType text
Content 文本消息内容
图片消息
属性 描述
MsgType image
PicUrl 图片链接(由系统生成)
MediaId 图片消息媒体id,可以作为临时素材使用
语音消息
属性 描述
MsgType voice
MediaId 语音消息媒体id,可以作为临时素材使用
Format 语音格式,如amr,speex等
视频消息
属性 描述
MsgType video
MediaId 视频消息媒体id,可以调用多媒体文件下载接口拉取数据。
ThumbMediaId 视频消息缩略图的媒体id,可以调用多媒体文件下载接口拉取数据。
小视频消息
属性 描述
MsgType shortvideo
MediaId 视频消息媒体id,可以调用多媒体文件下载接口拉取数据。
ThumbMediaId 视频消息缩略图的媒体id,可以调用多媒体文件下载接口拉取数据。
地理位置消息
属性 描述
MsgType location
Location_X 地理位置维度
Location_Y 地理位置经度
Scale 地图缩放大小
Label 地理位置信息
链接消息
属性 描述
MsgType link
Title 消息标题
Description 消息描述
Url 消息链接
文件消息
属性 描述
MsgType file
Title 文件名称
Description 文件描述
FileKey 文件的key
FileMd5 文件MD5
FileTotalLen 文件大小

【事件推送消息】

关注/取消关注事件
属性 描述
MsgType event
Event 事件类型,subscribe(订阅)、unsubscribe(取消订阅)
扫描带参数二维码事件

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

属性 描述
MsgType event
Event subscribe
EventKey 事件KEY值,qrscene_为前缀,后面为二维码的参数值
Ticket 二维码的ticket,可用来换取二维码图片

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

属性 描述
MsgType event
Event SCAN
EventKey 事件KEY值,是一个32位无符号整数,即创建二维码时的二维码scene_id
Ticket 二维码的ticket,可用来换取二维码图片
上报地理位置事件

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

属性 描述
MsgType event
Event LOCATION
Latitude 地理位置纬度
Longitude 地理位置经度
Precision 地理位置精度
自定义菜单事件

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

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

属性 描述
MsgType event
Event CLICK
EventKey 事件KEY值,与自定义菜单接口中KEY值对应

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

属性 描述
MsgType event
Event VIEW
Latitude 事件KEY值,设置的跳转URL