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

微信平臺被動回復用戶消息

2019-03-14 11:40 更新

被動回復用戶消息

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

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

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

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

1、直接回復success（推薦方式）

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

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

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

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

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

回復文本消息

<xml>

</xml>

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

回復圖片消息

<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)建時間（整型）
MsgType	是	image
MediaId	是	通過素材管理中的接口上傳多媒體文件，得到的id。

回復語音消息

<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)建時間戳（整型）
MsgType	是	語音，voice
MediaId	是	通過素材管理中的接口上傳多媒體文件，得到的id

回復視頻消息

<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)建時間（整型）
MsgType	是	video
MediaId	是	通過素材管理中的接口上傳多媒體文件，得到的id
Title	否	視頻消息的標題
Description	否	視頻消息的描述

回復音樂消息

<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)建時間（整型）
MsgType	是	music
Title	否	音樂標題
Description	否	音樂描述
MusicURL	否	音樂鏈接
HQMusicUrl	否	高質(zhì)量音樂鏈接，WIFI環(huán)境優(yōu)先使用該鏈接播放音樂
ThumbMediaId	是	縮略圖的媒體id，通過素材管理中的接口上傳多媒體文件，得到的id

回復圖文消息

<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)建時間（整型）
MsgType	是	news
ArticleCount	是	圖文消息個數(shù)，限制為10條以內(nèi)
Articles	是	多條圖文消息信息，默認第一個item為大圖,注意，如果圖文數(shù)超過10，則將會無響應
Title	否	圖文消息標題
Description	否	圖文消息描述
PicUrl	否	圖片鏈接，支持JPG、PNG格式，較好的效果為大圖360200，小圖200200
Url	否	點擊圖文消息跳轉(zhuǎn)鏈接

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

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

微信消息加解密說明 →

寫筆記

我要補充

微信平臺 被動回復用戶消息