微信小程序开发中的用户订阅和消息推送

时间:2024-10-03 21:40:00

微信小程序的用户订阅和消息推送功能可以帮助开发者快速实现向用户发送订阅消息的能力。在小程序中,用户可以通过订阅消息,订阅特定的事件,如商品降价、订单状态更新等,并在后台通过接口发送消息给用户。

本文将详细介绍微信小程序开发中的用户订阅和消息推送功能,并提供相应的代码案例。

一、开通订阅消息功能

1. 在小程序后台设置

在开始开发订阅消息功能之前,需要先在小程序后台进行相关设置。

步骤 1:进入小程序后台开发管理页面

进入小程序管理后台(/),点击左侧菜单栏的【开发】,再点击右侧的【订阅消息】。

步骤 2:开通订阅消息功能

点击【开通订阅消息】,并根据指引完成申请。完成后即可开通订阅消息功能。

2. 在小程序代码中设置

在小程序代码中,需要先引入方法,并在需要的地方调用该方法获取用户订阅事件。

  1. // 引入微信接口
  2. const wx = require('')
  3. // 获取订阅消息权限
  4. wx.requestSubscribeMessage({
  5. tmplIds: ['templateId1', 'templateId2'],
  6. success (res) {
  7. // 用户同意订阅
  8. if (res['templateId1'] === 'accept' && res['templateId2'] === 'accept') {
  9. console.log('用户订阅成功')
  10. }
  11. },
  12. fail (error) {
  13. console.log('获取订阅消息权限失败', error)
  14. }
  15. })

在上述代码中,通过方法获取用户订阅消息的权限,tmplIds参数为需要订阅的模板消息的模板 ID 列表,开发者可以根据实际情况进行修改。

成功获取用户订阅消息权限后,可以在success回调函数中进行相关操作,例如发送订阅消息。

二、发送订阅消息

在开通订阅消息功能并获取用户订阅权限后,开发者可以通过接口发送订阅消息给用户。

1. 订阅消息模板设置

在小程序后台开发管理页面中的【订阅消息】中,可以设置订阅消息模板。

步骤 1:选择可订阅的模板

点击【添加订阅消息模板】,进入选择页面。

步骤 2:选择模板

在选择页面,可以根据需求选择可订阅的模板,例如商品降价、订单状态更新等。

步骤 3:设置模板关键词

在选择模板后,可以设置模板消息中的关键词,例如商品名称、原价、降价前价格等。

2. 发送订阅消息

在小程序代码中,可以使用方法发送订阅消息。

  1. // 引入微信云函数接口
  2. const wx = require('')
  3. // 发送订阅消息
  4. wx.cloud.callFunction({
  5. name: 'subscribeMessage',
  6. data: {
  7. touser: 'openId',
  8. templateId: 'templateId',
  9. page: 'page',
  10. data: {
  11. keyword1: {
  12. value: '商品降价提醒'
  13. },
  14. keyword2: {
  15. value: 'Apple iPhone 12'
  16. },
  17. keyword3: {
  18. value: '9999.00'
  19. }
  20. },
  21. miniprogramState: 'developer'
  22. },
  23. success (res) {
  24. console.log('发送订阅消息成功', res)
  25. },
  26. fail (error) {
  27. console.log('发送订阅消息失败', error)
  28. }
  29. })

在上述代码中,通过方法发送订阅消息,name参数为云函数名称,data参数为发送订阅消息的相关配置,开发者可以根据实际情况进行修改。

三、接收并处理订阅消息

当用户订阅消息后,可以通过接口接收并处理订阅消息。

1. 在小程序代码中设置

在小程序代码中,可以使用方法接收订阅消息。

  1. // 引入微信云函数接口
  2. const wx = require('')
  3. // 接收订阅消息
  4. wx.cloud.callFunction({
  5. name: 'subscribeMessage',
  6. data: {
  7. touser: 'openId',
  8. templateId: 'templateId',
  9. page: 'page',
  10. data: {
  11. keyword1: {
  12. value: '商品降价提醒'
  13. },
  14. keyword2: {
  15. value: 'Apple iPhone 12'
  16. },
  17. keyword3: {
  18. value: '9999.00'
  19. }
  20. },
  21. miniprogramState: 'developer'
  22. },
  23. success (res) {
  24. console.log('接收订阅消息成功', res)
  25. // 处理订阅消息
  26. // ...
  27. },
  28. fail (error) {
  29. console.log('接收订阅消息失败', error)
  30. }
  31. })

在上述代码中,通过方法接收订阅消息,并在success回调函数中进行相关操作,例如处理订阅消息。

2. 在云函数中处理订阅消息

在云函数中,可以使用方法处理订阅消息。

  1. // 引入微信小程序云开发接口
  2. const cloud = require('wx-server-sdk')
  3. // 初始化云开发
  4. cloud.init()
  5. // 云函数入口函数
  6. exports.main = async (event, context) => {
  7. try {
  8. const result = await cloud.openapi.subscribeMessage.send({
  9. touser: event.touser,
  10. templateId: event.templateId,
  11. page: event.page,
  12. data: event.data,
  13. miniprogramState: event.miniprogramState
  14. })
  15. console.log('发送订阅消息成功', result)
  16. return result
  17. } catch (error) {
  18. console.log('发送订阅消息失败', error)
  19. return error
  20. }
  21. }

在上述代码中,通过方法发送订阅消息,touser参数为用户的 OpenID,templateId参数为订阅消息模板的模板 ID,page参数为订阅消息跳转的页面,data参数为模板消息中的关键词数据,miniprogramState参数为订阅消息的显示状态。

四、总结

通过本文的介绍和代码案例,可以了解微信小程序开发中的用户订阅和消息推送功能并实现相应的功能。

在开发过程中,需要先开通订阅消息功能,并在小程序代码中设置相应的订阅消息权限获取和订阅消息发送逻辑。同时,还需要在小程序后台设置可订阅的消息模板。

注意,开发者在使用订阅消息时需要遵守相关规定,如发送频率限制等。

希望本文能够帮助开发者理解和使用微信小程序开发中的用户订阅和消息推送功能,并能在实际开发中灵活运用。