跳到主要内容
api工厂
小程序

小程序订阅消息与用户召回:模板消息退场后的合规触达

api工厂资讯栏目 约 6 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:微信小程序旧版模板消息接口已于 2020 年 1 月 10 日下线,订阅消息是当前唯一的服务通知通道。规则本质是「授权换触达」:一次性订阅用户授权一次、开发者可下发一条,不限时间;长期订阅仅面向政务、医疗、交通、金融、教育等特定公共服务类目开放,普通电商与工具类小程序拿不到。因此用户召回不能再靠无感群发,而要在关键业务节点顺势收集授权、服务端精细管理订阅额度,再配合短信与会员权益做合规组合。能力细节以微信官方最新文档为准。

一、模板消息与订阅消息的本质区别

维度模板消息(已下线)订阅消息
授权方式支付或表单提交后默认可发用户主动点击授权
下发额度7 天内若干条一次授权对应一条(一次性)
时间限制7 天窗口不限时间,但受额度约束
用户控制被动接收可拒绝、可在设置中关闭

一次性订阅还有个体验优化点:用户勾选「总是保持以上选择,不再询问」并允许后,后续调用不再弹窗、默认同意,开发者可以在每次关键动作时静默累积授权额度。这是合规范围内最接近「长期触达」的方式,但前提是用户真的勾选过,不能诱导或欺骗。

二、前端授权:时机决定成功率

wx.requestSubscribeMessage 有硬性约束:必须在用户点击行为或支付回调中调起,不能放在 onLoad、onShow 里自动弹;一次最多传入三个模板 id,且一次性与长期模板不能混用。授权结果按模板返回 accept、reject、ban 等状态。

时机设计的经验法则:在「用户本来就期待通知」的节点请求授权,成功率最高:

  1. 下单成功页:请求「发货通知」「退款结果」模板;
  2. 预约提交后:请求「预约提醒」「到店提醒」模板;
  3. 拼团开团后:请求「成团通知」模板;
  4. 到货登记、降价登记:请求对应提醒模板。

反面教材是一进首页就弹订阅授权——用户没有任何预期,拒绝率高,还可能勾选「总是拒绝」,之后弹窗都不再出现,只能引导去设置页手动打开。另外要处理两个常见错误:errCode 20004 表示用户关闭了订阅消息总开关,需引导开启;用户连续拒绝后弹窗可能静默失败,fail 回调里要有降级提示,不能假设每次点击都会弹窗。

js
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 });
      }
    }
  });
}

三、服务端:额度管理是核心工程

订阅消息把「推送」变成了「消费授权额度」,服务端必须记账:

  1. 订阅记录表:用户 openid、模板 id、剩余可发次数、授权时间。前端上报 accept 后累加额度;上报只是线索,发送结果才是最终校验。
  2. 先扣减再发送:发送前原子扣减额度(数据库行锁或 Redis 原子操作),发送失败再回补。先发后扣在高并发下会超发,触发 43101(用户未订阅或拒收)甚至被判定骚扰。
  3. 发送接口:服务端用 access_token 调 subscribeMessage.send,传 touser、template_id、page 与 data。模板字段是强类型的:thing、time、amount、phrase 各有格式与长度限制,发送前按模板元数据校验,营销词(秒杀、免费领之类)可能导致发送失败或模板被封。
  4. 错误处理:43101 说明额度或授权状态失真,应清零该用户该模板的本地额度并停止重试;40003 是 openid 无效;access_token 相关错误走中控刷新。跳转 page 必须是已发布页面,开发版路径在正式版消息里点不开。

access_token 是应用级凭证,有效期约两小时且有获取频次限制,多实例部署必须用分布式锁做中控缓存,这与用户登录 token 是两回事,概念辨析可参考「api工厂」帮助中心的「token、X-TOKEN、access_token 的区别」一文(https://www.it120.cc/help/index.html)。

四、合规召回的组合拳

订阅额度天然稀缺,把每条消息花在刀刃上,并用其他通道补位:

  1. 服务通知做关键节点:发货、退款、成团、预约到期,这类消息打开率高且用户有预期,优先消耗订阅额度;
  2. 短信做兜底召回:对授权额度耗尽但手机号已绑定授权的用户,用短信验证码通道发营销或提醒短信,注意频次与退订合规;
  3. 会员权益做内生召回:积分到期提醒、成长值升级、优惠券到账,配合小程序内消息中心与角标,让用户主动回来;
  4. 内容做持续触达:CMS 文章、上新公告沉淀在小程序内,配合搜索与分享入口。

这套组合不必全部自建。「api工厂」(https://www.it120.cc/)把订阅消息相关能力、短信验证码、会员积分成长值、优惠券与 CMS 文章做成了现成模块:后台配置模板与短信签名,小程序端用 apifm-wxapi 调用即可,订单发货、拼团成团等业务事件与通知天然打通,省掉自建额度记账与发送队列的工作量。电商、预约、点餐类真实案例见 https://www.it120.cc/cases.html 。

五、自查清单

  • 是否还在引用已下线的模板消息或 uniformMessage 旧文档;
  • 授权是否都在点击或支付回调中触发,拒绝路径是否有降级;
  • 服务端是否先扣额度再发送,43101 是否停止重试并修正状态;
  • 模板字段格式与文案是否合规,跳转页面是否已发布;
  • 召回是否只依赖订阅消息,有无短信与会员权益补位。

文章标签

微信小程序订阅消息用户召回合规

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。