如何在小程序中推送模板消息

如何在小程序中推送模板消息？針對這個問題，這篇文章詳細介紹了相對應的分析和解答，希望可以幫助更多想解決這個問題的小伙伴找到更簡單易行的方法。

前臺獲取 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 部分如下：

<!-- 要獲取formId，需要給form設置report-submit="true"的屬性，然后在form-type="submit"的按鈕上產生點擊動作，才會觸發表單提交的事件--formSubmit,進而獲取到formId -->
<form @submit="formSubmit" report-submit="true" class="bottom">
 <button  plain="true" form-type="submit" @click="back">
  <van-button round type="primary" size="small" @click="back">返回</van-button>
 </button>
 <button  plain="true" form-type="submit" @click="watchGame">
  <van-button round type="danger" size="small">{{watchText}}</van-button>
 </button>
 <button  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");
 //如果有formId就放到header里送過去
 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);
  //UserContextHolder用戶將當前線程和用戶綁定起來，方便后面獲取用戶信息
  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://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=上面獲取的accessToken
method: post

請求體格式為：application/json; charset=utf-8

body:{
 "touser": "用戶的openId",
 "template_id": "模板id",
 "page": "點擊跳轉的小程序url路徑",
 "form_id": "收集到的formId",
 "data": {
  "keyword1": {
   "value": "您有一個信息的提示消息"
  },
  "keyword2": {
   "value": "這是消息內容"
  }
 },
 "emphasis_keyword": "keyword1.DATA"
}

關于如何在小程序中推送模板消息問題的解答就分享到這里了，希望以上內容可以對大家有一定的幫助，如果你還有很多疑惑沒有解開，可以關注億速云行業資訊頻道了解更多相關知識。