最近幫朋友作一個項目,涉及到小程序模板消息的推送,和公衆號的推送大致上是同樣的,就是其中的formId比較特殊,記錄一下。javascript
一、須要在微信公衆平臺去申請一個模版消息,獲取到模版消息前端
二、服務端後臺須要調用接口發送模板消息,核心代碼以下:java
let opts = { touser: param.openId, template_id: param.template_id, form_id: param.formId, page : param.page , data: { "keyword1": { "value": param.user, "color": "#1d1d1d" }, "keyword2": { "value": param.result, "color": "#1d1d1d" }, "keyword3": { "value": param.time, "color": "#1d1d1d" } } } let data = { method: 'POST', url: `https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=${param.accessToken}`, body: JSON.stringify(opts), header: { 'content-type': 'application/json' // 默認值 } }
參數說明:json
touser (必填) 接收者(用戶)的 openid
template_id (必填) 所需下發的模板消息的id
page (可選) 點擊模板卡片後的跳轉頁面,僅限本小程序內的頁面。支持帶參數,(示例index?foo=bar)。該字段不填則模板無跳轉。
form_id (必填) 表單提交場景下,爲 submit 事件帶上的 formId;支付場景下,爲本次支付的 prepay_id
data (必填) 模板內容,不填則下發空模板
access_token (必填) 受權調用接口的憑證(有效期2小時)小程序
關於formIdapi
小程序界面組件使用form時,添加report-submit='true'屬性,在bindsubmit回調裏會出現form_id,因此你須要將form_id上傳到後臺發送模板消息的地方來使用,
注意一個用戶對應的form_id只能爲該用戶推送模板消息,不能爲其餘用戶使用,也就是說form_id是和openid綁定使用的,而且
有效期是7天。
再次注意,在實際使用中,模擬器的formId: "the formId is a mock one",只有真機下才會獲得正確的formId。
因爲模板消息必須獲得用戶的formId才能夠爲用戶推送消息,因此限制了爲用戶推送的次數。因此咱們能夠預先收集用戶提交表單的formId,在須要推送表單的地方使用。前端提交用戶formId和openid數據,後臺保存到服務器中,注意formId的有效期是7天,這樣就能夠達到僞無限次推送,打破微信接口的限制。