模板与邮件编辑器
模板是针对单个渠道的现成消息：邮件、Telegram 消息、SMS、Web Push、Webhook 等。同一个模板可以被旅程、群发以及档案卡片中的手动发送使用。变量会将客户姓名、订单金额等数据填入文本。
在菜单中打开用户互动 → 模板。所有角色都可以查看模板，“经理”及以上角色可以创建和修改模板。
创建模板
- 打开模板。右上角为项目中启用的每个渠道都提供了一个按钮，例如邮件或 Telegram。点击所需的按钮。
- 填写通用字段（见下表）。
- 填写内容模块。字段因渠道而异。邮件包括主题、预览文本（邮件列表中显示在主题旁的文字）、邮件编辑器或 HTML，以及纯文本版本。如果不填写纯文本版本，系统会根据 HTML 自动生成。
- 点击保存。每次保存后版本号都会递增（“版本 3”）。
| 字段 | 含义 |
|---|---|
| 名称 | 仅在界面中显示：模板、旅程和群发的列表中 |
| 渠道 | 在创建时选择，之后无法更改 |
| 订阅主题 | 例如 marketing 或 news。客户可以只退订该主题 |
| 事务性消息 | 发送时不检查订阅、频率和免打扰时段。仅用于订单确认、密码重置等类似消息 |
要删除模板，请点击列表中该模板所在行的垃圾桶图标。
变量
模板使用 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 |
项目名称和退订链接 |
您好，{{ 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。
预览和测试发送
- 在预览面板中输入档案 ID、邮箱或 user_id，然后点击眼睛图标。如果留空，将使用最近活跃的档案数据。
- 对于邮件，可以在桌面端、手机和深色模式之间切换。
- 在测试发送面板中选择集成。填写您自己的地址或 chat id，否则消息将发送到档案的地址。点击发送测试：按钮下方会显示消息状态。
“经理”及以上角色可以进行测试发送。测试发送不检查订阅、频率和免打扰时段。预览中没有触发事件，因此 event.* 变量为空。如果您没有查看个人数据的权限，邮箱和电话会被脱敏。
邮件编辑器
在邮件模板的“邮件编辑器”字段中点击打开编辑器。如果模板中已有 HTML，编辑器会从头开始创建邮件，旧代码将在保存时被替换。适用于各种邮件客户端（包括 Outlook 和手机）的代码由 OneTrace.pro 在保存时自动生成。
画布右侧有三个选项卡：
- 添加区块：添加一个区块。它会放在所选区块之后，或放在邮件末尾的页脚之前。
- 区块设置：画布上所选区块的设置。区块可以上移、下移、拖动、复制和删除。
- 邮件：背景、邮件背景、文本和链接颜色、字体、邮件宽度（480–800 px）、内边距以及图片显示方式。
| 区块 | 用途 |
|---|---|
| 标题、文本 | 带格式和变量的文本，例如 {{ traits.first_name }} |
| 图片 | 来自媒体库的图片：替代文本、链接、宽度 10–100% |
| 按钮 | 文字、链接、颜色和圆角 |
| 分隔线、间距 | 线条和空白 |
| 分栏 | 2–3 栏，可包含标题、文本、图片、按钮和间距。在手机上，各栏会垂直堆叠 |
| 商品 | 来自推荐的商品：个性化、热门、“一起浏览”“相似”等。可显示 1 到 12 个商品，分 1–4 栏，并可带价格和按钮。如果没有匹配的商品，该区块不会出现在邮件中 |
| HTML | 原样插入的自定义代码 |
| 页脚 | 文本和退订链接 |
“邮件”选项卡中的切换到 HTML 按钮会将邮件转换为普通代码。转换后无法再返回编辑器。
链接还是附件
| 链接（CDN） | 作为邮件附件 | |
|---|---|---|
| 邮件大小 | 较小 | 增加图片的大小 |
| 显示方式 | 打开邮件时加载图片。如果邮箱屏蔽图片，只显示替代文本 | 图片立即可见 |
默认方式在“邮件”选项卡的默认图片投递方式字段中设置。单张图片的方式可以在投递方式字段中更改。一封邮件的所有附件合计不超过 1 MB。如果部署中未配置公开链接，则只能使用附件。
媒体库
添加“图片”区块或点击选择图片时会打开媒体库。
- 上传支持不超过 10 MB 的 JPEG、PNG、GIF、WebP 和 AVIF。较宽的图片会缩小到 1200 px。WebP 和 AVIF 会被重新编码，因为并非所有邮件客户端都能显示这些格式。GIF 保持原样，包括动画。
- 重复上传同一文件不会产生副本。
- 模板中正在使用的图片无法删除，除非先将其从模板中移除。
- 图片占用的空间计入套餐限额。
