微信公眾號推送模板消息

一、到公眾號平台（https://mp.weixin.qq.com）開通模板功能並申請你需要的對應模板

二、獲取access_token

　　地址：https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}

　　注意：公眾號和小程序均可以使用AppID和AppSecret調用本接口來獲取access_token。AppID和AppSecret可在“微信公眾平台-開發-基本配置”頁中獲得（需要已經成為開發者，且帳號沒有異常狀態）。調用接口時，請登錄“微信公眾平台-開發-基本配置”提前將服務器IP地址添加到IP白名單中，點擊查看設置方法，否則將無法調用成功。小程序無需配置IP白名單。

參數說明

參數	是否必須	說明
grant_type	是	獲取access_token填寫client_credential
appid	是	第三方用戶唯一憑證
secret	是	第三方用戶唯一憑證密鑰，即appsecret

返回說明

正常情況下，微信會返回下述JSON數據包給公眾號：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

參數說明

參數	說明
access_token	獲取到的憑證
expires_in	憑證有效時間，單位：秒

錯誤時微信會返回錯誤碼等信息，JSON數據包示例如下（該示例為AppID無效錯誤）:

{"errcode":40013,"errmsg":"invalid appid"}

返回碼說明

返回碼	說明
-1	系統繁忙，此時請開發者稍候再試
0	請求成功
40001	AppSecret錯誤或者AppSecret不屬於這個公眾號，請開發者確認AppSecret的正確性
40002	請確保grant_type字段值為client_credential
40164	調用接口的IP地址不在白名單中，請在接口IP白名單中進行設置。（小程序及小游戲調用不要求IP地址在白名單內。）

 

三、調用發送模板接口

　　地址：　　　　

　　　　http請求方式: POST
　　　　https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

　

POST數據說明

POST數據示例如下：

      {
           "touser":"OPENID",
           "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
           "url":"http://weixin.qq.com/download",  
           "miniprogram":{
             "appid":"xiaochengxuappid12345",
             "pagepath":"index?foo=bar"
           },          
           "data":{
                   "first": {
                       "value":"恭喜你購買成功！",
                       "color":"#173177"
                   },
                   "keyword1":{
                       "value":"巧克力",
                       "color":"#173177"
                   },
                   "keyword2": {
                       "value":"39.8元",
                       "color":"#173177"
                   },
                   "keyword3": {
                       "value":"2014年9月22日",
                       "color":"#173177"
                   },
                   "remark":{
                       "value":"歡迎再次購買！",
                       "color":"#173177"
                   }
           }
       }

參數說明

參數	是否必填	說明
touser	是	接收者openid
template_id	是	模板ID
url	否	模板跳轉鏈接
miniprogram	否	跳小程序所需數據，不需跳小程序可不用傳該數據
appid	是	所需跳轉到的小程序appid（該小程序appid必須與發模板消息的公眾號是綁定關聯關系，暫不支持小游戲）
pagepath	否	所需跳轉到小程序的具體頁面路徑，支持帶參數,（示例index?foo=bar），暫不支持小游戲
data	是	模板數據
color	否	模板內容字體顏色，不填默認為黑色

注：url和miniprogram都是非必填字段，若都不傳則模板無跳轉；若都傳，會優先跳轉至小程序。開發者可根據實際需要選擇其中一種跳轉方式即可。當用戶的微信客戶端版本不支持跳小程序時，將會跳轉至url。

返回碼說明

在調用模板消息接口后，會返回JSON數據包。正常時的返回JSON數據包示例：

    {
           "errcode":0,
           "errmsg":"ok",
           "msgid":200228332
       }

使用效果