一文读懂小程序云开发如何玩转订阅消息

2023-10-07 09:15:24

云开发是微信官方推出的基于云端能力的一项新功能，开发者只需要关注自身应用的逻辑，无须搭建服务器。只需在微信小程序的配置文件中配置一下即可使用云开发能力。自2017年12月小程序云开发上线，微信不断的更新云开发的特性，功能日益强大。在云开发刚诞生之时，由于能力的缺乏，订阅消息是需要借助第三方平台才能使用的。随着云开发的日益强大，微信官方也将其纳入到了云开发中。

订阅消息的创建

订阅消息的创建包括两个步骤：

在微信公众平台上创建订阅消息模板。
在小程序云开发中创建订阅消息对象。

在微信公众平台上创建订阅消息模板

首先，需要登录微信公众平台，进入“模板消息”页面，点击“新建模板”按钮。

在“新建模板”页面中，需要选择一个模板类型。小程序云开发支持一次性订阅消息和长期订阅消息两种模板类型。

一次性订阅消息 ：这种模板消息只能发送一次，适合用于需要用户立即采取行动的情况，例如下单提醒、发货提醒等。
长期订阅消息 ：这种模板消息可以发送多次，适合用于需要用户长期关注的情况，例如新闻资讯、活动通知等。

选择好模板类型后，需要填写模板内容。模板内容包括标题、正文、图片和按钮。

标题：标题是订阅消息中最醒目的部分，需要用简洁的语言概括出消息的内容。
正文：正文是订阅消息的主体部分，需要详细消息的内容。
图片：图片可以帮助订阅消息更生动形象，但需要注意图片的大小不能超过2MB。
按钮：按钮可以引导用户采取行动，例如点击按钮可以打开小程序、跳转到网页等。

填写好模板内容后，点击“保存”按钮，即可创建订阅消息模板。

在小程序云开发中创建订阅消息对象

在微信公众平台上创建好订阅消息模板后，还需要在小程序云开发中创建订阅消息对象。

const db = wx.cloud.database()
const collection = db.collection('subscriptions')

// 创建订阅消息对象
const data = {
  openid: 'oBZF70XX-___0v2kiP-sIDM5Tz8s',
  templateId: 'fh8FG419g__dRTnSSr4PvHnUw7kKNthFy11GJVF7yCQ',
  data: {
    keyword1: 'value',
    keyword2: 'value'
  }
}

collection.add({
  data
}).then(res => {
  console.log('订阅消息对象创建成功')
})

订阅消息的发送

在小程序云开发中发送订阅消息，可以使用以下代码：

wx.cloud.callFunction({
  name: 'sendSubscriptionMessage',
  data: {
    openid: 'oBZF70XX-___0v2kiP-sIDM5Tz8s',
    templateId: 'fh8FG419g__dRTnSSr4PvHnUw7kKNthFy11GJVF7yCQ',
    data: {
      keyword1: 'value',
      keyword2: 'value'
    }
  }
}).then(res => {
  console.log('订阅消息发送成功')
})

订阅消息的取消订阅

如果用户不想再接收订阅消息，可以在小程序中取消订阅。

wx.cloud.callFunction({
  name: 'unsubscribe',
  data: {
    openid: 'oBZF70XX-___0v2kiP-sIDM5Tz8s',
    templateId: 'fh8FG419g__dRTnSSr4PvHnUw7kKNthFy11GJVF7yCQ'
  }
}).then(res => {
  console.log('订阅消息取消订阅成功')
})