閱讀(21.7k) 書簽贊(0) 我要糾錯(cuò)

微信平臺被動(dòng)回復(fù)用戶消息

2019-03-14 11:40 更新

被動(dòng)回復(fù)用戶消息

當(dāng)用戶發(fā)送消息給公眾號時(shí)（或某些特定的用戶操作引發(fā)的事件推送時(shí)），會(huì)產(chǎn)生一個(gè)POST請求，開發(fā)者可以在響應(yīng)包（Get）中返回特定XML結(jié)構(gòu)，來對該消息進(jìn)行響應(yīng)（現(xiàn)支持回復(fù)文本、圖片、圖文、語音、視頻、音樂）。嚴(yán)格來說，發(fā)送被動(dòng)響應(yīng)消息其實(shí)并不是一種接口，而是對微信服務(wù)器發(fā)過來消息的一次回復(fù)。

微信服務(wù)器在將用戶的消息發(fā)給公眾號的開發(fā)者服務(wù)器地址（開發(fā)者中心處配置）后，微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會(huì)斷掉連接，并且重新發(fā)起請求，總共重試三次，如果在調(diào)試中，發(fā)現(xiàn)用戶無法收到響應(yīng)的消息，可以檢查是否消息處理超時(shí)。關(guān)于重試的消息排重，有msgid的消息推薦使用msgid排重。事件類型消息推薦使用FromUserName + CreateTime 排重。

如果開發(fā)者希望增強(qiáng)安全性，可以在開發(fā)者中心處開啟消息加密，這樣，用戶發(fā)給公眾號的消息以及公眾號被動(dòng)回復(fù)用戶消息都會(huì)繼續(xù)加密（但），詳見被動(dòng)回復(fù)消息加解密說明。

假如服務(wù)器無法保證在五秒內(nèi)處理并回復(fù)，必須做出下述回復(fù)，這樣微信服務(wù)器才不會(huì)對此作任何處理，并且不會(huì)發(fā)起重試（這種情況下，可以使用客服消息接口進(jìn)行異步回復(fù)），否則，將出現(xiàn)嚴(yán)重的錯(cuò)誤提示。詳見下面說明：

1、直接回復(fù)success（推薦方式）

2、直接回復(fù)空串（指字節(jié)長度為0的空字符串，而不是XML結(jié)構(gòu)體中content字段的內(nèi)容為空）

一旦遇到以下情況，微信都會(huì)在公眾號會(huì)話中，向用戶下發(fā)系統(tǒng)提示“該公眾號暫時(shí)無法提供服務(wù)，請稍后再試”：

1、開發(fā)者在5秒內(nèi)未回復(fù)任何內(nèi)容

2、開發(fā)者回復(fù)了異常數(shù)據(jù)，比如JSON數(shù)據(jù)等

另外，請注意，回復(fù)圖片等多媒體消息時(shí)需要預(yù)先通過素材管理接口上傳臨時(shí)素材到微信服務(wù)器，可以使用素材管理中的臨時(shí)素材，也可以使用永久素材。

回復(fù)文本消息

<xml>

</xml>

參數(shù)	是否必須	描述
ToUserName	是	接收方帳號（收到的OpenID）
FromUserName	是	開發(fā)者微信號
CreateTime	是	消息創(chuàng)建時(shí)間（整型）
MsgType	是	text
Content	是	回復(fù)的消息內(nèi)容（換行：在content中能夠換行，微信客戶端就支持換行顯示）

回復(fù)圖片消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<Image>
<MediaId><![CDATA[media_id]]></MediaId>
</Image>
</xml>

參數(shù)	是否必須	說明
ToUserName	是	接收方帳號（收到的OpenID）
FromUserName	是	開發(fā)者微信號
CreateTime	是	消息創(chuàng)建時(shí)間（整型）
MsgType	是	image
MediaId	是	通過素材管理中的接口上傳多媒體文件，得到的id。

回復(fù)語音消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<Voice>
<MediaId><![CDATA[media_id]]></MediaId>
</Voice>
</xml>

參數(shù)	是否必須	說明
ToUserName	是	接收方帳號（收到的OpenID）
FromUserName	是	開發(fā)者微信號
CreateTime	是	消息創(chuàng)建時(shí)間戳（整型）
MsgType	是	語音，voice
MediaId	是	通過素材管理中的接口上傳多媒體文件，得到的id

回復(fù)視頻消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<Video>
<MediaId><![CDATA[media_id]]></MediaId>
<Title><![CDATA[title]]></Title>
<Description><![CDATA[description]]></Description>
</Video> 
</xml>

參數(shù)	是否必須	說明
ToUserName	是	接收方帳號（收到的OpenID）
FromUserName	是	開發(fā)者微信號
CreateTime	是	消息創(chuàng)建時(shí)間（整型）
MsgType	是	video
MediaId	是	通過素材管理中的接口上傳多媒體文件，得到的id
Title	否	視頻消息的標(biāo)題
Description	否	視頻消息的描述

回復(fù)音樂消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[music]]></MsgType>
<Music>
<Title><![CDATA[TITLE]]></Title>
<Description><![CDATA[DESCRIPTION]]></Description>
<MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
<HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
<ThumbMediaId><![CDATA[media_id]]></ThumbMediaId>
</Music>
</xml>

參數(shù)	是否必須	說明
ToUserName	是	接收方帳號（收到的OpenID）
FromUserName	是	開發(fā)者微信號
CreateTime	是	消息創(chuàng)建時(shí)間（整型）
MsgType	是	music
Title	否	音樂標(biāo)題
Description	否	音樂描述
MusicURL	否	音樂鏈接
HQMusicUrl	否	高質(zhì)量音樂鏈接，WIFI環(huán)境優(yōu)先使用該鏈接播放音樂
ThumbMediaId	是	縮略圖的媒體id，通過素材管理中的接口上傳多媒體文件，得到的id

回復(fù)圖文消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<ArticleCount>2</ArticleCount>
<Articles>
<item>
<Title><![CDATA[title1]]></Title> 
<Description><![CDATA[description1]]></Description>
<PicUrl><![CDATA[picurl]]></PicUrl>
<Url><![CDATA[url]]></Url>
</item>
<item>
<Title><![CDATA[title]]></Title>
<Description><![CDATA[description]]></Description>
<PicUrl><![CDATA[picurl]]></PicUrl>
<Url><![CDATA[url]]></Url>
</item>
</Articles>
</xml>

參數(shù)	是否必須	說明
ToUserName	是	接收方帳號（收到的OpenID）
FromUserName	是	開發(fā)者微信號
CreateTime	是	消息創(chuàng)建時(shí)間（整型）
MsgType	是	news
ArticleCount	是	圖文消息個(gè)數(shù)，限制為10條以內(nèi)
Articles	是	多條圖文消息信息，默認(rèn)第一個(gè)item為大圖,注意，如果圖文數(shù)超過10，則將會(huì)無響應(yīng)
Title	否	圖文消息標(biāo)題
Description	否	圖文消息描述
PicUrl	否	圖片鏈接，支持JPG、PNG格式，較好的效果為大圖360200，小圖200200
Url	否	點(diǎn)擊圖文消息跳轉(zhuǎn)鏈接

以上內(nèi)容是否對您有幫助：

← 微信平臺開發(fā) 接收事件推送

微信消息加解密說明 →

寫筆記

我要補(bǔ)充

微信平臺 被動(dòng)回復(fù)用戶消息