微信公衆號開發:微信六大接口(2)

以下內容來自於微信公衆平臺開發文檔

當用戶發送消息給公衆號時(或某些特定的用戶操作引發的事件推送時),會產生一個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

點擊圖文消息跳轉鏈接

 


發佈了33 篇原創文章 · 獲贊 10 · 訪問量 8萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章