前段時間剁手了 PS4,在瀏覽商店時,發現官方商店真的不好用,主要是網絡原因,次要是頁面設計。所以就想自己做一個游戲查詢的小程序,可以關注某個游戲,然后在這個游戲打折的時候發送通知給用戶。最后發現有個很大的問題是:小程序沒法直接給用戶推送消息(當時還不知道模板消息),服務號才能。然后就用郵箱實現了通知功能,但是郵箱的局限實在是太大了(各大免費郵箱每天的發件數都很小,自己搭建的郵件服務器雖然沒有發件限制,但是大概率會被放到垃圾箱)。
然后某天在微信小程序的管理后臺發現了模板消息這個東西,查了會資料發現可以通過這個來實現消息推送。要給用戶發送模板消息需要 formId/prepay_id
這樣一個東西,這個東西是怎么來的呢?
report-submit="true"
,這樣每次對這個表單的提交一次就會產生一個 formId.下面具體來講講前后臺的實現,前臺使用 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 部分如下:
<!-- 要獲取formId,需要給form設置report-submit="true"的屬性,然后在form-type="submit"的按鈕上產生點擊動作,才會觸發表單提交的事件--formSubmit,進而獲取到formId --><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"); //如果有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"}
data 中的數據的按照順序 keyword1,keyword2
對應于模板中字段的順序。
結束
工程全部源碼在這里:github
總結
以上所述是小編給大家介紹的在小程序中推送模板消息的實現方法,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復大家的。在此也非常感謝大家對VEVB武林網網站的支持!
如果你覺得本文對你有幫助,歡迎轉載,煩請注明出處,謝謝!
新聞熱點
疑難解答