小程序发送模板消息

时间：2022-08-24 08:05:29

最近帮朋友做一个项目，涉及到小程序模板消息的推送，和公众号的推送大体上是一样的，就是其中的formId比较特殊，记录一下。

1、需要在微信公众平台去申请一个模版消息，获取到模版消息

2、服务端后台需要调用接口发送模板消息，核心代码如下：

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' // 默认值
      }
    }

参数说明：

touser （必填） 接收者（用户）的 openid
template_id （必填） 所需下发的模板消息的id
page （可选） 点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转。
form_id （必填） 表单提交场景下，为 submit 事件带上的 formId；支付场景下，为本次支付的 prepay_id
data （必填） 模板内容，不填则下发空模板
access_token （必填） 授权调用接口的凭证（有效期2小时）

关于formId

小程序界面组件使用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天，这样就可以达到伪无限次推送，打破微信接口的限制。
标签：

相关文章