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