以下內容來自於微信公衆平臺開發文檔
當用戶發送消息給公衆號時(或某些特定的用戶操作引發的事件推送時),會產生一個POST請求,開發者可以在響應包(Get)中返回特定XML結構,來對該消息進行響應(現支持回覆文本、圖片、圖文、語音、視頻、音樂)。嚴格來說,發送被動響應消息其實並不是一種接口,而是對微信服務器發過來消息的一次回覆。
各消息類型需要的XML數據包結構如下:
回覆文本消息
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>12345678</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[你好]]></Content> </xml> |
參數 |
是否必須 |
描述 |
ToUserName |
是 |
接收方帳號(收到的OpenID) |
FromUserName |
是 |
開發者微信號 |
CreateTime |
是 |
消息創建時間 (整型) |
MsgType |
是 |
text |
Content |
是 |
回覆的消息內容(換行:在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> |
參數 |
是否必須 |
說明 |
ToUserName |
是 |
接收方帳號(收到的OpenID) |
FromUserName |
是 |
開發者微信號 |
CreateTime |
是 |
消息創建時間 (整型) |
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> |
參數 |
是否必須 |
說明 |
ToUserName |
是 |
接收方帳號(收到的OpenID) |
FromUserName |
是 |
開發者微信號 |
CreateTime |
是 |
消息創建時間戳 (整型) |
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> |
參數 |
是否必須 |
說明 |
ToUserName |
是 |
接收方帳號(收到的OpenID) |
FromUserName |
是 |
開發者微信號 |
CreateTime |
是 |
消息創建時間 (整型) |
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> |
參數 |
是否必須 |
說明 |
ToUserName |
是 |
接收方帳號(收到的OpenID) |
FromUserName |
是 |
開發者微信號 |
CreateTime |
是 |
消息創建時間 (整型) |
MsgType |
是 |
music |
Title |
否 |
音樂標題 |
Description |
否 |
音樂描述 |
MusicURL |
否 |
音樂鏈接 |
HQMusicUrl |
否 |
高質量音樂鏈接,WIFI環境優先使用該鏈接播放音樂 |
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> |
參數 |
是否必須 |
說明 |
ToUserName |
是 |
接收方帳號(收到的OpenID) |
FromUserName |
是 |
開發者微信號 |
CreateTime |
是 |
消息創建時間 (整型) |
MsgType |
是 |
news |
ArticleCount |
是 |
圖文消息個數,限制爲10條以內 |
Articles |
是 |
多條圖文消息信息,默認第一個item爲大圖,注意,如果圖文數超過10,則將會無響應 |
Title |
否 |
圖文消息標題 |
Description |
否 |
圖文消息描述 |
PicUrl |
否 |
圖片鏈接,支持JPG、PNG格式,較好的效果爲大圖360*200,小圖200*200 |
Url |
否 |
點擊圖文消息跳轉鏈接 |