一、簡介

公眾平臺消息接口為開發(fā)者提供了一種新的消息處理方式。

二、申請消息接口

點(diǎn)擊申請，如實(shí)填寫負(fù)責(zé)人姓名 、 手機(jī)號和郵箱，填寫網(wǎng)址url和token，其中token可由開發(fā)者可以任意填寫，用作生成簽名。

三、網(wǎng)址接入

公眾平臺用戶提交信息后，我們將以GET請求方式請求到填寫的Url上，并且?guī)纤膫€參數(shù)：
* signature — 微信加密簽名
* timestamp — 時間戳
* nonce — 隨機(jī)數(shù)
* echostr — 隨機(jī)字符串
開發(fā)者通過檢驗(yàn)signature對網(wǎng)址接入合法性進(jìn)行校驗(yàn)。若此次GET請求原樣返回echostr參數(shù)內(nèi)容，則接入生效，否則接入失敗。 驗(yàn)證signature將結(jié)合開發(fā)者填寫的token參數(shù)、timestamp參數(shù)和nonce參數(shù)等，加密流程：
* 將token、timestamp、nonce三個參數(shù)進(jìn)行字典序排序
* 將三個參數(shù)字符串拼接成一個字符串進(jìn)行sha1加密
* 開發(fā)者獲得加密后的字符串可與signature對比，標(biāo)識該請求來源于微信。

四、消息推送

當(dāng)普通微信用戶向公眾賬號發(fā)消息時，公眾平臺將POST該消息到填寫的Url上（現(xiàn)支持文本消息以及地理位置消息）。結(jié)構(gòu)如下：
文本消息xml格式

 <xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1348831860</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[this is a test]]></Content></xml> 

ToUserName 消息接收方微信號，一般為公眾平臺賬號微信號
FromUserName 消息發(fā)送方微信號
CreateTime 消息創(chuàng)建時間
MsgType 文本消息為text
Content 消息內(nèi)容
地理位置消息xml格式

 <xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1351776360</CreateTime><MsgType><![CDATA[location]]></MsgType><Location_X>23.134521</Location_X><Location_Y>113.358803</Location_Y><Scale>20</Scale><Label><![CDATA[位置信息]]></Label></xml> 

ToUserName 消息接收方微信號，一般為公眾平臺賬號微信號
FromUserName 消息發(fā)送方微信號
CreateTime 消息創(chuàng)建時間
MsgType 消息類型，地理位置為location
Location_X 地理位置緯度
Location_Y 地理位置經(jīng)度
Scale 地圖縮放大小
Label 地理位置信息
圖片消息結(jié)構(gòu)

 <xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1348831860</CreateTime><MsgType><![CDATA[image]]></MsgType><PicUrl><![CDATA[this is a url]></PicUrl></xml> 

ToUserName 消息接收方微信號，一般為公眾平臺賬號微信號
FromUserName 消息發(fā)送方微信號
CreateTime 消息創(chuàng)建時間
MsgType 消息類型image
PicUrl 圖片鏈接，開發(fā)者可以用HTTP GET獲取

五、消息回復(fù)

對于每一個POST請求，開發(fā)者在響應(yīng)包中返回特定xml結(jié)構(gòu)，對該消息進(jìn)行相應(yīng)操作（現(xiàn)支持回復(fù)文本消息 、 回復(fù)圖文消息和星標(biāo)操作）。xml結(jié)構(gòu)如下：
回復(fù)文本消息格式

 <xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>12345678</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[content]]></Content><FuncFlag>0</FuncFlag></xml> 

FromUserName 消息發(fā)送方
ToUserName 消息接收方
CreateTime 消息創(chuàng)建時間
MsgType 消息類型，文本消息必須填寫text
Content 消息內(nèi)容，大小限制在2048字節(jié)，字段為空為不合法請求
回復(fù)圖文消息格式

<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>12345678</CreateTime><MsgType><![CDATA[news]]></MsgType><Content><![CDATA[]]></Content><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><FuncFlag>1</FuncFlag></xml> 

FromUserName 消息發(fā)送方
ToUserName 消息接收方
CreateTime 消息創(chuàng)建時間
MsgType 消息類型，圖文消息必須填寫news
Content 消息內(nèi)容，圖文消息可填空
ArticleCount 圖文消息個數(shù)，限制為10條以內(nèi)
Articles 多條圖文消息信息，默認(rèn)第一個item為大圖
Title 圖文消息標(biāo)題
Description 圖文消息描述
PicUrl 圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640*320，小圖80*80，限制圖片鏈接的域名需要與開發(fā)者填寫的基本資料中的Url一致
Url 點(diǎn)擊圖文消息跳轉(zhuǎn)鏈接

星標(biāo)消息

在xml結(jié)構(gòu)中，有一個FuncFlag字段，開發(fā)者可以通過填寫FuncFlag字段為1來對消息進(jìn)行星標(biāo)，你可以在實(shí)時消息的星標(biāo)消息分類中找到該消息