接收普通訊息

#當一般微信用戶傳送訊息給公眾帳號時，微信伺服器將POST訊息的XML封包到開發者填寫的URL上。

請注意：

1、關於重試的訊息排重，推薦使用msgid排重。

2、微信伺服器在五秒鐘內收不到回應會斷掉連接，並且重新發起請求，總共重試三次。假如伺服器無法保證在五秒內處理並回复，

可以直接回复空串，微信伺服器不會對此作任何處理，並且不會發起重試。詳情請見「發送訊息-被動回覆訊息」。

3、如果開發者需要對使用者訊息在5秒內立即回應，即使用「傳送訊息-被動回覆訊息」介面向使用者被動回覆訊息時，可以在

#公眾平台官網的開發者中心處設定訊息加密。開啟加密後，用戶發送的訊息和開發者回覆的訊息都會被加密（但開發者透過客服

介面等API呼叫形式向用戶發送訊息，則不受影響）。關於訊息加解密的詳細說明，請參閱「傳送訊息-被動回覆訊息加解密說明」。

各訊息類型的推送XML封包結構如下：

文字訊息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName><![CDATA[fromUser]]></FromUserName> ;CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[text]]></MsgType> ; ></Content>
<MsgId>1234567890123456</MsgId>
</xml>

QQ截图20170207160054.png

##白圖片訊息

#使用網頁偵錯工具來偵錯該介面

############

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

###### ######

QQ截图20170207160115.png

使用網頁偵錯工具偵錯該介面

語音訊息

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

QQ截图20170207160130.png

使用網頁偵錯工具偵錯該介面

請注意，開通語音識別後，用戶每次發送語音給公眾號時，微信會在推送的語音訊息XML資料包中，增加一個Recongnition欄位（註：由於客戶端緩存，開發者開啟或關閉語音識別功能，對新追蹤者立刻生效，對已關注用戶需要24小時生效。開發者可以重新關注此帳號進行測試）。開啟語音辨識後的語音XML封包如下：

參數說明：

影片訊息

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

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

QQ截图20170207160157.png

使用網頁偵錯工具偵錯該介面

#小視訊訊息

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

QQ截图20170207160213.png

#使用網頁偵錯工具偵錯該介面

地理位置訊息

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

QQ截图20170207160227.png

使用網頁偵錯工具偵錯該介面

連結訊息

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

QQ截图20170207160240.png

使用網頁偵錯工具偵錯該介面

接收普通訊息