微信公眾號推送模板消息
阿新 • • 發佈：2018-08-20
sage 字體顏色 信息 program 數據包 alt 2014年 rms 情況
一、到公眾號平臺（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
}
使用效果
微信公眾號推送模板消息