模板消息

基于小程序平台的通知渠道,平台为开发者提供了可以高效触达用户的模板消息能力,以便实现服务的闭环并提供更佳的体验。

请移步这里了解微信模板消息

上报模板消息卡片点击事件

wx.BaaS.reportTemplateMsgAnalytics(options)

参数说明

参数类型必填说明
optionsObject与 onShow 中的参数 options 相同

上报模板消息卡片点击事件,只需要在 app.jsonShow 中做一个埋点,其他的事情由 SDK 自动完成。

示例代码

  1. // app.js
  2. ...
  3. onShow: function(options) {
  4. wx.BaaS.reportTemplateMsgAnalytics(options)
  5. },
  6. ...

上报模板消息所需 formId

方式一:获取到 formId 后,调用接口上报

wx.BaaS.wxReportTicket(formID)

参数说明

参数类型必填说明
formIDString-

当使用小程序的 <form/> 组件,且属性 report-submit 设为 true 时,此时表单是声明为需要要发模板消息的,当点击按钮提交表单即可获取 formID。

方式二:使用自定义组件自动上报(推荐)

组件中添加了节流逻辑进行频次限制,限制的规则为: 1s 内最多触发 1 次,24h 内最多触发 20 次 。也就是说,用户在 1 秒内无论点击组件多少次,formId 只会上报一次,一天之内最多只会上报 20 个 formId。

如有需要多次上报 formId,请使用方式一。

插件版 SDK 提供了自定义组件 ticket-report-wrapper(插件版 2.0.6 以上),文件版与 npm 版 SDK,可以通过 npm 获取该组件(包名为 minapp-ticket-wx)。

引入组件

  1. // index.json
  2. {
  3. "usingComponents": {
  4. "ticket-report-wrapper": "plugin://sdkPlugin/ticket-report-wrapper"
  5. }
  6. }
  • 安装 minapp-ticket-wx,在项目根目录下运行以下命令(二选一)
  1. // 通过 yarn 安装
  2. yarn add minapp-ticket-wx
  3. // 通过 npm 安装
  4. npm install --save minapp-ticket-wx
  • 使用微信开发者工具构建 npm

构建 npm

  • 在将要使用该组件的页面 json 文件中引用组件
  1. {
  2. "usingComponents": {
  3. "ticket-report-wrapper": "../../miniprogram_npm/minapp-ticket-wx/index"
  4. }
  5. }
  • 安装 minapp-ticket-wx,在项目根目录下运行以下命令(二选一)
  1. // 通过 yarn 安装
  2. yarn add minapp-ticket-wx
  3. // 通过 npm 安装
  4. npm install --save minapp-ticket-wx
  • 使用微信开发者工具构建 npm

构建 npm

  • 在将要使用该组件的页面 json 文件中引用组件
  1. {
  2. "usingComponents": {
  3. "ticket-report-wrapper": "../../miniprogram_npm/minapp-ticket-wx/index"
  4. }
  5. }

使用组件

  1. <ticket-report-wrapper>
  2. ...
  3. </ticket-report-wrapper>

参数说明

微信小程序可以像普通组件一样在自定义组件上监听事件、设置属性,所以此处没有做限制,详情请参考微信小程序自定义组件文档

  1. <ticket-report-wrapper bind:tap="handleTap">
  2. ...
  3. </ticket-report-wrapper>

发送模板消息

你可以通过以下方式向用户发送模板消息:

  • 在线发送

知晓云控制台 - 知晓推送中在线填写模板消息内容、选择发送用户后直接向其推送模板消息。适用于临时通知或不定期的活动通知等场景。

  • 触发器发送

通过触发器,在指定触发条件下向用户推送模板消息。适用于抽奖、收付款通知等规律性的推送场景。具体使用请参照 Trigger 使用说明

  • 云函数发送

通过云函数发送模板消息,适用业务逻辑复杂的场景,建议配合触发器一起使用。

具体使用方式请移步这里