操作版手册

把模板配置从“会填表”变成“知道为什么这样填”

这份 HTML 指南基于 Obsidian 手册和当前菲律宾模板申请页面整理。业务先按流程收集信息,平台同学再录入,审核同学按清单把关,可以减少租户选错、接入方选错、变量漏传、限额乱填和上线后发不出去的问题。

业务上手只抓 4 件事

租户、申请部门、实际业务 Owner。
发什么消息类型、业务类型、模板内容、变量。
谁调用技术接入方、模板 ID、上线时间。
发多少预算、每日限额、周期限额、峰值限流。
配置问题联系人 如果租户、业务、技术接入方、业务类型、限额等配置无法确认,可以咨询消息中台-郭志强 / 汪明天。
路由隔离排期 业务路由按实际业务线做选项隔离已在排期,预计 6 月上线。上线前仍需人工确认业务路由是否匹配。

先看流程

模板申请不是只填文案。它同时决定谁能调用、走哪个路由、按什么口径统计、受什么频控限制、由谁承担成本和合规责任。

建议先按此流程走
1

业务先给信息

确认国家、租户、渠道、场景、模板内容、变量、预计发送量和上线时间。

2

平台录入申请

进入模板管理下的模板申请,按真实业务归属录入字段,不凭名字猜。

3

审核逐项把关

核对租户、接入方、内容、变量、业务类型、限额和预算是否一致。

4

上线后回查

确认模板已生效,技术使用的模板 ID 正确,发送异常再排查发送侧。

先复用,后新增: 已有类似模板时,优先查模板列表参考历史配置。不要重复申请一堆相似模板绕过审核。

三个页面

新人先只理解模板管理下的三个页面:模板申请、模板审核、模板列表。

模板管理

模板申请

新建短信、语音、邮件、Viber 模板。重点是每个字段怎么填,以及字段如何影响路由、权限、频控和合规。

模板审核

审核模板归属、内容、变量、业务类型、限额、预算是否合理。通过或驳回都要有清楚判断。

模板列表

查询和维护已提交模板。按租户、标题、消息类型、状态查模板,确认是否通过、驳回或停用。

申请负责提交 审核负责把关 列表负责查询和维护

页面截图

以下截图来自当前模板申请页面,用来帮助业务理解字段位置和选项含义。

当前页面
模板申请页面全局字段截图
模板申请主页面:从申请人、租户、申请部门、标题、预算,到消息类型、内容、业务类型、限额和长链。
租户下拉选项截图
租户示例:Kidlat Peso(非主包)、Junahand(非主包)、waba、juanhand。
消息类型下拉选项截图
消息类型示例:短信、语音、邮件、viber。不同渠道的内容规则不同,不可混用。
业务类型下拉选项截图
业务类型示例:验证码、通知、营销、催收。业务类型用于合规和频控分类,首次配置不清楚时先咨询消息中台。

字段怎么填

最容易混淆的是租户、业务、技术接入方、消息类型、业务类型、变量、长链。这些字段不是备注,会影响调用权限、路由和统计口径。

核心字段
租户 模板所属业务主体,通常和国家、产品线、包、业务归属有关。 PH 示例:Kidlat Peso(非主包)Junahand(非主包)wabajuanhand
申请部门 对模板负责的内部部门,不一定是提交人所在部门。 技术代运营提交时,应选运营 Owner 所属部门;催收模板应选催收相关部门。
业务 具体发送场景或路由配置,比业务类型更细。 OTP 不要随便选通知或营销路由;生产模板不要选“空路由不发送短信”。业务路由按实际业务线做选项隔离在排期,预计 6 月上线。
技术接入方 实际调用消息平台接口的内部系统或服务。 常用示例:金果OTPPMSCDS犁剑各业务线 App
消息类型 发送渠道。当前页面可见短信、语音、邮件、viber。 短信、邮件、Viber 的内容格式、审核规则、合规要求不同,不能混选。
业务类型 合规和频控分类,不是具体业务名称。 当前新增配置项:验证码通知营销催收。内容是什么,就选对应类型。
变量 模板里的动态占位符,发送时由技术系统传入真实值。 常见变量:${code}${amount}${date}${minutes}${deeplink}
长链 真实完整跳转链接,例如活动页、还款页、App 跳转链接。 如果内容需要跳转,内容里必须配置 ${deeplink},长链不要带明文敏感信息。
业务和业务类型不要混淆: 业务是具体场景或路由,例如“注册专用_OTP-JuanHand”;业务类型是合规分类,例如“验证码”。
配置问题联系人: 业务首次配置前若不清楚租户、业务、技术接入方、业务类型或限额,可以咨询消息中台-郭志强 / 汪明天。

限额与风险

限额字段不是为了让表单通过,而是控制发送事故、成本事故和合规风险。

频控

每日限额

控制一天内最多发送多少。具体是按模板、用户、手机号、接入方还是其他维度,以平台实际配置为准。

太小:业务发不出去 太大:异常时放大发送事故

发送限额

控制某个周期内最多发送多少条,例如 7 天内最多发送 3 条,防止短时间反复触达用户。

营销防骚扰 催收防合规风险 通知防重复触发

峰值限流

控制瞬时发送速度,例如每 10 秒最多发送 5 条,保护平台、供应商和业务系统。

批量发送必填谨慎 新模板上线要关注

预算

预算要结合日发送量、渠道单价和短信拆条。短信内容越长、变量越长,越可能按多条计费。

预算低估会超支 长链可能增加长度
场景 限额建议 注意点
验证码 / OTP 频控应更严格,配合手机号、设备、IP 等风控。 不能夹带营销内容,变量如 ${code} 必须能传值。
通知 按真实业务触发频率设置。 内容要客观,不要包装成营销。
营销 按活动计划、授权用户、触达频次设置。 关注退订、发送时间和当地合规。
催收 按当地合规和内部策略设置,不要无限制触达。 文案避免威胁、骚扰、误导和敏感承诺。

渠道要点

同一套模板申请页面会覆盖不同渠道,业务不能用短信思路直接套邮件或 Viber。

短信 / 邮件 / Viber

短信模板

重点检查内容长度、变量长度、签名、是否拆条、链接、退订提示和当地短信合规。

变量没定义会原文下发 长短信可能多条计费

邮件模板

重点检查邮件标题、发件域名、正文格式、变量替换、链接跳转、附件或图片支持、退订说明。

别只申请正文 HTML 需要兼容邮箱客户端

Viber 模板

重点检查租户和国家是否支持 Viber,内容是纯文本、按钮、图片还是富媒体,是否需要供应商审核和 fallback。

确认用户可触达 确认失败后是否转短信

模板申请步骤

路径:模板管理 -> 模板申请。建议由业务先提供信息,再由平台同学录入。

录入顺序
  1. 选择模板类型,例如短信模板、邮件模板、Viber 模板。
  2. 确认申请人信息,代申请时写清实际 Owner。
  3. 选择租户。
  4. 选择申请部门。
  5. 填写标题。
  6. 填写模板预算。
  7. 选择业务。
  8. 选择技术接入方。
  9. 选择消息类型。
  10. 填写模板内容。
  11. 选择业务类型。
  12. 设置每日限额、发送限额、峰值限流。
  13. 如使用链接,填写长链,并在内容中配置 ${deeplink}
  14. 完成自查后提交。

标题和预算示例

PH-SMS-OTP-注册验证码-v1
PH-Viber-营销-还款提醒-v1
MX-Email-通知-合同发送-v1
预计 3000 元/月,日均 25000 条,
短信按 0.04 元/条预估。

审核清单

提交前和审核时按下列项目逐项核对。这里是静态核对标准,不做页面交互。

自查
归属租户和真实业务归属一致;申请部门是实际业务 Owner 所属部门。
标题标题能看懂国家、渠道、场景、用途和版本,不写“测试”“通知模板”等泛名称。
预算预算和预计发送量有依据,短信已考虑长短信拆条和变量长度。
路由业务字段和真实发送场景一致;业务路由隔离上线前,不能凭相似名称硬选。
接入方技术接入方和实际调用系统一致,避免模板通过但系统无权限调用。
渠道消息类型正确,短信、语音、邮件、Viber 不混选。
分类业务类型和内容一致,没有把营销或催收包装成通知。
内容正文没有敏感、违规、误导或未确认承诺。
变量所有变量都有定义,技术侧能传值,避免用户收到 ${code} 原文。
链接如需跳转,长链已测试,内容中有 ${deeplink},链接不带明文敏感信息。
限额每日限额、周期限额、峰值限流不是空值、异常小或异常大。
上线测试接收方已准备,上线时间已和技术确认,模板不会在审核中被依赖。
常见坑 后果
租户选错发送失败、统计错、成本错、权限错。
技术接入方选错技术调用不到模板,或数据归属错误。
变量没定义用户收到未替换的占位符,例如 ${code}
链接没测用户点击失败,活动或还款路径断掉。
限额乱填可能发不出去,也可能异常大量发送。
业务类型选错合规审核和频控策略错误。

信息收集表

业务可以先按这张表给信息,平台同学再录入,减少反复追问。

业务填写
先确认归属国家、产品、包、租户、实际业务 Owner、申请部门。
再确认内容渠道、业务类型、业务场景、模板正文、变量、链接。业务类型新增项为验证码、通知、营销、催收。
最后确认上线技术接入方、预计发送量、预算、限额、测试接收方、上线时间。首次配置不清楚时咨询消息中台-郭志强 / 汪明天。
字段 业务填写
申请人
实际业务 Owner
租户例如 Kidlat Peso(非主包)/ Junahand(非主包)/ waba / juanhand
申请部门
消息类型短信 / 语音 / 邮件 / Viber
业务类型验证码 / 通知 / 营销 / 催收
业务场景
技术接入方常用:金果OTP / PMS / CDS / 犁剑 / 各业务线 App
模板标题
模板内容
变量清单例如 ${code}${minutes}${deeplink}
是否包含链接是 / 否
链接地址
预计日发送量
预计月预算
每日限额
周期限额例如 7 天最多 3 条
峰值限流例如每 10 秒最多 5 条
计划上线时间
测试号码 / 邮箱 / Viber 账号
审批人

常见问题

上线前先解决配置问题。模板已通过不等于一定能发出去。

排查
找不到租户怎么办?
先确认业务所属国家、产品、包名,再到模板列表查同类模板使用哪个租户。仍不确定时找平台负责人或技术负责人确认,不要随便选相似名字。
找不到业务怎么办?
先确认这是新业务还是已有业务的新模板。已有业务查历史模板,新业务先确认是否需要新增路由配置。不要用“通知类通用路由”覆盖所有场景。业务路由按实际业务线做选项隔离在排期,预计 6 月上线;上线前无法确认时咨询消息中台-郭志强 / 汪明天。
找不到技术接入方怎么办?
问技术侧实际调用消息平台接口的系统名称,再查历史模板是否已有相同接入方。目前常用接入方可能包括金果OTP、PMS、CDS、犁剑以及各个业务线 App。没有则先确认是否需要新增接入方配置。配置问题无法确认时咨询消息中台-郭志强 / 汪明天。
业务类型不知道选哪个怎么办?
先看内容本身:验证码用于注册、登录、绑卡、找回密码等 OTP;通知用于账单、状态变更、服务提醒;营销用于活动、优惠、召回、促转化;催收用于还款、逾期、账务提醒。首次配置前若不清楚,咨询消息中台-郭志强 / 汪明天。
审核被驳回怎么办?
先看驳回原因,再找业务或技术补充信息,修改后重新提交。不要新建重复模板绕过审核。
模板已通过但发不出去怎么办?
按顺序查:模板是否生效、模板 ID 是否正确、技术接入方是否有权限、租户和业务路由是否匹配、是否超每日或周期限额、是否触发峰值限流、供应商或渠道是否异常。