微信 自定義菜單事件推送

2018-07-27 09:53 更新

自定義菜單事件推送


用戶點(diǎn)擊自定義菜單后,微信會(huì)把點(diǎn)擊事件推送給開(kāi)發(fā)者,請(qǐng)注意,點(diǎn)擊菜單彈出子菜單,不會(huì)產(chǎn)生上報(bào)。請(qǐng)注意,第3個(gè)到第8個(gè)的所有事件,僅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用戶,舊版本微信用戶點(diǎn)擊后將沒(méi)有回應(yīng),開(kāi)發(fā)者也不能正常接收到事件推送。

推送XML數(shù)據(jù)包示例:點(diǎn)擊菜單拉取消息時(shí)的事件推送

<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>

參數(shù)說(shuō)明:

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
CreateTime消息創(chuàng)建時(shí)間 (整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,CLICK
EventKey事件KEY值,與自定義菜單接口中KEY值對(duì)應(yīng)


點(diǎn)擊菜單跳轉(zhuǎn)鏈接時(shí)的事件推送

推送XML數(shù)據(jù)包示例:

<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>

參數(shù)說(shuō)明:

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
CreateTime消息創(chuàng)建時(shí)間 (整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,VIEW
EventKey事件KEY值,設(shè)置的跳轉(zhuǎn)URL
MenuID指菜單ID,如果是個(gè)性化菜單,則可以通過(guò)這個(gè)字段,知道是哪個(gè)規(guī)則的菜單被點(diǎn)擊了。

scancode_push:掃碼推事件的事件推送

推送XML數(shù)據(jù)包示例:

<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>

參數(shù)說(shuō)明:

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
CreateTime消息創(chuàng)建時(shí)間(整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,scancode_push
EventKey事件KEY值,由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定
ScanCodeInfo掃描信息
ScanType掃描類(lèi)型,一般是qrcode
ScanResult掃描結(jié)果,即二維碼對(duì)應(yīng)的字符串信息


scancode_waitmsg:掃碼推事件且彈出“消息接收中”提示框的事件推送

推送XML數(shù)據(jù)包示例:

<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>

參數(shù)說(shuō)明:

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
CreateTime消息創(chuàng)建時(shí)間 (整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,scancode_waitmsg
EventKey事件KEY值,由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定
ScanCodeInfo掃描信息
ScanType掃描類(lèi)型,一般是qrcode
ScanResult掃描結(jié)果,即二維碼對(duì)應(yīng)的字符串信息


pic_sysphoto:彈出系統(tǒng)拍照發(fā)圖的事件推送

推送XML數(shù)據(jù)包示例:

<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>

參數(shù)說(shuō)明:

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
CreateTime消息創(chuàng)建時(shí)間 (整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,pic_sysphoto
EventKey事件KEY值,由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定
SendPicsInfo發(fā)送的圖片信息
Count發(fā)送的圖片數(shù)量
PicList圖片列表
PicMd5Sum圖片的MD5值,開(kāi)發(fā)者若需要,可用于驗(yàn)證接收到圖片


pic_photo_or_album:彈出拍照或者相冊(cè)發(fā)圖的事件推送

推送XML數(shù)據(jù)包示例:

<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>

參數(shù)說(shuō)明:

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
CreateTime消息創(chuàng)建時(shí)間 (整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,pic_photo_or_album
EventKey事件KEY值,由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定
SendPicsInfo發(fā)送的圖片信息
Count發(fā)送的圖片數(shù)量
PicList圖片列表
PicMd5Sum圖片的MD5值,開(kāi)發(fā)者若需要,可用于驗(yàn)證接收到圖片


pic_weixin:彈出微信相冊(cè)發(fā)圖器的事件推送

推送XML數(shù)據(jù)包示例:

<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>

參數(shù)說(shuō)明:

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
CreateTime消息創(chuàng)建時(shí)間 (整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,pic_weixin
EventKey事件KEY值,由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定
SendPicsInfo發(fā)送的圖片信息
Count發(fā)送的圖片數(shù)量
PicList圖片列表
PicMd5Sum圖片的MD5值,開(kāi)發(fā)者若需要,可用于驗(yàn)證接收到圖片


location_select:彈出地理位置選擇器的事件推送


推送XML數(shù)據(jù)包示例:

<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[ 廣州市海珠區(qū)客村藝苑路 106號(hào)]]></Label>
<Poiname><![CDATA[]]></Poiname>
</SendLocationInfo>
</xml>

參數(shù)說(shuō)明:

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
CreateTime消息創(chuàng)建時(shí)間 (整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,location_select
EventKey事件KEY值,由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定
SendLocationInfo發(fā)送的位置信息
Location_XX坐標(biāo)信息
Location_YY坐標(biāo)信息
Scale精度,可理解為精度或者比例尺、越精細(xì)的話 scale越高
Label地理位置的字符串信息
Poiname朋友圈POI的名字,可能為空
微信自定義菜單事件推送
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)