接收普通消息
接收普通消息
當普通微信用戶向公眾賬號發(fā)消息時，微信服務器將POST消息的XML數(shù)據(jù)包到開發(fā)者填寫的URL上。
請注意：
1、關于重試的消息排重，推薦使用msgid排重。
2、微信服務器在五秒內(nèi)收不到響應會斷掉連接，并且重新發(fā)起請求，總共重試三次。假如服務器無法保證在五秒內(nèi)處理并回復，
可以直接回復空串，微信服務器不會對此作任何處理，并且不會發(fā)起重試。詳情請見“發(fā)送消息-被動回復消息”。
3、如果開發(fā)者需要對用戶消息在5秒內(nèi)立即做出回應，即使用“發(fā)送消息-被動回復消息”接口向用戶被動回復消息時，可以在
公眾平臺官網(wǎng)的開發(fā)者中心處設置消息加密。開啟加密后，用戶發(fā)來的消息和開發(fā)者回復的消息都會被加密（但開發(fā)者通過客服
接口等API調(diào)用形式向用戶發(fā)送消息，則不受影響）。關于消息加解密的詳細說明，請見“發(fā)送消息-被動回復消息加解密說明”。
各消息類型的推送XML數(shù)據(jù)包結(jié)構(gòu)如下：
文本消息
<xml> |
使用網(wǎng)頁調(diào)試工具調(diào)試該接口
圖片消息
<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> |
使用網(wǎng)頁調(diào)試工具調(diào)試該接口
語音消息
<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> |
使用網(wǎng)頁調(diào)試工具調(diào)試該接口
請注意，開通語音識別后，用戶每次發(fā)送語音給公眾號時，微信會在推送的語音消息XML數(shù)據(jù)包中，增加一個Recongnition字段（注：由于客戶端緩存，開發(fā)者開啟或者關閉語音識別功能，對新關注者立刻生效，對已關注用戶需要24小時生效。開發(fā)者可以重新關注此帳號進行測試）。開啟語音識別后的語音XML數(shù)據(jù)包如下：
<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> <Recognition><![CDATA[騰訊微信團隊]]></Recognition> <MsgId>1234567890123456</MsgId> </xml> |
參數(shù)說明：
視頻消息
<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> |
使用網(wǎng)頁調(diào)試工具調(diào)試該接口
小視頻消息
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[shortvideo]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId> <MsgId>1234567890123456</MsgId> </xml> |
使用網(wǎng)頁調(diào)試工具調(diào)試該接口
地理位置消息
<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> |
使用網(wǎng)頁調(diào)試工具調(diào)試該接口
鏈接消息
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1351776360</CreateTime> <MsgType><![CDATA[link]]></MsgType> <Title><![CDATA[公眾平臺官網(wǎng)鏈接]]></Title> <Description><![CDATA[公眾平臺官網(wǎng)鏈接]]></Description> <Url><![CDATA[url]]></Url> <MsgId>1234567890123456</MsgId> </xml> |
使用網(wǎng)頁調(diào)試工具調(diào)試該接口
