Skip to content

业务模板配置 ​

消息模板 解决的是「有什么模板」,这一页解决的是「什么时候发哪一个」。系统把会触发微信通知的业务动作预置成一批业务事件——会员充值到账、积分兑换成功、预订要取货了、审批轮到你了、拼团成功了——每条事件绑一个模板,再告诉系统模板里的每个字段取哪个业务参数,消息才发得出去。

页面结构很简单:一张事件清单,每行一个业务场景,操作列只有两种状态——还没绑 的显示 绑定微信模板,已经绑了 的显示 配置微信模板。前者是选模板,后者是调参数。所以这页的工作顺序永远是:先在消息模板页把模板准备好,回这里绑上,再点开配参数。

功能路径:系统 → 微信应用 → 业务模板配置

一、功能概述 ​

1. 核心用途 ​

  1. 建事件清单:点一次 初始化业务事件,把系统预置的十几个场景写进当前账套;
  2. 事件绑模板:给每个场景指定用哪个微信模板发;
  3. 参数映射:告诉系统模板里每个占位符填什么业务数据;
  4. 按场景开关:不想发某一类通知,直接禁用那条事件。

2. 整体结构 ​

顶部 当前应用 下拉 + 应用类型标签(与消息模板页一致,切换后整张清单换一套);其下 初始化业务事件 按钮;再下是筛选行与事件列表。

业务模板配置列表:当前应用下拉、初始化业务事件按钮、业务场景名称标识已绑定微信模板是否启用创建时间与绑定微信模板配置微信模板操作列

二、界面布局说明 ​

列含义
业务场景名称事件名,如 会员充值通知、拼团成功提醒、流程待办提醒
业务场景标识该事件在系统里的编号,多数是数字(18);也有部分事件用英文标识(如 order_paid),随应用与版本不同
已绑定微信模板绑定的模板标题;未绑定时显示灰色的 未绑定
是否启用行内开关。关掉后这个场景不再发微信,业务本身不受影响
创建时间该事件记录写入本账套的时间(初始化那一刻)
操作未绑定 → 绑定微信模板;已绑定 → 配置微信模板;两者都带 禁用/启用

筛选行除搜索框和 是否启用 外,还有一个按 创建时间 的下拉(任意日期 / 今天 / 过去 7 天 / 本月 / 今年),用于核对某次初始化补了哪些事件。

三、业务操作步骤 ​

步骤 1:选定当前应用 ​

顶部 当前应用: 下拉选应用,与 消息模板 页的规则完全一致:事件与绑定按应用各存一套。给 A 小程序配好的绑定,切到 B 小程序后是另一张空清单。

步骤 2:初始化业务事件 ​

第一次进这个页面(或换了新应用),列表可能是空的。点 初始化业务事件,确认框原文:

确认初始化 16 个业务事件到当前租户数据库? 已存在的记录不会重复创建。

完成后提示 初始化完成:新增 N 条,已存在 M 条。幂等——重复点不会把已配好的绑定冲掉,只补漏。所以接手一个配了一半的账套,放心点一次初始化补齐清单。

当前版本预置的 16 个事件:

业务场景触发时机
会员购物通知会员在小程序/门店完成消费下单
会员充值通知储值卡充值到账
会员支付通知会员侧支付成功
会员退货通知退货退款处理完成
积分兑换通知积分兑换商品成功
会员预订通知预订单提交成功
预订取消通知预订被取消
预订取货通知预订到取货时间,提醒客户来取
会员生日提醒会员生日当天
卡券核销券在门店被使用
卡券到账通知券发放到会员账户
礼品领取成功通知礼品领取完成
拼团支付提醒参团后待支付
拼团成功提醒成团,进入生产/配送
办理进程通知订单办理进度发生变化
流程待办提醒审批流转到该处理人

步骤 3:绑定微信模板 ​

点某行的 绑定微信模板,弹窗顶部显示这条事件(如 办理进程通知,旁边灰字 (场景ID: 18)),下面是 选择微信模板: 下拉,默认项 -- 请选择已添加的微信模板 --。

下拉里只列当前应用下已启用的模板(来自 消息模板)。如果下拉是空的,说明模板还没同步进来或全被禁用了,先去那一页。选好后点 保存绑定,提示 已绑定微信模板到「办理进程通知」;没选就点会报 请选择微信模板。

绑定微信模板弹窗:业务事件名与场景ID、选择微信模板下拉与请选择已添加的微信模板、取消与保存绑定按钮

步骤 4:配置参数映射 ​

绑定之后操作列变成 配置微信模板,点开弹窗标题是 配置微信模板:

  • 顶部 当前绑定模板: 拼团成功通知(绿色模板名)+ 更换模板 按钮——想换模板走这里,不用回列表重新绑;
  • 下面是 参数映射 表,三列:
列含义
原始字段模板占位符的字段名,如 character_string1、amount3、time5(蓝色等宽显示)
字段说明微信给的中文说明,如 订单编号、订单金额、配送时间,只读
映射参数名你要填的:这个位置从业务数据里取哪个参数。保存时按说明预填,需要按实际参数名调整

填完点 保存配置。任何一行的映射参数名为空都会被拦下,提示 参数不完整。

配置微信模板弹窗:当前绑定模板与更换模板按钮、参数映射表原始字段字段说明映射参数名三列与取消保存配置按钮

步骤 5:按场景开关 ​

行内 是否启用 开关或操作列的 禁用,提示 已禁用「拼团成功提醒」 / 已启用「…」。禁用只是不发这条微信通知,业务本身照常——拼团照样成团,只是没人收到提醒。

四、字段详细说明 ​

项规则
唯一性一个应用下,同一个业务场景只能有一条配置(应用 + 场景唯一)
可绑模板范围只列当前应用、状态为启用的微信模板
未绑定已绑定微信模板 列显示灰色 未绑定,该场景不会发任何微信消息
参数映射完整性每一行映射参数名都必须有值,缺一项报 参数不完整,整条不保存
换模板用弹窗里的 更换模板;换完参数映射需重新核对,因为新模板的字段名多半不一样
模板被删绑定的模板在消息模板页删除后,这里显示 模板已删除,需要重新绑定
事件记录缺失直接访问不存在的场景会报 业务事件不存在,回列表点一次 初始化业务事件

五、典型使用场景 ​

小程序刚上线,一条通知都收不到。 完整链路是:平台配置 配好微信应用 → 消息模板 选应用并同步模板 → 本页选同一个应用 → 初始化业务事件 → 逐条 绑定微信模板 → 逐条 配置微信模板 核对参数。少任何一步都发不出去,而最常见的漏点是两个页面选的应用不是同一个。

只想发充值和取货提醒,别的都先关着。 不用删事件,把不想发的行 禁用 即可;日后要开回来,绑定和参数都还在。

换了个更合适的模板。 进 配置微信模板 点 更换模板 选新的,然后把参数映射表逐行核对一遍——thing1 变成了 thing4 这种事很常见,换完不核对往往就是「消息发出去了但内容是空的」。

新增了一种业务,清单里没有对应事件。 本页的事件清单由系统预置,不支持自建。确实需要新场景,需要开发侧扩展,不在配置能力范围内。

排查客户没收到通知。 按顺序看:这条事件是否启用 → 是否已绑定(不是 未绑定)→ 绑的模板在消息模板页是否也是启用状态 → 参数映射是否完整。四处都对,再去查发送日志。

六、权限控制与前置条件 ​

  • 前置一:微信应用已配置,见 平台配置。
  • 前置二:模板已就绪,见 消息模板。本页只能绑「当前应用 + 已启用」的模板。
  • 初始化与绑定会改变全体客户收到的消息,属系统管理岗操作;业务岗建议只读,不要随手禁用。
  • 入口在 系统 菜单下,按 权限模型与生效规则 判定可见性。

七、常见问题 ​

列表空的,按钮只有「初始化业务事件」。 正常,这个应用还没初始化过。点它,确认后 16 条事件一次建齐。

点了初始化,会不会把我配好的绑定清掉? 不会。确认框写得很清楚,已存在的记录不会重复创建,只补没有的。

「绑定微信模板」下拉里没有我要的模板。 三个可能:模板在另一个应用下(切回那个应用去消息模板页看)、模板被禁用了(去消息模板页打开开关)、模板压根没同步进来(去消息模板页点 同步模板)。

保存配置报「参数不完整」。 参数映射表里有行的「映射参数名」是空的,逐行补齐再保存。这张表不能只改一半。

换了模板以后原来的参数映射还在吗? 界面会按新模板的字段重新列出映射表,旧值不保证沿用,务必逐行核对后保存。

禁用了事件,客户订单会受影响吗? 不会。这里只管微信通知,业务单据、库存、结算都不经过这一层。

为什么有的场景标识是数字、有的是英文? 数字(如 18)是系统预置事件的编号;英文标识(如 order_paid)是另一类按事件码接入的场景。配置方式完全一样,只是标识写法不同。

能不能给一个场景绑两个模板? 不能,一个场景一条绑定。确实需要发两条,得由开发侧扩展事件。

相关文档 ​