微信平臺 接收普通消息

2019-03-14 11:40 更新

接收普通消息

當(dāng)普通微信用戶向公眾賬號發(fā)消息時，微信服務(wù)器將POST消息的XML數(shù)據(jù)包到開發(fā)者填寫的URL上。

請注意：

1、關(guān)于重試的消息排重，推薦使用msgid排重。

2、微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會斷掉連接，并且重新發(fā)起請求，總共重試三次。假如服務(wù)器無法保證在五秒內(nèi)處理并回復(fù)，

可以直接回復(fù)空串，微信服務(wù)器不會對此作任何處理，并且不會發(fā)起重試。詳情請見“發(fā)送消息-被動回復(fù)消息”。

3、如果開發(fā)者需要對用戶消息在5秒內(nèi)立即做出回應(yīng)，即使用“發(fā)送消息-被動回復(fù)消息”接口向用戶被動回復(fù)消息時，可以在

公眾平臺官網(wǎng)的開發(fā)者中心處設(shè)置消息加密。開啟加密后，用戶發(fā)來的消息和開發(fā)者回復(fù)的消息都會被加密（但開發(fā)者通過客服

接口等API調(diào)用形式向用戶發(fā)送消息，則不受影響）。關(guān)于消息加解密的詳細(xì)說明，請見“發(fā)送消息-被動回復(fù)消息加解密說明”。

各消息類型的推送XML數(shù)據(jù)包結(jié)構(gòu)如下：

文本消息

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


參數(shù)描述
ToUserName開發(fā)者微信號
FromUserName發(fā)送方帳號（一個OpenID）
CreateTime消息創(chuàng)建時間 （整型）
MsgTypetext
Content文本消息內(nèi)容
MsgId消息id，64位整型

使用網(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>


參數(shù)描述
ToUserName開發(fā)者微信號
FromUserName發(fā)送方帳號（一個OpenID）
CreateTime消息創(chuàng)建時間 （整型）
MsgTypeimage
PicUrl圖片鏈接（由系統(tǒng)生成）
MediaId圖片消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
MsgId消息id，64位整型

使用網(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>


參數(shù)描述
ToUserName開發(fā)者微信號
FromUserName發(fā)送方帳號（一個OpenID）
CreateTime消息創(chuàng)建時間 （整型）
MsgType語音為voice
MediaId語音消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
Format語音格式，如amr，speex等
MsgID消息id，64位整型

使用網(wǎng)頁調(diào)試工具調(diào)試該接口


請注意，開通語音識別后，用戶每次發(fā)送語音給公眾號時，微信會在推送的語音消息XML數(shù)據(jù)包中，增加一個Recongnition字段（注：由于客戶端緩存，開發(fā)者開啟或者關(guān)閉語音識別功能，對新關(guān)注者立刻生效，對已關(guān)注用戶需要24小時生效。開發(fā)者可以重新關(guān)注此帳號進(jìn)行測試）。開啟語音識別后的語音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)隊]]></Recognition>
<MsgId>1234567890123456</MsgId>
</xml>

參數(shù)說明：

參數(shù)描述
ToUserName開發(fā)者微信號
FromUserName發(fā)送方帳號（一個OpenID）
CreateTime消息創(chuàng)建時間 （整型）
MsgType語音為voice
MediaID語音消息媒體id，可以調(diào)用多媒體文件下載接口拉取該媒體
Format語音格式：amr
Recognition語音識別結(jié)果，UTF8編碼
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>


參數(shù)描述
ToUserName開發(fā)者微信號
FromUserName發(fā)送方帳號（一個OpenID）
CreateTime消息創(chuàng)建時間 （整型）
MsgType視頻為video
MediaId視頻消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
ThumbMediaId視頻消息縮略圖的媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
MsgId消息id，64位整型

使用網(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>


參數(shù)描述
ToUserName開發(fā)者微信號
FromUserName發(fā)送方帳號（一個OpenID）
CreateTime消息創(chuàng)建時間 （整型）
MsgType小視頻為shortvideo
MediaId視頻消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
ThumbMediaId視頻消息縮略圖的媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
MsgId消息id，64位整型

使用網(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>


參數(shù)描述
ToUserName開發(fā)者微信號
FromUserName發(fā)送方帳號（一個OpenID）
CreateTime消息創(chuàng)建時間 （整型）
MsgTypelocation
Location_X地理位置維度
Location_Y地理位置經(jīng)度
Scale地圖縮放大小
Label地理位置信息
MsgId消息id，64位整型

使用網(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>


參數(shù)描述
ToUserName接收方微信號
FromUserName發(fā)送方微信號，若為普通用戶，則是一個OpenID
CreateTime消息創(chuàng)建時間
MsgType消息類型，link
Title消息標(biāo)題
Description消息描述
Url消息鏈接
MsgId消息id，64位整型

使用網(wǎng)頁調(diào)試工具調(diào)試該接口

網(wǎng)頁調(diào)試工具調(diào)試

以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號