前言
微信小程序消息订阅包括一次性订阅和长期订阅（非永久订阅）。
让我们来一起看看怎么使用吧～
文章目录
- 前言
-
- 一、一次性订阅流程
- 二、长期订阅流程
- 三、开通条件
- 四、注意一些报错和弹框显示的逻辑
- 1."总是保持以上选择，不再询问"
-
-
- 2.判断用户是否授权，弹出引导弹框
- [3. 开发者调试时，点击过"总是。。。"之后，怎么才能再次触发弹框出现呢？](#3. 开发者调试时，点击过“总是。。。”之后，怎么才能再次触发弹框出现呢？)
-
一、一次性订阅流程
1.配置订阅消息模板
登录微信公众平台，进入「功能」→「订阅消息」，从公共模板库中选择所需模板或申请自定义模板，获取模板 ID。
如果没有合适的模板，可以申请添加新模板，审核通过后可使用。
2.前端发起订阅请求
在小程序前端，通过调用wx.requestSubscribeMessage接口，向用户展示订阅弹窗。示例代码如下：
typescript
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等）来判断用户是否订阅。
typescript
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 : false
let temp_two = (subscriptionsSetting[SUB_TEMPLATE_ID.temp_two] && subscriptionsSetting[SUB_TEMPLATE_ID.temp_two] !== 'accept') ? true : false
if (!subscriptionsSetting.mainSwitch || temp_one || temp_two) {
console.log('拒绝过，或未授权')
// popup.is_setting = true
Taro.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],
}
// 上报给后端，订阅状态的接口
你的逻辑
}
})
}文档直通车：开放接口 /设置 /wx.getSetting
3. 开发者调试时，点击过"总是。。。"之后，怎么才能再次触发弹框出现呢？
-
在开发者工具里登录你的账号
-
"清除授权数据" 或者 "全部清除"
