被動回復(fù)用戶消息
被動回復(fù)用戶消息
當(dāng)用戶發(fā)送消息給公眾號時（或某些特定的用戶操作引發(fā)的事件推送時），會產(chǎn)生一個POST請求，開發(fā)者可以在響應(yīng)包（Get）中返回特定XML結(jié)構(gòu)，來對該消息進(jìn)行響應(yīng)（現(xiàn)支持回復(fù)文本、圖片、圖文、語音、視頻、音樂）。嚴(yán)格來說，發(fā)送被動響應(yīng)消息其實并不是一種接口，而是對微信服務(wù)器發(fā)過來消息的一次回復(fù)。
微信服務(wù)器在將用戶的消息發(fā)給公眾號的開發(fā)者服務(wù)器地址（開發(fā)者中心處配置）后，微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會斷掉連接，并且重新發(fā)起請求，總共重試三次，如果在調(diào)試中，發(fā)現(xiàn)用戶無法收到響應(yīng)的消息，可以檢查是否消息處理超時。關(guān)于重試的消息排重，有msgid的消息推薦使用msgid排重。事件類型消息推薦使用FromUserName + CreateTime 排重。
如果開發(fā)者希望增強安全性，可以在開發(fā)者中心處開啟消息加密，這樣，用戶發(fā)給公眾號的消息以及公眾號被動回復(fù)用戶消息都會繼續(xù)加密（但），詳見被動回復(fù)消息加解密說明。
假如服務(wù)器無法保證在五秒內(nèi)處理并回復(fù)，必須做出下述回復(fù)，這樣微信服務(wù)器才不會對此作任何處理，并且不會發(fā)起重試（這種情況下，可以使用客服消息接口進(jìn)行異步回復(fù)），否則，將出現(xiàn)嚴(yán)重的錯誤提示。詳見下面說明：
1、直接回復(fù)success（推薦方式） 2、直接回復(fù)空串（指字節(jié)長度為0的空字符串，而不是XML結(jié)構(gòu)體中content字段的內(nèi)容為空） |
一旦遇到以下情況，微信都會在公眾號會話中，向用戶下發(fā)系統(tǒng)提示“該公眾號暫時無法提供服務(wù)，請稍后再試”：
| 1、開發(fā)者在5秒內(nèi)未回復(fù)任何內(nèi)容 2、開發(fā)者回復(fù)了異常數(shù)據(jù)，比如JSON數(shù)據(jù)等 |
另外，請注意，回復(fù)圖片等多媒體消息時需要預(yù)先通過素材管理接口上傳臨時素材到微信服務(wù)器，可以使用素材管理中的臨時素材，也可以使用永久素材。
回復(fù)文本消息
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>12345678</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[你好]]></Content> </xml> |
| 參數(shù) | 是否必須 | 描述 |
|---|---|---|
| ToUserName | 是 | 接收方帳號（收到的OpenID） |
| FromUserName | 是 | 開發(fā)者微信號 |
| CreateTime | 是 | 消息創(chuàng)建時間 （整型） |
| 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)建時間 （整型） |
| 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)建時間戳 （整型） |
| 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)建時間 （整型） |
| 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)建時間 （整型） |
| 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)建時間 （整型） |
| MsgType | 是 | news |
| ArticleCount | 是 | 圖文消息個數(shù)，限制為10條以內(nèi) |
| Articles | 是 | 多條圖文消息信息，默認(rèn)第一個item為大圖,注意，如果圖文數(shù)超過10，則將會無響應(yīng) |
| Title | 否 | 圖文消息標(biāo)題 |
| Description | 否 | 圖文消息描述 |
| PicUrl | 否 | 圖片鏈接，支持JPG、PNG格式，較好的效果為大圖360*200，小圖200*200 |
| Url | 否 | 點擊圖文消息跳轉(zhuǎn)鏈接 |
