你知道如何在小程序中推送模板消息?

前段時間剁手了 PS4,在瀏覽商店時，發現官方商店真的不好用，主要是網絡原因，次要是頁面設計。所以就想自己做一個遊戲查詢的小程序，可以關注某個遊戲，然後在這個遊戲打折的時候發送通知給用戶。最後發現有個很大的問題是：小程序沒法直接給用戶推送消息（當時還不知道模板消息），服務號才能。然後就用郵箱實現了通知功能，但是郵箱的局限實在是太大了（各大免費郵箱每天的發件數都很小，自己搭建的郵件伺服器雖然沒有發件限制，但是大概率會被放到垃圾箱）。

然後某天在微信小程序的管理後臺發現了模板消息這個東西，查了會資料發現可以通過這個來實現消息推送。要給用戶發送模板消息需要formId/prepay_id這樣一個東西，這個東西是怎麼來的呢？

下面具體來講講前後臺的實現，前臺使用 mpvue，後臺使用 java

前臺獲取 formId

既然可以通過 form 的 submit 操作來獲取到 formId,那我們稍微拓展一下，將我們的小程序頁面中所有用戶能點擊的部分都用 form,button 來包裹一下，這樣用戶感知不到有表單提交操作，我們也能獲取大量的 formId。

注意不能用疊加的方式來一次點擊獲取多個 formId,這樣方法已經不行了，獲取到的都會是一樣的。

獲取一個模板

要發送模板消息，首先要在小程序的管理後臺上添加模板，步驟如下：

1.在模板庫中選擇一個模板

2.選擇顯示參數

選擇要顯示在消息中的參數，這裡選擇如下兩個參數：

這樣就有了一個模板可以用來發消息了，在我的模板中可以看到模板 id，和欄位 id

獲取 formId

formId 是通過表單提交來獲取到了，為了獲取足夠多的 formId,可以將能夠點擊的組件（比如按鈕，列表單元..）包裹在 form 中，這樣用戶在日常使用中就能夠收集到足夠多的 formId。下面以包裹一個有贊的按鈕為例。因為小程序的限制，設置form-type屬性的按鈕必須為 form 組件的直接子節點，所以並不能夠在 form 中使用自定義組件，並將form-type='submit'設置到自定義組件中。

template 部分如下：

<form @submit="formSubmit" report-submit="true" class="bottom"><button style="border:0;display:inline-block" plain="true" form-type="submit" @click="back"><van-button round type="primary" size="small" @click="back">返回</van-button></button><button style="border:0;display:inline-block" plain="true" form-type="submit" @click="watchGame"><van-button round type="danger" size="small">{{watchText}}</van-button></button><button style="border:0;display:inline-block" plain="true" form-type="submit" open-type="share"><van-button round type="info" size="small">分享</van-button></button></form>

style 目的為了去除原生 button 的背景，邊框啥的，把 button 當一個 div 來使用，然後在 button 中設置 form-type 和 click 屬性,這樣既不影響 formId 的屬性，也對原有邏輯不產生任何影響。之所以將 click 放在 button 上是因為 button 內部的組件沒法獲取到點擊事件。

formSubmit 代碼如下：

formSubmit(e) {let item = {value: e.mp.detail.formId,expireTime: Date.now() + 7 * 24 * 60 * 60 * 1000};this.globalData.formIdList.push(item);},

該函數是在表單提交時觸發，用於獲取 formId,將 formId 和這個 formId 的過期時間一起存到 globalData 全局數據中。然後找一個時機將這些 formId 發送給伺服器保存起來就行了。

這裡放上我的做法以供參考。

我是在每次發送 http 請求前檢查是不是有 formId 需要發送到伺服器，如果有就將這些數據 JSON 序列化後放到一個自定義 header 中，發送出去，具體代碼如下(http 請求工具為：flyio)：

var Fly = require("flyio/dist/npm/wx");var fly = new Fly();fly.interceptors.request.use(request => {request.headers["jwt-token"] = wxUtil.getGlobalData("jwt-token");let formIdList = getApp().globalData.formIdList;if (formIdList.length > 0) {request.headers["formIdList"] = JSON.stringify(formIdList);getApp().globalData.formIdList = [];}if (request.method == "GET") {request.params["_t"] = new Date().getTime();}return request;});

下面將後臺的實現，基於 Spring Boot.

後臺處理搜集 formId

首先需要把 formId 收集起來存到資料庫，那麼就需要檢查每個請求，看 header 中有沒有攜帶 formId,如果有就存到資料庫中，注意要和用戶對應起來，某個用戶點擊產生的 formId 只能用於給這個用戶推送消息。

因為要將 formId 和用戶綁定起來，因此我是在身份認證過濾器中進行的 formId 處理，身份認證成功後，處理 formId。代碼如下：

/** * Description: 從請求頭中獲取formIdList,並插入資料庫 * * @param request 請求頭 * @return void * @author fanxb * @date 2019/5/6 16:39 */private void checkFormId(HttpServletRequest request) {String str = request.getHeader(Constant.HEADER_FORM_ID);if (StringUtil.isEmpty(str)) {return;}List<FormKey> formKeyList = JSON.parseArray(str, FormKey.class);int userId = UserContextHolder.get().getUser().getUserId();formKeyList.forEach(item -> item.setUserId(userId));this.formKeyDao.insertMany(formKeyList);}

發送微信提醒

通過官方文檔可以知道發送消息的流程如下：

1 獲取 accessToken,調用微信的大多數接口都需要這個東西，這個通過 appId 和 secret 來獲取。詳情參見：https://developers.weixin.qq.com/miniprogram/dev/api-backend/auth.getAccessToken.html

2 調用微信發送服務通知的接口.這個接口文檔在:點擊跳轉

最終發送的 http 請求是這樣的：

url: https:method: post請求體格式為：application/json; charset=utf-8body:{"touser": "用戶的openId","template_id": "模板id","page": "點擊跳轉的小程序url路徑","form_id": "收集到的formId","data": {"keyword1": {"value": "您有一個信息的提示消息"},"keyword2": {"value": "這是消息內容"}},"emphasis_keyword": "keyword1.DATA"}

data 中的數據的按照順序 keyword1,keyword2 對應於模板中欄位的順序。

結束

點擊閱讀原文獲取項目源碼。

PS
這就是那個小程序，歡迎批評指正。

本文原創發布於：https://www.tapme.top/blog/detail/20190507