1. 程式人生 > >小程式模板訊息

小程式模板訊息

最近在做微信小程式,為了讓使用者能更加方便的獲取到小程式內部的通知,便想著用模板訊息來解決此類問題。首先介紹一下兩種方法

第一種是傳統的按照微信開發文件來實現模板訊息的獲取,首先要明確的是你要有一個第三方的伺服器,因為微信現在規定在小程式內部不能直接請求微信的伺服器,而是要請求第三方伺服器,由第三方伺服器來請求微信的伺服器
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 一起交流