当前位置：首页 > news >正文

【微信小程序 + 消息订阅 + 授权】微信小程序实现消息订阅流程介绍，代码示例（仅前端）

news 2025/10/23 10:27:54

前言

微信小程序消息订阅包括一次性订阅和长期订阅（非永久订阅）。
让我们来一起看看怎么使用吧～

文档直通车：开放能力 /消息 /订阅消息 /小程序订阅消息（用户通过弹窗订阅）开发指南

一、一次性订阅流程

1.配置订阅消息模板

登录微信公众平台，进入「功能」→「订阅消息」，从公共模板库中选择所需模板或申请自定义模板，获取模板 ID。
如果没有合适的模板，可以申请添加新模板，审核通过后可使用。
在这里插入图片描述

2.前端发起订阅请求

在小程序前端，通过调用wx.requestSubscribeMessage接口，向用户展示订阅弹窗。示例代码如下：

wx.requestSubscribeMessage({tmplIds: ['TEMPLATE_ID'], // 模板ID列表success(res) {if (res['TEMPLATE_ID'] === 'accept') {console.log('用户已授权');// 将授权结果发送至服务器保存wx.request({url: 'https://api.example.com/save-subscription',data: { openid: getApp().globalData.openid }});}},fail(err) {console.error('授权失败', err);}
});

文档直通车：

一次性订阅消息、长期订阅消息，详见接口开放接口 /订阅消息 /wx.requestSubscribeMessage
设备订阅消息，详见接口开放接口 /订阅消息 /wx.requestSubscribeDeviceMessage

3.服务端存储订阅关系

服务器接收到前端发送的授权结果后，校验用户身份，并存储openid、模板 ID 和授权状态等信息。

4.触发消息发送

当满足业务条件时，服务器调用微信的消息发送接口，传入openid、模板 ID、页面路径和消息数据等，发送订阅消息。

5.消息状态监控

服务器配置消息推送回调地址，接收微信推送的消息发送结果，更新数据库中的消息发送状态。

二、长期订阅流程

1.类目确认

确保小程序后台已正确选择支持长期订阅的类目，如政务民生、医疗、交通、金融、教育等部分二级行业类目。符合准入条件的，系统会自动在订阅消息功能模块内显示长期订阅入口。

2.模板选择

访问「类目模板库」，搜索与业务场景相关的长期订阅模板，如 “行为激励”“积分通知” 等。

3.消息发送

使用服务端 API 调用subscribeMessage.send接口发送消息，消息内容需与所选模板字段完全匹配。

三、开通条件

1.一次性订阅

无需特殊条件，只要小程序具备合法的业务场景和内容，均可使用一次性订阅消息功能。

2.长期订阅

小程序必须属于政务民生、医疗、交通、金融、教育等部分二级行业类目，且长期订阅目前只支持少量民生公共服务节点通知。

3.一次性订阅中多个模板和单个模板

单个模板：在基础库 2.4.4 - 2.8.3 版本中，仅支持传入一个一次性模板 ID，用户订阅后，开发者可不限时间地下发一条对应的服务消息。
多个模板：基础库 2.8.2 版本开始，用户发生点击行为或者发起支付回调后，才可以调起订阅消息界面，且一次调用wx.requestSubscribeMessage接口最多可传入 3 个模板 ID。iOS 客户端 7.0.6 版本、Android 客户端 7.0.7 版本之后的一次性订阅支持多个模板消息，每个模板消息可单独订阅或退订。

在这里插入图片描述

四、注意一些报错和弹框显示的逻辑

1.“总是保持以上选择，不再询问”

在这里插入图片描述

选中该状态，再点击“取消” or “允许”：弹框不会再弹出
未选中该状态，点击“取消” or “允许”：每一次到触发条件时，都会出来一次，订阅一次用一次。

2.判断用户是否授权，弹出引导弹框

在这里插入图片描述

在这里插入图片描述
整体逻辑上面也说过，其实就是通过 wx.getSetting 接口，来获取当前订阅的状态；通过总开关subscriptionsSetting.mainSwitch和模版的状态（为 acceptorreject等）来判断用户是否订阅。

const subscribeMessage = async(type) => {const {subscriptionsSetting} = await wx.getSetting({withSubscriptions: true})let temp_one = (subscriptionsSetting[SUB_TEMPLATE_ID.temp_one] && subscriptionsSetting[SUB_TEMPLATE_ID.temp_one] !== 'accept') ? true : falselet temp_two = (subscriptionsSetting[SUB_TEMPLATE_ID.temp_two] && subscriptionsSetting[SUB_TEMPLATE_ID.temp_two] !== 'accept') ? true : falseif (!subscriptionsSetting.mainSwitch || temp_one || temp_two) {console.log('拒绝过，或未授权')// popup.is_setting = trueTaro.showModal({title: '提示',content: '您之前拒绝过消息订阅，是否前往设置开启？',confirmText: '去设置',cancelText: '取消',success: async function (res) {if (res.confirm) {console.log('用户点击确定')Taro.openSetting({withSubscriptions: true,success: async (res) => {sendSome(type)let msg = {[SUB_TEMPLATE_ID.temp_one]: '',[SUB_TEMPLATE_ID.temp_two]: '',}// 上报给后端，订阅状态的接口你的逻辑}})}}})return}console.log('已授权', subscriptionsSetting,'向微信上报')Taro.requestSubscribeMessage({tmplIds:  [SUB_TEMPLATE_ID.temp_one, SUB_TEMPLATE_ID.temp_two],success: async(res) => {// 你的一些其它业务逻辑let msg = {[SUB_TEMPLATE_ID.temp_one]: res[SUB_TEMPLATE_ID.temp_one],[SUB_TEMPLATE_ID.temp_two]: res[SUB_TEMPLATE_ID.temp_two],}// 上报给后端，订阅状态的接口你的逻辑}})
}