微信平臺(tái) 接收普通消息

2019-03-14 11:40 更新

接收普通消息

當(dāng)普通微信用戶向公眾賬號(hào)發(fā)消息時(shí)，微信服務(wù)器將POST消息的XML數(shù)據(jù)包到開(kāi)發(fā)者填寫的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ì)用戶消息在5秒內(nèi)立即做出回應(yīng)，即使用“發(fā)送消息-被動(dòng)回復(fù)消息”接口向用戶被動(dòng)回復(fù)消息時(shí)，可以在

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

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

各消息類型的推送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開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)（一個(gè)OpenID）
CreateTime消息創(chuàng)建時(shí)間 （整型）
MsgTypetext
Content文本消息內(nèi)容
MsgId消息id，64位整型

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


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

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


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

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


請(qǐng)注意，開(kāi)通語(yǔ)音識(shí)別后，用戶每次發(fā)送語(yǔ)音給公眾號(hào)時(shí)，微信會(huì)在推送的語(yǔ)音消息XML數(shù)據(jù)包中，增加一個(gè)Recongnition字段（注：由于客戶端緩存，開(kāi)發(fā)者開(kāi)啟或者關(guān)閉語(yǔ)音識(shí)別功能，對(duì)新關(guān)注者立刻生效，對(duì)已關(guān)注用戶需要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ō)明：

參數(shù)描述
ToUserName開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)（一個(gè)OpenID）
CreateTime消息創(chuàng)建時(shí)間 （整型）
MsgType語(yǔ)音為voice
MediaID語(yǔ)音消息媒體id，可以調(diào)用多媒體文件下載接口拉取該媒體
Format語(yǔ)音格式：amr
Recognition語(yǔ)音識(shí)別結(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開(kāi)發(fā)者微信號(hào)
FromUserName發(fā)送方帳號(hào)（一個(gè)OpenID）
CreateTime消息創(chuàng)建時(shí)間 （整型）
MsgType視頻為video
MediaId視頻消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
ThumbMediaId視頻消息縮略圖的媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
MsgId消息id，64位整型

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


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

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


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

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


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

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

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

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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)