一、簡介

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

二、申請消息接口

點擊申請，如實填寫負責人姓名 、 手機號和郵箱，填寫網址url和token，其中token可由開發者可以任意填寫，用作生成簽名。

三、網址接入

公眾平臺用戶提交信息后，我們將以GET請求方式請求到填寫的Url上，并且帶上四個參數：
* signature — 微信加密簽名
* timestamp — 時間戳
* nonce — 隨機數
* echostr — 隨機字符串
開發者通過檢驗signature對網址接入合法性進行校驗。若此次GET請求原樣返回echostr參數內容，則接入生效，否則接入失敗。 驗證signature將結合開發者填寫的token參數、timestamp參數和nonce參數等，加密流程：
* 將token、timestamp、nonce三個參數進行字典序排序
* 將三個參數字符串拼接成一個字符串進行sha1加密
* 開發者獲得加密后的字符串可與signature對比，標識該請求來源于微信。

四、消息推送

當普通微信用戶向公眾賬號發消息時，公眾平臺將POST該消息到填寫的Url上（現支持文本消息以及地理位置消息）。結構如下：
文本消息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 消息發送方微信號
CreateTime 消息創建時間
MsgType 文本消息為text
Content 消息內容
地理位置消息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 消息發送方微信號
CreateTime 消息創建時間
MsgType 消息類型，地理位置為location
Location_X 地理位置緯度
Location_Y 地理位置經度
Scale 地圖縮放大小
Label 地理位置信息
圖片消息結構

 <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 消息發送方微信號
CreateTime 消息創建時間
MsgType 消息類型image
PicUrl 圖片鏈接，開發者可以用HTTP GET獲取

五、消息回復

對于每一個POST請求，開發者在響應包中返回特定xml結構，對該消息進行相應操作（現支持回復文本消息 、 回復圖文消息和星標操作）。xml結構如下：
回復文本消息格式

 <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 消息發送方
ToUserName 消息接收方
CreateTime 消息創建時間
MsgType 消息類型，文本消息必須填寫text
Content 消息內容，大小限制在2048字節，字段為空為不合法請求
回復圖文消息格式

<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 消息發送方
ToUserName 消息接收方
CreateTime 消息創建時間
MsgType 消息類型，圖文消息必須填寫news
Content 消息內容，圖文消息可填空
ArticleCount 圖文消息個數，限制為10條以內
Articles 多條圖文消息信息，默認第一個item為大圖
Title 圖文消息標題
Description 圖文消息描述
PicUrl 圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640*320，小圖80*80，限制圖片鏈接的域名需要與開發者填寫的基本資料中的Url一致
Url 點擊圖文消息跳轉鏈接

星標消息

在xml結構中，有一個FuncFlag字段，開發者可以通過填寫FuncFlag字段為1來對消息進行星標，你可以在實時消息的星標消息分類中找到該消息