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