當普通微信用戶向公眾賬號發消息時,微信服務器將POST消息的XML數據包到開發者填寫的URL上。各消息類型的推送XML數據包結構如下。
文本消息
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[this is a test]]></Content>
<MsgId>1234567890123456</MsgId>
</xml>
| 參數 |
描述 |
| ToUserName |
開發者微信號 |
| FromUserName |
發送方帳號(一個OpenID) |
| CreateTime |
消息創建時間 (整型) |
| MsgType |
text |
| Content |
文本消息內容 |
| MsgId |
消息id,64位整型 |
使用網頁調試工具調試該接口
圖片消息
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<PicUrl><![CDATA[this is a url]]></PicUrl>
<MediaId><![CDATA[media_id]]></MediaId>
<MsgId>1234567890123456</MsgId>
</xml>
| 參數 |
描述 |
| ToUserName |
開發者微信號 |
| FromUserName |
發送方帳號(一個OpenID) |
| CreateTime |
消息創建時間 (整型) |
| MsgType |
image |
| PicUrl |
圖片鏈接 |
| MediaId |
圖片消息媒體id,可以調用多媒體文件下載接口拉取數據。 |
| MsgId |
消息id,64位整型 |
使用網頁調試工具調試該接口
語音消息
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<Format><![CDATA[Format]]></Format>
<MsgId>1234567890123456</MsgId>
</xml>
| 參數 |
描述 |
| ToUserName |
開發者微信號 |
| FromUserName |
發送方帳號(一個OpenID) |
| CreateTime |
消息創建時間 (整型) |
| MsgType |
語音為voice |
| MediaId |
語音消息媒體id,可以調用多媒體文件下載接口拉取數據。 |
| Format |
語音格式,如amr,speex等 |
| MsgID |
消息id,64位整型 |
使用網頁調試工具調試該接口
視頻消息
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
<MsgId>1234567890123456</MsgId>
</xml>
| 參數 |
描述 |
| ToUserName |
開發者微信號 |
| FromUserName |
發送方帳號(一個OpenID) |
| CreateTime |
消息創建時間 (整型) |
| MsgType |
視頻為video |
| MediaId |
視頻消息媒體id,可以調用多媒體文件下載接口拉取數據。 |
| ThumbMediaId |
視頻消息縮略圖的媒體id,可以調用多媒體文件下載接口拉取數據。 |
| MsgId |
消息id,64位整型 |
使用網頁調試工具調試該接口
地理位置消息
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>23.134521</Location_X>
<Location_Y>113.358803</Location_Y>
<Scale>20</Scale>
<Label><![CDATA[位置信息]]></Label>
<MsgId>1234567890123456</MsgId>
</xml>
| 參數 |
描述 |
| ToUserName |
開發者微信號 |
| FromUserName |
發送方帳號(一個OpenID) |
| CreateTime |
消息創建時間 (整型) |
| MsgType |
location |
| Location_X |
地理位置維度 |
| Location_Y |
地理位置精度 |
| Scale |
地圖縮放大小 |
| Label |
地理位置信息 |
| MsgId |
消息id,64位整型 |
使用網頁調試工具調試該接口
鏈接消息
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[公眾平台官網鏈接]]></Title>
<Description><![CDATA[公眾平台官網鏈接]]></Description>
<Url><![CDATA[url]]></Url>
<MsgId>1234567890123456</MsgId>
</xml>
| 參數 |
描述 |
| ToUserName |
接收方微信號 |
| FromUserName |
發送方微信號,若為普通用戶,則是一個OpenID |
| CreateTime |
消息創建時間 |
| MsgType |
消息類型,link |
| Title |
消息標題 |
| Description |
消息描述 |
| Url |
消息鏈接 |
| MsgId |
消息id,64位整型 |
使用網頁調試工具調試該接口
以上消息來自騰訊微信公眾號開發幫助