订阅消息实战教程

接入订阅消息

开发者可以在知晓推送页面进入订阅消息接入向导：

前三步与接入微信类似，详情可查看微信小程序接入，在「接入 SDK」处需要填入 AppScret，AppSecret 用于开通模板消息服务，在小程序后台“设置 - 开发设置”中查看。

根据引导进行上报订阅消息。

通过校验后即完成接入。

获取模板 ID

在模板库中搜索合适的模板，点击选用，选择需要的关键词后提交即可完成模板创建。

在「我的模板」可以查看、添加和删除模板，在这里获取模板 ID。

获取下发权限

微信小程序提供了 wx.requestSubscribeMessage 接口来发起申请订阅权限界面。

上报订阅状态的接口

知晓云提供了 wx.BaaS.subscribeMessage(options) SDK 来进行收集订阅状态。

参数说明

参数

类型

必填

说明

subscription

Subscription[]

是

参数列表

Subscription

参数

类型

必填

说明

template_id

String

是

模板 ID

subscription_type

String

是

订阅类型，once（一次性订阅），permanent（永久订阅）

用户发生点击行为或者发起支付回调后，调起订阅消息界面，通过 SDK 上报订阅状态。

示例代码

在函数内我们会调用微信 API wx.requestSubscribeMessage 申请发送订阅权限，弹窗出来后，我们会收到 success 回调，当用户在弹窗同意订阅后，即上报订阅结果为 accept ，将订阅的 template_id （模板 ID）和 subscription_type（订阅类型）存入 subscription 数组中，最后在调用 SDK 进行上报即可。

wx.requestSubscribeMessage({
  tmplIds: [this.data.id],
  success: (res) => {
    let subscription = []
    if (res[this.data.id] === 'accept') {
      subscription.push({
        template_id: this.data.id,
        subscription_type: 'once',
      })
    }
    wx.BaaS.subscribeMessage({subscription}).then(res => {
      // success
    }, err => {
      // fail
    })
  },
})