小程序发送模板消息

时间: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天,这样就可以达到伪无限次推送,打破微信接口的限制。