小程式模板訊息
最近在做微信小程式,為了讓使用者能更加方便的獲取到小程式內部的通知,便想著用模板訊息來解決此類問題。首先介紹一下兩種方法
第一種是傳統的按照微信開發文件來實現模板訊息的獲取,首先要明確的是你要有一個第三方的伺服器,因為微信現在規定在小程式內部不能直接請求微信的伺服器,而是要請求第三方伺服器,由第三方伺服器來請求微信的伺服器
1.傳統方式實現模板訊息
1.1獲取使用者openId
這一步可以在wx.login方法內獲取,用來標註模板訊息的接受者
1.2獲取模板ID
有兩個方法可以獲取模版ID
通過模版訊息管理介面獲取模版ID(
在微信公眾平臺手動配置獲取模版ID
登入https://mp.weixin.qq.com 獲取模板,如果沒有合適的模板,可以申請新增新模板,稽核通過後可使用
1.3獲取access_token
access_token 是全域性唯一介面呼叫憑據,開發者呼叫各介面時都需使用 access_token,請妥善儲存。access_token 的儲存至少要保留512個字元空間。access_token 的有效期目前為2個小時,需定時重新整理,重複獲取將導致上次獲取的 access_token 失效。
公眾平臺的 API 呼叫所需的 access_token 的使用及生成方式說明:
為了保密 appsecrect,第三方需要一個 access_token 獲取和重新整理的中控伺服器。而其他業務邏輯伺服器所使用的 access_token 均來自於該中控伺服器,不應該各自去重新整理,否則會造成 access_token 覆蓋而影響業務;
目前 access_token 的有效期通過返回的 expires_in 來傳達,目前是7200秒之內的值。中控伺服器需要根據這個有效時間提前去重新整理新 access_token。在重新整理過程中,中控伺服器對外輸出的依然是老 access_token,此時公眾平臺後臺會保證在重新整理短時間內,新老 access_token 都可用,這保證了第三方業務的平滑過渡;
access_token 的有效時間可能會在未來有調整,所以中控伺服器不僅需要內部定時主動重新整理,還需要提供被動重新整理 access_token 的介面,這樣便於業務伺服器在 API 呼叫獲知 access_token 已超時的情況下,可以觸發 access_token 的重新整理流程。
開發者可以使用 AppID 和 AppSecret 呼叫本介面來獲取 access_token。AppID 和 AppSecret 可登入微信公眾平臺官網-設定-開發設定中獲得(需要已經繫結成為開發者,且帳號沒有異常狀態)。AppSecret 生成後請自行儲存,因為在公眾平臺每次生成檢視都會導致 AppSecret 被重置。注意呼叫所有微信介面時均需使用 https 協議。如果第三方不使用中控伺服器,而是選擇各個業務邏輯點各自去重新整理 access_token,那麼就可能會產生衝突,導致服務不穩定。
以上內容是微信開發文件給出的access_token的說明,總的來說就是兩點,(1)access_token是傳送模板訊息的憑證,需要用微信小程式的AppID 和AppSecret 呼叫介面來獲取,有效時間為2小時,(2)如果在此獲取access_token則會導致前一個access_token失效,有多個公眾號和小程式的開發者一定要注意這一點!
介面地址:
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
HTTP請求方式:
GET
引數說明 :
引數 必填 說明
grant_type 是 獲取 access_token 填寫 client_credential
appid 是 第三方使用者唯一憑證
secret 是 第三方使用者唯一憑證金鑰,即appsecret
程式碼:
function onRequest(request, response, modules) {
var http = modules.oHttp;
//發起Get請求
http('https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=XXX&secret=XXX', function (error, res, body) {
response.send(body);
});
}
返回結果:
Response Body
{
"code": 200,
"msg":
{"access_token":"6_R8kOFxRLeRtWOq_haIU29XB0hbAoKxFGRqQTZt_HhzCSEvT_xDJ4WLgf9A_dt2pRTCugfUk7IkxR2sfu5zckCwKKWEghCtqlrrQlhdJmCxmkBAaDEdW7AU98D23rUJO5PYruNYOLQ3cpH3iAVTNiADAECW","expires_in":7200}
}
1.4傳送模板訊息
介面地址:(ACCESS_TOKEN 需換成上文獲取到的 access_token)
https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN
HTTP請求方式:
POST
POST引數說明:
引數 必填 說明
touser 是 接收者(使用者)的 openid
template_id 是 所需下發的模板訊息的id
page 否 點選模板卡片後的跳轉頁面,僅限本小程式內的頁面。支援帶引數,(示例index?foo=bar)。該欄位不填則模板無跳轉。
form_id 是 表單提交場景下,為 submit 事件帶上的 formId;支付場景下,為本次支付的 prepay_id
data 是 模板內容,不填則下發空模板
color 否 模板內容字型的顏色,不填預設黑色
emphasis_keyword 否 模板需要放大的關鍵詞,不填則預設無放大
formid說明:頁面的 <form/> 元件,屬性report-submit為true時,可以宣告為需發模板訊息,此時點選按鈕提交表單可以獲取formId
程式碼:
var temp = {
"touser": touser,//使用者的openid
"template_id": template_id,//模板id
"page": "",
"form_id": formid,//表單id
"data": {
"keyword1": {
"value": title,
"color": "#173177"
},
"keyword2": {
"value": gettime()
},
},
"emphasis_keyword": "keyword1.DATA" //將keyword1放大
}
1.5測試效果
2.基於Bmob後端雲的模板訊息實現
第一種方法實現起來過於繁瑣,在使用過程中也要中間伺服器的幫助,如果沒有中間伺服器,或者伺服器端的程式碼不太熟悉,那麼Bmob後端雲則可以幫助你實現你要的功能
只需要下載按照官網文件在小程式內初始化好Bmob,那麼就可以呼叫Bmob模板訊息的方法,如下所示
function send(title, formid, touser){
var Bmob = require('bmob.js');
var temp = {
"touser": touser,
"template_id": "ClYq9lc8bZh26uM993NNIknasAVBdk0wSYnDrkClK40",
"page": "",
"form_id": formid,
"data": {
"keyword1": {
"value": title,
"color": "#173177"
},
"keyword2": {
"value": gettime()
},
},
"emphasis_keyword": "keyword1.DATA"
}
Bmob.sendMessage(temp).then(function (obj) {
console.log('傳送成功');
},
function (err) {
common.showTip('失敗' + err)
});
}
這樣模板訊息就解決了,歡迎各位大佬批評指正,如果有不明白的可以加我微信 object_1995 一起交流