模板与邮件编辑器
模板是针对单个渠道的现成消息:邮件、Telegram 消息、SMS、Web Push、移动推送、应用内消息、Webhook 等。同一个模板可以被旅程、群发以及档案卡片中的手动发送使用。变量会将客户姓名、订单金额等数据填入文本。
在菜单中打开用户互动 → 模板。所有角色都可以查看模板,“经理”及以上角色可以创建和修改模板。
创建模板
- 打开模板,点击右上角的新建模板,然后在列表中选择渠道:列表包含项目中启用的所有渠道,例如邮件或 Telegram。
- 填写通用字段(见下表)。
- 填写内容模块。字段因渠道而异。邮件包括主题、预览文本(邮件列表中显示在主题旁的文字)、邮件编辑器或 HTML,以及纯文本版本。如果不填写纯文本版本,系统会根据 HTML 自动生成。
- 点击保存。每次保存后版本号都会递增(“版本 3”)。
| 字段 | 含义 |
|---|---|
| 名称 | 仅在界面中显示:模板、旅程和群发的列表中 |
| 渠道 | 在创建时选择,之后无法更改 |
| 订阅主题 | 目录中的主题,例如 marketing 或 news,或者新的键(它会出现在目录中)。客户可以只退订该主题 |
| 事务性消息 | 发送时不检查订阅、频率和免打扰时段,但不会发往收件人已关闭的渠道:邮箱或号码不存在、机器人已被屏蔽。仅用于订单确认、密码重置等类似消息,参见事务性消息与级联发送 |
模板列表
表格中显示渠道、模板的语言版本(主语言以颜色突出显示)、送达率评级、订阅主题,以及修改时间和版本号。
送达率是邮件模板所有语言版本的送达率检查汇总结果:各版本中最差的评级(“良好”“有待改进”“较差”)以及最高的垃圾邮件过滤器分数(6 分及以上为垃圾邮件)。将鼠标悬停在标记上,提示中会显示每种语言的详情和检查时间。每次修改邮件后,模板都会在后台重新检查,检查期间标记显示“检查中”。仅修改名称或订阅主题不会重新检查。如果评级为“有待改进”或“较差”,请打开模板并在其中运行检查,查看具体问题。
表格上方有按名称搜索,以及按渠道、语言和送达率评级筛选,例如所有评级为“较差”的模板,或所有带有德语版本的模板。点击列标题可对表格排序,再次点击则反转顺序。 筛选和排序会被记住:删除模板或从编辑器返回后,列表保持不变。

要删除模板,请点击列表中该模板所在行的垃圾桶图标。
变量
模板使用 Twig 语言编写。变量放在双大括号中。展开内容下方的变量模块,可以查看带示例的完整列表。
| 变量 | 填入的内容 |
|---|---|
profile.email、profile.phone、profile.user_id |
客户的标识符 |
traits.first_name 及其他 traits.* |
档案属性 |
event.name、event.properties.amount |
触发该消息的事件 |
context.data.*、context.nodes.* |
旅程数据:通过 API 进入时传入的数据,以及“Webhook”节点的响应 |
project.name、unsubscribe_url、preferences_url |
项目名称、退订链接和订阅偏好中心链接 |
project.legal_address |
项目设置中的公司注册地址;适合放在邮件页脚。未填写地址时为空 |
loyalty.points、loyalty.tier、loyalty.expiring、loyalty.expire_at、loyalty.referral_url |
会员积分计划中的账户:余额、等级、即将过期的积分及其日期、邀请链接 |
wallet_url |
Wallet 会员卡链接:顾客可将会员卡添加到 Apple Wallet 或 Google Wallet。有效期 90 天;未连接 Wallet 卡券时为空 |
promo_code('welcome') |
顾客在优惠码池 welcome 中的优惠码:发送时发放,预览中显示示例 |
order.number、order.amount、order.tracking_url |
商店邮件中的订单:订单号、金额、物流追踪链接;带货币的金额写作 {{ order.amount|money(order.currency) }} |
product('SKU-1') |
邮件语言的目录商品:name、url、image、price、old_price、currency、available、stock,取发送时的数据(商品价格与库存) |
您好,{{ traits.first_name|default('朋友') }}!
{% if event.properties.amount > 5000 %}免运费。{% endif %}
模板在安全沙箱中执行。沙箱支持 if 条件、for 循环、set,date、min、max 函数,以及 default、date、upper、lower、capitalize、number_format、round、join、replace、striptags 等过滤器。如果变量不存在,会填入空字符串,因此请为重要位置设置 default。如果使用了被禁止的结构,保存时会出现“模板使用了被禁止的结构”错误。渲染后的消息不能超过 512 KB。 不支持模板继承(extends、block),循环以及对商品、推荐和优惠码的调用也有上限:执行操作过多的模板无法保存。
如果模板中有平台不认识的变量,例如其他版式留下的占位符 {{ COMPANY_ADDRESS }},或把 {{ traits.first_name }} 误写成 {{ first_name }},内容上方会显示列出这些变量的警告。它们在消息中将为空。您打开、保存、预览模板或发送测试时,警告会随之更新。
预览和测试发送
- 在预览面板中输入档案 ID、邮箱或 user_id,然后点击眼睛图标。如果留空,将使用最近活跃的档案数据。
- 对于邮件,可以在桌面端、手机、深色模式和不显示图片之间切换。最后一种模式下,图片会被替换为
alt文字:不加载图片的收件人看到的就是这样的邮件。 - 在测试发送面板中选择集成。填写您自己的地址或 chat id,否则消息将发送到档案的地址。点击发送测试:按钮下方会显示消息状态。
“经理”及以上角色可以进行测试发送。测试发送不检查订阅、频率和免打扰时段。预览中没有触发事件,因此 event.* 变量为空。如果您没有查看个人数据的权限,邮箱和电话会被脱敏。

预览中邮件下方是在收件箱中模块。它显示发件人、主题和预览文本在 Gmail 电脑端、Outlook 和 iPhone 邮件的邮件列表中的样子。过长的主题和预览文本会被截断,截断方式与这些客户端大致相同。发件人名称取自您在送达率检查模块中选择的集成。

送达率检查
发送前可以检查邮件模板:邮件会进入收件箱还是垃圾邮件。在送达率检查模块中,选择邮件将通过哪个集成发送,然后点击检查。邮件会按实际发送时的方式生成:包含打开和点击追踪以及退订链接。检查的是当前打开的语言版本,数据取自预览中指定的档案。
检查包括三个方面:
- 发件人。 使用 OneTrace.pro 的邮件服务时,发件地址的域名必须已在发信域名中添加并通过验证,最好还有 DMARC 记录。使用自有 SMTP 服务器时,会检查域名的 SPF 和 DMARC 记录;DKIM 签名需要在您的邮件服务商处配置,无法在此检查。
- 内容。 主题(为空、全部大写、含
!!或$$、过长)、预览文本、邮件大小(Gmail 会截断超过 102 KB 的 HTML)、只有图片的邮件、没有alt的图片、短链接、指向 IP 地址的链接、链接文字是另一个网站地址的链接、营销邮件中可见的退订链接,以及邮件客户端会删除的元素(脚本、表单、框架)。 - 垃圾邮件过滤器评分。 Rspamd 垃圾邮件过滤器会检查整封邮件。分数低于“可疑”阈值为良好,高于“垃圾邮件”阈值则邮件很可能进入垃圾邮件。影响评分的因素列表显示过滤器的规则及其权重。
结果为下列评级之一:良好(没有明显会进入垃圾邮件的原因)、有待改进(邮件可以送达,但建议您修正这些问题)或较差(垃圾邮件风险较高或发件人有误)。每条问题都会说明哪里不对以及如何修正。
下方是邮件客户端兼容性:在 Windows 版 Outlook、Gmail、Yandex 邮箱或 Mail.ru 中无法使用的排版方式,例如圆角、阴影、媒体查询、自定义字体、SVG 和视频。邮件仍可送达,只是显示效果会有所不同,因此不影响评级。

群发会以同样的方式检查各变体的邮件,参见发送前检查邮件。
语言版本
一个模板可以包含多种语言的版本。每位收件人都会收到其档案语言(language 属性)的版本;如果没有该版本,则收到主要版本。可选的语言在项目设置中设定。
-
在内容区块上方点击添加语言并选择语言,然后选择创建版本的方式:

-
使用语言按钮在版本之间切换。主要版本标有"主要"。
-
如果希望没有自己版本的收件人收到另一种语言,请打开该语言的版本并点击设为主要。删除版本会移除当前打开的版本。
-
点击保存。每个版本都会单独检查;有错误的版本会显示警告图标。
翻译草稿
无需从头手动翻译某个版本:打开该版本并点击翻译草稿。OneTrace.pro 会把主要版本翻译成当前打开标签页的语言,包括主题、预览文本、编辑器各模块的文本、纯文本版本,以及 SMS、推送和即时通讯的文本。{{ traits.first_name }} 之类的变量、链接、图片和排版保持不变。
草稿只会填入表单。请通读并修改措辞,然后点击保存。如果某个字段无法在不丢失变量的情况下翻译,它会保留源语言,OneTrace.pro 会显示这类字段的数量。如果该版本已与主要版本不同,替换前会先询问您。
每月可生成的草稿数量受套餐限制,参见套餐。如果您的安装未启用翻译,则不会显示该按钮。
版本的选择顺序:先是完全匹配的语言,然后是不含地区的语言(使用 pt-BR 的客户会收到 pt 版本),再然后是同一语言的其他变体。预览和测试发送显示当前打开的版本,变量 {{ language }} 包含所发送版本的语言。
邮件编辑器
在邮件模板的“邮件编辑器”字段中点击打开编辑器。如果模板中已有 HTML,编辑器会从头开始创建邮件,旧代码将在保存时被替换。适用于各种邮件客户端(包括 Outlook 和手机)的代码由 OneTrace.pro 在保存时自动生成。
画布右侧有三个选项卡:
- 添加区块:添加一个区块。它会放在所选区块之后,或放在邮件末尾的页脚之前。
- 区块设置:画布上所选区块的设置。区块可以上移、下移、拖动、复制和删除。
- 邮件:背景、邮件背景、文本和链接颜色、字体、邮件宽度(480–800 px)、内边距以及图片显示方式。
| 区块 | 用途 |
|---|---|
| 标题、文本 | 带格式和变量的文本,例如 {{ traits.first_name }} |
| 图片 | 来自媒体库的图片:替代文本、链接、宽度 10–100% |
| 按钮 | 文字、链接、颜色和圆角 |
| 分隔线、间距 | 线条和空白 |
| 分栏 | 2–3 栏,可包含标题、文本、图片、按钮和间距。在手机上,各栏会垂直堆叠 |
| 商品 | 来自推荐的商品:个性化、热门、“一起浏览”“相似”等。个性化、热门和趋势商品可以按目录的类目限定。来源为所选商品时,会按设定的顺序显示最多 12 个目录商品:按名称查找,邮件中只会包含有库存的商品。可显示 1 到 12 个商品,分 1–4 栏,并可带价格和按钮。有评价的商品会在名称下方显示评分。如果没有匹配的商品,该区块不会出现在邮件中 |
| 订单 | 商店邮件中的订单:商品、金额、包裹物流追踪和地址。在不含订单的邮件中没有该区块 |
| 问卷 | 问卷的主要问题:NPS 0–10 按钮或五颗星。客户直接在邮件中打分,问卷页面会保存评分,并请客户回答其余问题 |
| HTML | 原样插入的自定义代码 |
| 页脚 | 文本、退订链接和“管理订阅”链接 |

“邮件”选项卡中的切换到 HTML 按钮会将邮件转换为普通代码。转换后无法再返回编辑器。
链接还是附件
| 链接(CDN) | 作为邮件附件 | |
|---|---|---|
| 邮件大小 | 较小 | 增加图片的大小 |
| 显示方式 | 打开邮件时加载图片。如果邮箱屏蔽图片,只显示替代文本 | 图片立即可见 |
默认方式在“邮件”选项卡的默认图片投递方式字段中设置。单张图片的方式可以在投递方式字段中更改。一封邮件的所有附件合计不超过 1 MB。如果部署中未配置公开链接,则只能使用附件。
邮件编辑器中的 AI
AI 可以协助处理邮件模板的文本:建议主题、修改区块文本,以及根据描述生成整封邮件。AI 的结果只是草稿:它会进入表单或编辑器,由您来保存模板。AI 了解项目名称、店铺所属行业、货币、当前打开版本的语言以及品牌语气和规则,但不会获得客户的数据。
AI 在付费套餐中可用,并按用量从项目余额中扣费。如果 AI 当前不可用(试用期、余额为零或已达到支出上限),按钮仍会显示,旁边会注明原因。
主题建议
主题建议按钮位于“主题”和“预览文本”字段上方。选择侧重点——多种思路、好奇与清晰、紧迫感、个性化称呼或读者获益——也可以填写要求,例如“不用表情符号”。点击生成建议:AI 会根据当前打开的邮件版本的文本,提出五组“主题 + 预览文本”。
列表中的主题会以带示例姓名的形式显示,与收件人看到的一致。标记含收件人姓名表示主题中含有姓名变量。使用按钮会把这一组填入表单。

修改区块文本
在编辑器画布上选择标题、文本或按钮。在区块设置面板的AI:修改文本部分有缩短、更亲切、更正式、纠正错误和**改写…**按钮,最后一个可按您的要求改写。AI 的建议会显示在按钮下方:替换会把它填入区块,取消则保持原文不变。
AI 不会更改模板变量和链接。如果回复中丢失了变量或修改了链接,文本不会被替换,您会看到原因说明。

根据描述生成邮件
AI 撰写邮件按钮位于编辑器上方,紧挨着“打开编辑器”按钮。请描述邮件的内容以及您希望读者做什么,并给出链接——例如“大衣促销至周日,最高优惠 30%,链接 https://…”。如果邮件中需要商品,请勾选目录中的商品:AI 会查看目录类目,并找出有库存的商品。点击生成邮件——通常不到一分钟。
如果希望新邮件与您的其他邮件风格一致,请选择示例邮件——本项目中用编辑器制作的邮件模板。AI 会沿用它的版式和结构:颜色和字体、徽标及其他图片、按钮、促销码框等 HTML 模块,以及带变量的页脚。文案则根据描述撰写:除非您在描述中写明,示例中的活动、促销码和链接不会带入新邮件。
邮件由编辑器区块组成:标题、文本、按钮、商品,以及带退订链接的页脚。如果编辑器中已有邮件,OneTrace.pro 会询问是否替换。主题和预览文本仅在这两个字段为空时才会填入。如果有需要修改的地方,编辑器上方会显示提示——例如需要填写描述中没有提供的按钮链接。

邮件的 A/B 测试变体,AI 直接在群发中生成。
导入现成的邮件
如果邮件已在其他服务中设计好,无需重新制作。在 模板 页面点击 导入邮件(AI):
- 选择 文件,上传从邮件客户端保存的邮件(
.eml)或.html页面;或选择 HTML 代码,粘贴邮件代码。 - 点击 导入。AI 处理邮件通常需要一分钟左右。
- 编辑器会打开一个新的邮件模板:邮件已拆分为编辑器模块,图片已复制到媒体库,收件人姓名替换为变量
{{ traits.first_name }},退订链接移入“页脚”模块。文本和链接保持与原邮件一致。 - 检查模板后点击 保存。保存之前模板并不存在。


如果邮件的部分内容未能转移,表单上方会显示列表:哪些图片未能复制、哪些模块被跳过。如果邮件无法拆分为模块,将作为单个“HTML”模块导入。跟踪像素和“在浏览器中查看”链接不会导入。
OneTrace.pro 会识别邮件语言:依据 lang 属性和 Content-Language 头;如果它们与正文不符,则依据邮件正文本身。邮件语言会成为新模板的主要语言。
导入到语言版本
如果已有其他语言的邮件,无需翻译:在打开的邮件模板中点击 添加语言,选择语言,再选择 用 AI 导入邮件。邮件的上传方式与创建模板时相同,并进入所选语言的版本,带有自己的模块、图片和主题。检查该版本后点击 保存。
如果邮件语言与所选语言不一致,版本上方会显示提示,例如“这封邮件似乎是法语”,以及 设为“法语”版本 按钮。如果该版本已存在,OneTrace.pro 会询问是否替换。
导入功能适用于“增长版”和“企业版”套餐;每月导入次数(包括新模板和版本)取决于套餐,详见 套餐。在“入门版”套餐中,按钮会显示从哪个套餐起可使用该功能。
媒体库
添加“图片”区块或点击选择图片时会打开媒体库。
- 上传支持不超过 10 MB 的 JPEG、PNG、GIF、WebP 和 AVIF。较宽的图片会缩小到 1200 px。WebP 和 AVIF 会被重新编码,因为并非所有邮件客户端都能显示这些格式。GIF 保持原样,包括动画。
- 重复上传同一文件不会产生副本。
- 模板中正在使用的图片无法删除,除非先将其从模板中移除。
- 图片占用的空间计入套餐限额。
