微信小程序消息模板配置教程

2025-05-07

以下是微信小程序消息模板(现为「订阅消息」)的配置教程,分为模板申请、前端授权、后端发送三个主要步骤:


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

  • 模板消息(旧版):需用户触发表单或支付后7天内发送,已逐渐被订阅消息取代

  • 订阅消息(新版):需用户主动订阅授权,无7天限制,更灵活,推荐使用。


二、配置订阅消息模板

  1. 登录小程序后台

    • 进入微信公众平台 → 选择小程序 → 左侧菜单「功能」→「订阅消息」。

  2. 申请消息模板

    • 点击「选用」或「新建模板」,搜索关键词(如“订单通知”)。

    • 选择模板后,配置模板字段(如{{thing1.DATA}}),提交后获取模板ID(如 ABC123xyz)。


三、前端授权订阅

用户需主动点击按钮触发授权弹窗:

html
复制
下载
运行
<buttonbindtap="subscribeMessage">订阅消息</button>
javascript
复制
下载
Page({subscribeMessage(){ wx.requestSubscribeMessage({tmplIds:['你的模板ID'],// 如 ['ABC123xyz']success(res){ console.log('授权成功', res);},fail(err){ console.log('授权失败', err);}});}});

注意:用户可能拒绝授权,需设计友好提示。


四、后端发送订阅消息

以 Node.js 为例,使用 wx-server-sdk:

javascript
复制
下载
const cloud =require('wx-server-sdk'); cloud.init(); exports.main=async(event, context)=>{try{const result =await cloud.openapi.subscribeMessage.send({touser: event.openid,// 用户openidtemplateId:'你的模板ID',page:'pages/index/index',// 点击消息跳转的页面data:{thing1:{value:'订单已发货'},// 对应模板字段time2:{value:'2023-10-01 10:00'}}});return result;}catch(err){return err;}};

五、常见问题

  1. 用户收不到消息?

    • 检查模板ID是否正确。

    • 确认用户已授权(res['模板ID'] === 'accept')。

    • 后端接口是否返回成功(错误码参考微信文档)。

  2. 模板审核不通过?

    • 避免营销类词汇(如“优惠”“点击领取”)。

    • 字段内容需符合模板定义的类型(如thing1为20字以内短文本)。

  3. 发送频率限制

    • 同一用户同一模板7天内最多发送1条(长期订阅需特殊行业资质)。


六、注意事项

  • 测试环境:开发阶段可使用体验版小程序测试。

  • 安全规范:禁止发送营销、骚扰类内容,否则可能被封禁。

  • 模板管理:失效模板需及时更换。


通过以上步骤即可完成订阅消息的配置与发送。如需更详细参数,请查阅微信官方文档


其它案例