小程序發送模板消息

最近幫朋友作一個項目,涉及到小程序模板消息的推送,和公衆號的推送大致上是同樣的,就是其中的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天,這樣就能夠達到僞無限次推送,打破微信接口的限制。
相關文章
相關標籤/搜索