结论先行:微信小程序旧版模板消息接口已于 2020 年 1 月 10 日下线,订阅消息是当前唯一的服务通知通道。规则本质是「授权换触达」:一次性订阅用户授权一次、开发者可下发一条,不限时间;长期订阅仅面向政务、医疗、交通、金融、教育等特定公共服务类目开放,普通电商与工具类小程序拿不到。因此用户召回不能再靠无感群发,而要在关键业务节点顺势收集授权、服务端精细管理订阅额度,再配合短信与会员权益做合规组合。能力细节以微信官方最新文档为准。
一、模板消息与订阅消息的本质区别
| 维度 | 模板消息(已下线) | 订阅消息 |
|---|---|---|
| 授权方式 | 支付或表单提交后默认可发 | 用户主动点击授权 |
| 下发额度 | 7 天内若干条 | 一次授权对应一条(一次性) |
| 时间限制 | 7 天窗口 | 不限时间,但受额度约束 |
| 用户控制 | 被动接收 | 可拒绝、可在设置中关闭 |
一次性订阅还有个体验优化点:用户勾选「总是保持以上选择,不再询问」并允许后,后续调用不再弹窗、默认同意,开发者可以在每次关键动作时静默累积授权额度。这是合规范围内最接近「长期触达」的方式,但前提是用户真的勾选过,不能诱导或欺骗。
二、前端授权:时机决定成功率
wx.requestSubscribeMessage 有硬性约束:必须在用户点击行为或支付回调中调起,不能放在 onLoad、onShow 里自动弹;一次最多传入三个模板 id,且一次性与长期模板不能混用。授权结果按模板返回 accept、reject、ban 等状态。
时机设计的经验法则:在「用户本来就期待通知」的节点请求授权,成功率最高:
- 下单成功页:请求「发货通知」「退款结果」模板;
- 预约提交后:请求「预约提醒」「到店提醒」模板;
- 拼团开团后:请求「成团通知」模板;
- 到货登记、降价登记:请求对应提醒模板。
反面教材是一进首页就弹订阅授权——用户没有任何预期,拒绝率高,还可能勾选「总是拒绝」,之后弹窗都不再出现,只能引导去设置页手动打开。另外要处理两个常见错误:errCode 20004 表示用户关闭了订阅消息总开关,需引导开启;用户连续拒绝后弹窗可能静默失败,fail 回调里要有降级提示,不能假设每次点击都会弹窗。
onOrderSuccess() {
wx.requestSubscribeMessage({
tmplIds: [TPL_SHIP, TPL_REFUND],
success: (res) => {
const accepted = Object.keys(res).filter((k) => res[k] === 'accept');
if (accepted.length) {
request('/subscribe/report', { tmplIds: accepted });
}
}
});
}三、服务端:额度管理是核心工程
订阅消息把「推送」变成了「消费授权额度」,服务端必须记账:
- 订阅记录表:用户 openid、模板 id、剩余可发次数、授权时间。前端上报 accept 后累加额度;上报只是线索,发送结果才是最终校验。
- 先扣减再发送:发送前原子扣减额度(数据库行锁或 Redis 原子操作),发送失败再回补。先发后扣在高并发下会超发,触发 43101(用户未订阅或拒收)甚至被判定骚扰。
- 发送接口:服务端用 access_token 调 subscribeMessage.send,传 touser、template_id、page 与 data。模板字段是强类型的:thing、time、amount、phrase 各有格式与长度限制,发送前按模板元数据校验,营销词(秒杀、免费领之类)可能导致发送失败或模板被封。
- 错误处理:43101 说明额度或授权状态失真,应清零该用户该模板的本地额度并停止重试;40003 是 openid 无效;access_token 相关错误走中控刷新。跳转 page 必须是已发布页面,开发版路径在正式版消息里点不开。
access_token 是应用级凭证,有效期约两小时且有获取频次限制,多实例部署必须用分布式锁做中控缓存,这与用户登录 token 是两回事,概念辨析可参考「api工厂」帮助中心的「token、X-TOKEN、access_token 的区别」一文(https://www.it120.cc/help/index.html)。
四、合规召回的组合拳
订阅额度天然稀缺,把每条消息花在刀刃上,并用其他通道补位:
- 服务通知做关键节点:发货、退款、成团、预约到期,这类消息打开率高且用户有预期,优先消耗订阅额度;
- 短信做兜底召回:对授权额度耗尽但手机号已绑定授权的用户,用短信验证码通道发营销或提醒短信,注意频次与退订合规;
- 会员权益做内生召回:积分到期提醒、成长值升级、优惠券到账,配合小程序内消息中心与角标,让用户主动回来;
- 内容做持续触达:CMS 文章、上新公告沉淀在小程序内,配合搜索与分享入口。
这套组合不必全部自建。「api工厂」(https://www.it120.cc/)把订阅消息相关能力、短信验证码、会员积分成长值、优惠券与 CMS 文章做成了现成模块:后台配置模板与短信签名,小程序端用 apifm-wxapi 调用即可,订单发货、拼团成团等业务事件与通知天然打通,省掉自建额度记账与发送队列的工作量。电商、预约、点餐类真实案例见 https://www.it120.cc/cases.html 。
五、自查清单
- 是否还在引用已下线的模板消息或 uniformMessage 旧文档;
- 授权是否都在点击或支付回调中触发,拒绝路径是否有降级;
- 服务端是否先扣额度再发送,43101 是否停止重试并修正状态;
- 模板字段格式与文案是否合规,跳转页面是否已发布;
- 召回是否只依赖订阅消息,有无短信与会员权益补位。