更新日志

• 已修复：配额警告（80%）、配额超限及发件人提醒邮件未能送达大部分店铺。应用在您首次打开时记录的店铺联系邮箱，会在每小时令牌刷新时被清空，导致提醒邮件无处可送。 目前该邮箱信息已保留，所有受影响的店铺均已恢复相关记录，本月应发送的提醒邮件也已发出。

• 上传的品牌字体（“设置” > “品牌和字体”）现已作为字体样式嵌入电子邮件中，并在编辑器中加载，因此，设置为上传字体的布局将在编辑器、预览以及支持加载网页字体的邮件客户端（Apple Mail、iOS Mail、Mac 版 Outlook、Thunderbird）中显示该字体。 Gmail 和 Windows 版 Outlook 不会加载任何发件人的网络字体，而是始终显示备用字体。在此版本发布之前，上传的文件从未随邮件一并发送，因此所有邮件客户端都会使用备用字体。
• 已修复：邮件编辑器中的编译预览在首次打开时有时会显示为空白。现在，预览框在创建时已包含邮件内容，因此首次点击即可显示。

在视觉布局中，使用“文本”块工具栏将段落居中或右对齐后，该段落在编辑器和预览中显示正常，但发送的电子邮件却采用了该块本身的对齐方式（左对齐，除非你更改了该块）。该段落的对齐方式是以邮件客户端会忽略的方式写入的。

今天已修复。现在，邮件的显示效果与编辑器中完全一致：段落的对齐方式优先于其所属区块的对齐方式。您无需进行任何更改，也无需再次保存布局；您工作流程中发送的下一封邮件已显示正确。

如果您之前设置过段落对齐方式，但邮件一直未按此设置显示，那么从现在起将按此设置显示。请打开布局预览一次，查看收件人实际收到的效果；画布上一直都显示着该效果。

开发者 API 和 MCP 服务器现已涵盖该应用在 1.16 和 1.17 版本中新增的所有功能。键和级别保持不变：READ 键用于读取，WRITE 键则用于修改数据。

• 退订。GET /api/v1/unsubscribes 列出了包含屏蔽地址的营销退订列表，POST /api/v1/unsubscribes/check 可查询某个地址是否在该列表中（地址应填写在邮件正文中，切勿写入 URL），而 POST / DELETE /api/v1/unsubscribes 用于对某个地址进行退订或重新订阅（WRITE）。MCP：list_unsubscribes、check_unsubscribed、add_unsubscribe、remove_unsubscribe。
• 设置。GET /api/v1/settings 返回商店的电子邮件默认设置（抄送、密送、回复至、发件人姓名）、各语言的营销页脚文本、品牌颜色和自定义字体。MCP：get_settings。
• 权限。GET /api/v1/permissions 列出了可选权限以及已授予的权限。MCP：get_permissions。
• 预设。GET /api/v1/presets 返回各语言对应的页眉和页脚预设及其文本内容。MCP：list_presets。
• 发送健康报告。GET /api/v1/sending-health 返回仪表盘卡片中显示的内容：失效的链接和图片、发件人问题、失败率和退订情况。MCP：get_sending_health。
• **历史记录。**现在，每封电子邮件条目都会标注其布局和发件人（emailTemplateId、senderId），列表会显示总数，并可按布局、发件人、姓名和回溯时间范围进行筛选。统计数据会单独统计被跳过的营销邮件（skippedInvocations）。
• 布局。localeConfirmed 说明该布局的主语言是否已被选定；若保存的营销布局未包含公司详细信息，则会返回 warning；而布局架构（GET /api/v1/layout-schema）则解释了元字段中的附件、唯一折扣码、预设、{{ view_in_browser_url }} 以及公司详细信息。

此外还修复了以下问题：Sidekick 不再从错误消息中引用收件人地址；交易类邮件布局画布中邮件正文下方以及“设置”>“营销邮件”下的页脚预览下方曾出现的一行技术文本现已消失。该文本从未出现在任何已发送的邮件中。

通过关联的 Google 账户发送的电子邮件未能送达**密件抄送（BCC）**收件人。该地址虽被接受，并显示在“历史记录”和 Gmail 的“已发送”文件夹中，但被从传递给 Gmail 的邮件中移除，因此该步骤中 BCC 字段里的 CRM 日志地址从未收到该邮件的副本。 “收件人”和“抄送”收件人未受影响，通过 Microsoft 365 或 SMTP 服务器发送的电子邮件也未受影响。

该问题已于今日修复。您的工作流程无需进行任何更改：从现在起，您设置的密件抄送（BCC）地址将照常使用。在今天之前发送的邮件并未送达至密件抄送地址。

• 可视化编辑器中新增了十三种内容模块。 产品卡片、价格、产品网格、折扣码、倒计时、订单追踪、星级评分、用户评价、社交媒体链接、视频、签名、表格和“在浏览器中查看”，此外还有两个布局模块：“多栏”（2至4栏）和“条件显示”，后者仅在变量满足特定条件时才会显示相应部分。 每个字段均可绑定变量，画布上会显示包含您测试变量的各个模块。 产品卡片、折扣框、客户评价、签名、视频和订单跟踪模块均由图片、标题、文本、价格和按钮等部件组成：打开其中一个模块，即可利用该模块的完整设置来编辑或隐藏每个部件，例如“图片+文本”模块。请参阅 内容模块：产品、折扣、倒计时、追踪等。
• **专属折扣码。**该折扣模块可在您的商店中为每封电子邮件（即每封营销邮件的收件人）生成一个仅限使用一次的折扣码，其金额、有效期和最低消费金额均由您设定。该折扣码将与邮件发送记录一同保存在“历史记录”中。此功能需要新的可选权限“折扣”。
• **实时倒计时。**倒计时模块是在打开电子邮件时渲染的动画图像，共有四种样式。
• 从元字段附加文件。现在，附件可以来自与该“流程”步骤相关的订单或客户的元字段，该元字段可以包含Shopify文件或文件链接，例如另一款应用保存在订单中的发票PDF文件。 在可视化布局中选择“元字段”作为附件来源，或在文本布局中选择**“从元字段添加**”，然后选择相应的元字段，系统将在发送邮件时自动附加该文件；若为列表元字段，则会附加其中的所有条目，且文件大小将在发送时进行检查（每份文件上限为 10 MB）。 “发送交易邮件”和“发送营销邮件”操作新增了**“订单**”和**“客户**”字段，用于告知该步骤读取哪个订单或客户；在此版本发布前添加的步骤需要重新添加才能使用这些字段。请参阅 从订单或客户元字段中附加文件。
• **权限。**安装应用时，应用仍不会请求任何权限。读取订单或客户元字段以及创建折扣码等操作需要您的授权，您可在安装时直接授予这些权限，并可随时在新版“权限”页面中撤销授权。各项权限的具体含义及不包含的内容，请参阅 权限：该应用可以从您的商店读取哪些信息。

Workflow Transactional Email 现在也可以发送营销邮件了，而且您之前发送的每封邮件都将保持原样。

• 营销布局。创建布局时，您可以选择其类型：事务型（默认类型，以及本次更新前的所有布局）或营销型。“电子邮件布局”列表中设有“事务型”和“营销型”两个选项卡。
• **新增流程操作：发送营销邮件。**该操作仅提供营销邮件模板；“发送交易邮件”操作仍仅提供交易邮件模板。您现有的“发送交易邮件”步骤和工作流程将照常运行。
• 每位收件人仅接收一封电子邮件，每封邮件均附有独立的退订链接。一次营销操作最多可向20位收件人各发送一封邮件。每封营销邮件末尾均包含您的退订声明、退订链接及公司信息（按语言分类），这些内容可在“设置”>“营销邮件”中一次性配置，并可根据需要按布局或按翻译版本进行修改。 已退订的客户此后将被跳过：历史记录中显示为“已跳过”，新的**“退订**”页面会列出这些客户，并提供搜索、重新订阅和 CSV 导出功能。
• **设置，以标签页形式呈现。**包括该应用发送的每封邮件的默认设置（抄送、密送、回复至、发件人姓名和测试收件人）、各语言的营销文案、在每个颜色选择器中显示的品牌颜色，以及现有的字体和提示信息。
• 仪表盘中的**“发送状况**”：已发送邮件中的失效链接和图片、发件人问题、失败率以及退订情况。
• 历史数据以CSV格式导出，包含您设置的筛选条件。
• 页眉和页脚预设包含各语言的文本，并在编辑时提供实时预览；堆叠式页眉中的文本和链接均可单独对齐。
• 富文本和HTML布局中每种语言的附件数量。
• 该应用采用了Shopify的新版管理界面设计。

Workflow Transactional Email 以下是您的 Shopify 管理后台的语言设置。支持的语言包括英语、德语、西班牙语、法语、意大利语、荷兰语、丹麦语、葡萄牙语（巴西和葡萄牙）、日语以及中文（简体和繁体）。

• 该应用的每一页、每个对话框和每条消息，包括邮件编辑器、邮件发送者、HTTP 请求、历史记录和设置。
• 在 Shopify Flow 中，"设置"页面以及**“发送交易邮件**”和**“HTTP 请求**”步骤的预览。
• 该应用的 Sidekick 工具和 Shopify Flow 模板。

语言设置将遵循您为 Shopify 账户选择的语言。若要更改语言，请打开您的 Shopify 账户个人资料，并选择**“首选语言**”。您团队中的每位成员都会以各自的语言查看该应用。

有两件事保持不变：

• Shopify Flow 步骤中的字段（如“收件人”、“抄送”、“回复至”、“语言”等）仍显示为英文，因为 Shopify Flow 会完全按照应用程序的定义来显示这些字段。
• 您的电子邮件内容绝不会被更改。它们将完全按照您撰写的内容发送出去。若要向客户发送其母语的电子邮件，请在布局中添加翻译。用客户的语言发送电子邮件

此外还修复了以下问题：当您创建新的页眉或页脚预设时，有时“保存”栏不会显示，导致无法保存预设。现在，只要您进行任何更改，“保存”栏就会立即显示在页面顶部。

包含订单项表的布局会生成一个名为**“在Shopify Flow中使用”的代码片段，其中包含一个针对产品的简短Flow循环。将该代码片段粘贴到“发送事务性电子邮件”操作的“变量（JSON）**”字段中时，系统提示“JSON格式无效”，尽管该代码片段本身是正确的。

原因在于：Shopify Flow 编辑器中的检查操作在 Shopify Flow 尚未填充任何内容之前就读取了文本。此时，该循环还不是 JSON 格式；只有在工作流程运行时，它才会变成一个产品列表。

• 该检查现已在“发送事务性电子邮件”和“HTTP 请求”操作中支持 Shopify Flow 变量和循环。请将代码片段原样粘贴，且无需在line_items这一行周围添加引号。
• 使用 json 过滤器写入的值也是如此，例如 "name": {{ order.customer.displayName | json }}。
• 即使 JSON 存在严重错误（例如缺失逗号或单引号），在保存该步骤时系统仍会报告该错误。

如果某个步骤出现了此错误，请打开该步骤并重新粘贴代码片段。正在运行的工作流程不会受到影响。订单项表 从Shopify Flow传递数据

迄今为止，对于完全没有响应的 SMTP 服务器，系统只会进行重试：每封电子邮件都会因连接超时而失败，且不会发送任何警报，因为单次超时并不能证明该服务器已不可用。

现在，该应用会进行计数。连续三次连接失败后，商店会收到发件人发送的警报，其中会明确指出问题所在 - - 您的邮件服务器未响应我们的连接请求 - - 并附带需要检查的项目：主机、端口、服务器是否正在运行以及是否可通过互联网访问（包括从我们的发件IP地址访问）。成功发送邮件后，计数器将重置。

在 SMTP 服务器上**“测试连接**”以及失败邮件的**“历史**记录”详细信息中，均显示相同的建议。通知和提醒

向每位客户发送其语言版本的电子邮件，通过描述来构建版面布局，从此再也不会遗漏任何修改。

• **使用客户语言发送邮件。**您可以为任何版面添加翻译内容（无论是原文还是通过 AI 翻译的版本），并通过页面标题旁边的语言选择器在不同语言版本之间切换。在“发送交易邮件”操作中，将“语言”字段设置为 {{order.customerLocale}}，每位客户即可收到对应的语言版本。用客户的语言发送电子邮件
• **一种布局，适配所有语言。**新的{{ language }}变量存储了发送邮件所使用的语言，因此只需一个布局，即可向德国客户显示一段内容，向其他所有客户显示另一段内容，而无需进行全文翻译。在布局的语言之间切换时，编辑器界面保持不变，仅内容发生变化。用客户的语言发送电子邮件
• **按工作流程设置“回复至”和“发件人姓名”。**直接从 Shopify Flow 步骤将回复发送至您的支持收件箱，并显示与邮件内容相符的发件人姓名。“回复至”和“发件人”名称
• **订单项表。**一个新模块列出了订单中的产品，包括图片、数量、价格和总计。Shopify Flow变量卡片会为您自动生成Shopify Flow循环。订单项表
• **来自链接的附件。**从 Shopify Flow 数据中的 URL 附加发票或票据的 PDF 文件；该文件将在发送邮件时自动获取。附件和图片
• **版本历史记录。**每次保存的布局都会被保留。只需点击一下，即可预览早期版本并将其恢复。版式版本历史
• **GitHub 上提供无限版本历史记录。**连接一个代码库后，您布局的每个版本都会提交到该代码库中。在 GitHub 上编辑布局文件，应用会自动同步更新。在 GitHub 上保留无限的布局历史记录
• **利用人工智能进行创建、编辑和翻译。**连接您自己的 Claude、OpenAI、Gemini 或 OpenRouter 密钥，从服务提供商提供的模型中进行选择，并描述您想要的电子邮件内容。使用人工智能创建、编辑和翻译版式
• **通过您的 AI 助手构建布局。**开发者 API 和 MCP 服务器现可创建和更新电子邮件布局、翻译及版本，因此助手可以为您构建布局。连接人工智能助手（MCP）
• **一款更快、更简洁的应用程序。**所有页面均已迁移至Shopify的新Web组件，这些组件正是Shopify管理后台本身所使用的构建模块。 页面加载速度更快，并遵循管理后台的既定模式：首页提供设置指南，所有列表均支持统一的筛选和搜索功能，且在您正在编辑的表单旁边会显示状态和参考信息。可视化构建器现已支持全屏宽度，并提供桌面和移动端预览功能，还支持撤销和重做操作。
• **“历史记录”中会显示语言信息。**每封邮件的事件记录中都会列出其发送时的语言，您可以按布局和发件人筛选“历史记录”。

在现有工作流程中使用新字段：Shopify Flow 会保留创建该步骤时设置的字段。若要在现有工作流程中获取“语言”、“回复至”和**“发件人姓名**”字段，请删除“发送交易邮件”步骤，然后重新添加该步骤。未进行修改的工作流程将继续按原样运行。

本期内容将探讨那些你无法察觉的故障：某个邮件箱悄无声息地停止了发送；某个版式在预览时一切正常，实际发送时却失败了；以及那些在传输到收件箱的过程中丢失的设计细节。

当某位邮件发件人无法正常发送邮件时，我们会通知您

此前，一旦某个发件人出现故障，通过该发件人发送的所有电子邮件都会失败，历史记录中只会显示一行红色提示。

• 已连接的 Google 和 Microsoft 365 邮箱会自动保持登录状态：该应用会自动刷新其访问权限，因此在正常使用情况下，不会出现过期情况。 当账户本身拒绝续期（您撤销了该应用的访问权限、密码更改导致访问终止，或管理员将其封锁）时，仪表盘会显示一条横幅通知，并且您将收到一封电子邮件（每个发件人每天一封），提示您重新连接。重新连接后，您的发件人列表和Shopify Flow步骤将得以保留。
• 同一条警报涵盖了导致每次发送失败的配置问题，并针对每个问题提供了具体的解决方法：SMTP 用户名或密码错误、邮件服务器屏蔽了我们的发送服务器（我们会指定需要放行的 IP 地址）、 在 SMTP 主机字段中输入了电子邮件地址、端口和加密方式不匹配、Google 账户未关联 Gmail，以及 Microsoft 已暂停的 Outlook 邮箱。
• “测试连接”和“测试发送”现在都在错误旁边显示了相同的修复方案。
• 如果未授予“代表您发送电子邮件”权限，系统会立即拒绝连接 Google 账户并给出说明，而不是连接一个永远无法发送邮件的邮箱。

该提醒功能默认处于开启状态。您可以在“通知”中将其关闭。

现在在编辑器中输入的 Liquid 代码在发送电子邮件时已能正常工作

诸如 {% if variables.total > 5 %} 这样的比较运算符、{{ variables.name | default: "there" }} 这样的带引号过滤器，或者你已部分格式化的标签，在预览中可能看起来正常，但在每次实际发送时都会因出现 expected "|" before filter 而失败。这是因为编辑器以 Liquid 无法识别的方式存储了这些字符。

• 现有布局会自动固定，无需进行任何更改。
• 保存包含真实 Liquid 错误的布局时，系统现在会在您保存时提醒您，而不是等到客户收不到邮件时才提醒。

包含制表符或引号的 Shopify Flow 数据不再会导致您的邮箱清空

如果产品标题或备注中包含制表符或引号（例如 12" vinyl），可能会导致变量（JSON）无法读取，从而导致发送的电子邮件中相关字段显示为空白。

• 这些值现在已正确读取。
• 如果数据仍然无法读取，且您的布局使用了变量，则该操作会失败，并在“历史记录”中显示明确的说明，而不是发送一封信息不完整的电子邮件。

您的电子邮件设计效果与您制作时完全一致

我们对发出的电子邮件进行的安全检查，删除了设计好的电子邮件中的一些必要内容。

• 移动端视口和字符集得以保留，因此电子邮件在手机上能正确缩放。
• 在“品牌设计”中选定的 Google Fonts 现已在支持该功能的电子邮件客户端（如 Apple Mail）中加载。
• 自定义 HTML 中仅适用于 Outlook 的样式将得以保留，即使代码被格式化为多行也不例外。

通过您自己的 SMTP 服务器发送邮件更稳定

• 该应用一次最多会向您的 SMTP 服务器建立两个连接。当服务器繁忙时，Shopify Flow 会在稍后重新尝试发送邮件，而不是因“连接过多”而发送失败。
• 如果邮件服务器在15秒内未作出响应，系统将放弃此次请求并通过Shopify Flow重新尝试，而不是让您的工作流程因此被耽搁数分钟。

隐私

• 根据我们的隐私政策，所有套餐的发送和运行记录均会保留 30 天。
• 应用程序日志存储在欧盟境内，我们已不再使用请求追踪功能。
• 返回至 Shopify Flow 的 HTTP 请求响应均未超过 Shopify Flow 的大小限制。

琐事

• 可视化构建器中各部分的“显示/隐藏”按钮又回来了。
• 富文本编辑器已基于全新的架构进行了重构。工具栏、链接、图片、颜色和大小均保持不变。
• 例行安全维护。无需进行任何操作。

现在，您可以删除已不再需要的已上传徽标、图片和附件。此前，只有在编辑使用该文件的布局时，才能顺带删除该文件，而如果您只是想清理一个旧徽标，这种方式并无帮助。

在应用中

无论在何处插入图片或附件 - - 无论是“品牌设置”中的徽标字段，还是布局中的“插入图片”功能 - - 都会打开媒体选择器。现在，每个文件的角落都设有“删除”按钮。确认后，该文件将从存储中永久删除。

系统会拒绝删除仍在使用的文件，并会告知您该文件正在被什么程序使用

这是刻意设计的。文件选择器允许您将一个上传的文件在任意多个版式中重复使用，因此，如果删除一个仍在被引用的文件，将会悄无声息地导致另一封仍在发送给客户的邮件出现故障。如果某个版式或共享的页眉/页脚预设仍在使用该文件，则删除操作将被拒绝，系统会列出相关文件名称。 请先将该文件从这些布局中移除，然后再进行删除。

任何“anything”或“nothing”都会立即被删除。

适用于 API 和 MCP

• GET /api/v1/files 列出您的文件。添加?usage=true后，每个文件都会报告是否仍有其他地方引用它，这样您就可以通过一次调用找到所有可以安全删除的文件。
• DELETE /api/v1/files 移除一个，并应用相同的在用检查。
• 通过 MCP，AI 助手也可访问 list_files 和 delete_file。您可以要求它查找并删除您未使用的图片，但它不会删除当前仍被活跃邮箱使用的图片。

参见 REST API 参考指南。

此外还修复了

保存布局时，系统曾会清理不再需要的文件，但仅检查其他布局 - - 不检查共享的页眉/页脚预设。仅由某个预设使用的徽标可能会被删除。现在，这两种情况都会进行相同的检查。

您可以通过自己的代码，或通过Claude、Cursor等AI助手来管理您的操作。

开发者 API

• 一个全新的开发者页面，您可以在这里创建 API 密钥，并获取适用于 Claude Code、Claude Desktop、Cursor、VS Code 或 Gemini CLI 的可直接复制的连接命令。
• 一个用于管理 HTTP 请求操作，以及读取您的电子邮件布局、发件人、密钥名称、执行历史记录和统计数据的 REST API。
• 一个 MCP 服务器，这样 AI 助手就能在对话中实现同样的功能 - - 包括为你编写一个新操作，并在其中直接引用你现有的“秘密”名称。
• **共有三个访问级别。**读取权限仅限于查看；写入权限还可执行创建、更新和删除操作；执行权限除上述功能外，还能实际运行已配置的 HTTP 请求，该功能被单独划分为一个级别，因为它会向第三方系统发送实时请求。

这两个接口均通过专用地址 shopify.workflow-transactional-email.app 提供服务，因此您的集成无需依赖该应用的管理员 URL。

**您的凭据将始终保密。**无论在何种访问级别下，密钥值、SMTP 密码和 OAuth 令牌都绝不会通过 API 或 MCP 被读取。助手可以检测到名为 stripeApiKey 的密钥存在，并将其引用为 {{ secrets.stripeApiKey }}，但绝不会看到其具体值。执行历史记录中的个人数据在离开服务器前会经过脱敏处理，不过自由文本字段仍可能包含客户详细信息。

完整文档：开发者 API 和 MCP、身份验证和 API 密钥、REST API 参考指南 和 连接人工智能助手（MCP）。

在富文本编辑器中，链接的操作要简单得多

这两条信息都来自一份商家报告。

• 选中文字即可将其设置为链接。选中任意文字，点击“链接”按钮，该文字即被设置为链接 - - 这样，链接地址就无需在邮件中显示出来。当光标位于现有链接内部时，还会出现“移除链接”选项。
• **电子邮件地址和电话号码现已支持自动处理。**您无需再手动输入协议。输入 hello@yourstore.com 时，系统会将其转换为 mailto 链接；输入 (703) 638-2601 时，系统会自动拨号；输入 yourstore.com 时，系统会将其作为普通网址打开。在您插入内容之前，对话框会提示您该内容将被如何处理。

究竟问题出在哪里，以至于导致了这两个问题：输入时未包含 https:// 的地址会被视为相对于 Shopify 管理页面的相对路径，而非真正的网页地址。这导致了链接失效，因此要获得有效的链接，唯一的方法就是输入完整的 URL - - 而且电子邮件地址根本无法转换为 mailto 链接。现已从根源上修复了该问题。

您现有的布局和已保存的链接均保持不变。

升级后的正确页面

以前升级后会直接跳回仪表盘，没有任何确认提示。现在会显示一个确认页面，不仅会确认更改内容，还会显示新套餐包含哪些服务以及您已使用了多少额度，并指引您进行下一步有用的设置。

视觉构建器中修复了两个格式问题，这两个问题均由一位商家报告。

现在，页眉和页脚文本中可以使用换行符了

• 页脚将打字机输出的<br>作为字面文本打印出来，同时又单独处理了你的回车键，因此屏幕上既出现了一个换行符_，又_多了一个多余的<br>。
• 该标题完全忽略了换行符，将所有内容合并到了一行上。

这两个问题都已修复。按 Enter 键可换行 - - 如果你习惯输入 <br>，这样操作同样有效。此更改将立即应用于你现有的版面布局，无需进行任何修改。

块与块之间的间距

每个块元素的四边_以及_块与块之间的间隙都带有填充，这导致元素之间的间距累积达到约44像素，使得电子邮件看起来布局松散。

间距设置现已拆分，在**“品牌标识”→“布局**”下，除了更名为**“块间距（左右）”的滑块外，还新增了“块间距（上下）**”滑块。每个间距控制项现在都会说明其实际功能。

• **现有布局保持不变。**它们将完全保留当前的间距，因此您已经调整过的邮件内容不会发生任何位移。若需收紧布局，请拖动新滑块 - - 将间距调整至约4px效果最佳。
• 新布局默认间距较紧：块与块之间的间距约为 20px，而不是 44px。

本次发布的核心只有一个：在_客户指出邮件有问题_之前，先确保邮件内容无误。

预览文本

• 现在每个版面都设有一个**“预览”文本**框 - - 这是电子邮件客户端在收件箱中主题旁边显示的那一行文字。如果留空，客户端会自动提取邮件开头的任意文字，通常是“在浏览器中查看”。
• 支持与主题相同的{{ variables.xxx }}，因此可以包含交货日期或订单号。
• 描述现在已说明其真实用途：这是一条仅你可见的内部备注。此前，有几位商家曾在此处撰写面向客户的文案。

参见 主题行和预览文本。

当某个变量显示为空时，系统现在会向您发出警告

模板的渲染故意设计得比较宽松，因此变量错误或缺失绝不会导致客户的邮件发送失败。但代价是这会产生一个_“无声的空白_”：发送成功，历史记录显示为绿色，只有收件人才能察觉到这一缺失。

• 当占位符未产生任何结果时，该发送操作现在会在“历史记录”中标记为**“空变量**”。
• 打开它会明确指出具体是哪些，并将两个截然不同的问题区分开来：由 Shopify Flow 发送但内容为空（属性路径错误）与完全未由 Shopify Flow 发送（在您的 JSON 中缺失）。
• 这也适用于 HTTP 请求。

“变量（JSON）”现已为您生成

手动编写该JSON是导致支持工单数量激增的唯一主要原因。

• 每个布局都配有一张**“在Shopify Flow中使用**”卡片，其中包含可直接粘贴到Shopify Flow操作中的精确JSON代码，所有键名均已设置正确。点击一个按钮即可复制该代码。
• 常用字段已预填 - - 客户姓名、订单名称、订单总额、状态页面网址。
• 如果某个变量看起来像是订单项数据，系统会向您发出警告：一个订单包含多个订单项，因此 {{ order.lineItems.variant.title }} 不会返回任何结果，需要使用循环。这是变量为空的最常见原因。
• “测试变量”现在明确说明，它们仅影响预览和测试发送 - - 实际运行的Shopify Flow会忽略它们。

参见 从Shopify Flow传递数据。

你可以再次删除这些内容

只要Shopify Flow步骤引用了布局、发件人、SMTP服务器、HTTP请求、密钥和预设，它们就无法被删除。

问题在于：该引用会一直保留到应用被卸载为止，因此它往往是用户已经删除或重建的工作流程中遗留下的 - - 而系统无法区分这两者。商家因此被这些无法删除的记录所困扰。

• 删除操作不再被阻止。系统会告知您哪些对象仍引用该项，由您自行决定。
• 如果某个Shopify Flow步骤指向已被删除的对象，现在会显示一条清晰的错误消息并记录在“历史记录”中，而不是在执行前就被阻止。
• 已上传的文件是唯一的例外：同一个文件可以在不同布局间共享，因此该检查项仍保留。

在负载下更稳定

• 在操作端点中添加了按商店的访问控制和自动缩放功能，因此，即使某个工作流程以突发方式触发，也不会再拖慢其他所有工作流程的运行速度。
• 现在，当Shopify Flow处于忙碌状态时，该应用会向其返回正确的信号，因此Shopify Flow会控制重试频率，而不是频繁发送请求 - - 不会丢失任何数据。
• 现在，当达到套餐限额时，系统会直接返回一个明确、最终的答复，而不是持续数小时地反复尝试。

琐事

• 在富文本/HTML编辑器中**“插入图片 → 粘贴链接**”功能已修复：现在增加了“取消”按钮，按 Enter 键可插入，按 Esc 键可退出，且在输入任何内容之前，“插入”按钮处于禁用状态。粘贴纯文本 cdn.example.com/logo.png 即可生效 - - 系统会自动为您添加 https://。
• 该设置指南现采用 Shopify Flow 操作的实际名称：“发送事务性电子邮件”和**“HTTP 请求**”。
• 例行安全维护：对整个应用程序的依赖项进行了更新，其中包括一项关键级和三项高严重性安全公告。无需进行任何操作。
• 新文档：安装与设置、电子邮件送达率（为何成功发送的邮件仍可能被归入垃圾邮件）、得力助手和人工智能助手 以及 数据、隐私与安全。

寻求帮助不再意味着要四处寻找电子邮箱地址。

应用内聊天，每页都有

• 现在，对话气泡在应用的任何地方都可用，而不仅仅是在仪表盘中。无论您身处何处 - - 无论是正在构建布局的过程中，还是在“历史记录”中盯着一个失败的操作 - - 都可以随时发起对话。
• 我们已经知道您是谁了。您的商店、套餐和联系方式会自动显示，因此您无需说明这封邮件是从哪家商店发出的。
• 它会自动让开。每当对话框打开时，以及您在使用可视化邮件编辑器时，该气泡都会自动隐藏，因此绝不会遮挡“保存”按钮。

新的文档网站：docs.workflow-transactional-email.app

• 针对三种发件人类型（您自己的 使用自定义 SMTP 服务器从 Shopify Flow 发送电子邮件、使用 Microsoft 365 从 Shopify Flow 发送电子邮件 以及 使用 Google 从 Shopify Flow 发送电子邮件）提供的完整设置分步指南，附带视频教程。
• 一份完整的《设计电子邮件版面》参考指南，涵盖可视化构建器中的每个模块、品牌设置以及富文本/HTML模式。
• 变量与液体 - 完整的模板参考文档，包括循环、条件语句，以及为什么同一对象在电子邮件中和在 HTTP 请求中的渲染效果会有所不同。
• 通过 Shopify Flow 发起一个 HTTP 请求 - 一个完整的 Airtable 示例（附视频），演示了如何在任何 Shopify 套餐中通过 Shopify Flow 调用外部 API。
• 电子邮件发件人概览、附件和图片、页眉和页脚预设、秘密、通知和提醒 和 套餐与使用情况 的新页面。
• 历史与故障排除 以及一篇常见问题，介绍了我们实际被问及的故障情况。

全新帮助中心 - - 您可以通过专用的表单直接向我们提交错误报告、提出功能请求或联系我们，并附上屏幕截图。应用中的**“帮助**”页面现已直接链接至所有这些功能。

docs.flow-action-extensions.app 上的旧文档已完整迁移过来，因此您之前收藏的任何内容都没有丢失 - - 只是现在以新名称呈现了。

**Flow Transactional Email 现已更名为 Workflow Transactional Email。**应用、安装方式、发件人和模板均保持不变 - - 仅更名为新名称，以与我们其他工作流程系列产品保持一致。

您这边无需进行任何操作。您的 Shopify Flow 工作流程将照常运行，无需任何调整。

有一点值得注意：微软和谷歌的同意界面上可能仍会显示其旧名称“Shopify Flow Action Extensions”。这是正常现象，可以放心批准。

向Shopify的Sidekick咨询您的电子邮件

Sidekick 现在可以直接回答有关此应用的问题。您可以询问诸如“已设置哪些邮件发件人”、“本周是否有邮件发送失败”、“我是否有针对 Airtable 的 HTTP 请求”，或者“为什么我上次发送失败”等问题。

只读 - Sidekick 可以查看您的模板、发件人、请求和历史记录，但无法进行任何修改。它绝不会返回密钥值、SMTP 密码、OAuth 令牌或消息内容。

常规安全维护：更新依赖项并加强整个应用程序的安全防护。无需采取任何操作。

此通行证包含以下功能：商家配置的出站请求在建立连接前会与内部和私有网络地址进行比对，且渲染后的电子邮件 HTML 内容在发送前会经过净化处理。

• **页眉和页脚预设。**只需设计一次带有品牌标识的页眉和页脚，即可在所有电子邮件布局中重复使用。修改预设后，所有使用该预设的模板都会自动更新 - - 因此，无论是更换新徽标还是更新公司地址，只需一次修改，而非二十次。
• 页眉布局包括仅显示徽标、徽标加标语以及徽标加导航链接等多种形式。页脚包含13个平台的社交媒体图标、自定义法律声明、版权信息和退订选项。
• **自定义字体。**上传您品牌的标题和正文字体后，它们就会与系统内置字体和谷歌字体一起显示在页面编辑器的字体选择器中。
• 现在，在列表中可以一目了然地查看邮件布局的类型，因此无需打开邮件，即可区分视觉化布局和HTML布局。
• 修复了移动端媒体选择卡渲染不均匀以及文件名被截断的问题。
• 修复了文件选择器中加载文件时偶尔出现的故障，该故障会导致页面显示“加载文件失败”，直到页面重新加载后才会消失。

媒体库

• 应用中每张图片和文件均配有一个专属选择器，支持搜索、类型筛选和排序功能。只需上传一次您的徽标，即可在所有模板和模块中重复使用。
• 上传文件现在会直接保存到存储空间，而不是通过应用程序，因此大文件不再导致页面卡顿。
• 存储使用情况进度条会显示您已使用了套餐配额中的多少。

那些可能导致系统出现故障的删除操作

如果删除Shopify Flow步骤仍指向的模板、发件人、SMTP服务器或密钥，以往会导致该工作流程在不知不觉中出现故障 - - 它会继续运行，但始终失败。

• 现在每次删除操作都会先检查引用。如果该对象正在被使用，则删除操作会被阻止，并且应用会明确告知你需要更新哪些内容。
• 文件的检查方式相同，因此从一个模板中删除一张图片，不会导致重用该图片的另一个模板出现问题。

此外

• 各商店的附件存储上限，当达到上限时会显示清晰提示。
• 每次读取加密凭据时的一条访问路径。

自发布以来的最大变化：您完全不需要SMTP凭据了。

已关联的账户

• 现在只需点击一次，即可通过**“邮件发件人”→“已连接的账户**”将 Microsoft 365 和 Google 进行连接。只需登录一次，批准访问权限，即可代表该邮箱发送邮件。令牌会在后台自动刷新。
• 不仅涵盖您自己的收件箱：还包括 Microsoft 的共享邮箱和群组邮箱，以及 Google 的“以…身份发送邮件”别名，每种类型都会显示相应的图标。
• 在将邮箱连接到工作流程之前，请通过“邮件发件人”页面**发送测试邮件，**以确认该邮箱是否正常工作。

为何这很重要：应用程序密码和存储的 SMTP 凭据存在安全隐患 - - 它们会过期、需要轮换，而且存储在数据库中。OAuth 可以解决这三个问题，而且通过您自己的邮件服务商发送的邮件将继承您自己域名的信誉。

一种新型附件系统

• 附件现在不仅在可视化布局中可用，在纯文本和HTML布局中同样可用。
• 模板中所有文件的总大小不得超过 20 MB。超过此限额的部分将自动以下载链接的形式显示在邮件页脚中，而非作为内嵌附件。

对每个界面都进行了适配，以符合Shopify的“专为Shopify打造”标准，因此该应用的行为方式与您管理系统的其他部分保持一致。

• **未保存的更改受到保护。**现在，每个表单都使用Shopify的原生保存栏。当您在有待编辑的内容时离开当前页面或切换标签页时，系统会先向您提示，而不是默默丢弃您的工作。
• 全站采用原生返回导航，因此浏览器和管理后台的“返回”按钮都能按预期跳转。
• 在确认操作时始终使用提示框，在验证时始终使用内联错误提示，而不是使用会分散注意力的横幅提示。
• “严重”（红色）样式现仅用于提示真正的错误和破坏性操作，因此红色标记始终意味着确实出了问题。
• 重新设计的仪表盘，包含指标卡片、日期范围选择器以及事件图表。

该应用现已迁移至一个新的欧洲云平台。您的使用方式没有任何变化，但在后台：

• 数据库和缓存均位于欧盟境内，并采用静态加密。
• 您的凭据 - - SMTP 密码、OAuth 令牌和密钥 - - 现在除了磁盘级加密外，还会通过专用的密钥管理服务进行单独加密。绝不会存储明文。
• 跨可用区部署冗余实例，并可在负载变化时自动进行扩展。
• 操作执行速度更快，且在大量工作流程同时触发时表现更佳。

• 富文本编辑 - - 使用常规格式工具栏编写邮件正文，而非直接输入原始 HTML 代码；当需要完全控制时，可随时切换至 HTML 模式。
• 应用内聊天 - - 无需费心查找邮箱地址，即可在应用内直接联系我们。
• 修复了 Liquid 渲染中某些值未被正确替换的边界情况。
• 修复了保存正文为空的 HTTP 请求的问题，此前对于那些合法地不接受正文的端点，该操作会失败。
• 改进了高负载下 HTTP 请求的处理方式，因此 Shopify Flow 的突发请求不再导致其后方的队列变慢。

手动编写 HTML 并不是设计电子邮件的好方法。所以现在您不必再这么做了。

可视化电子邮件编辑器

• 使用模块（标题、文本、图片、按钮、分隔线和间距）构建布局，并实时查看其在设置面板旁的效果。
• 布局模块：将图片放置在文本旁边，或将一行拆分为两列，并可自定义列宽和间距。
• 关于颜色、字体、间距和内容宽度的品牌设置将应用于整封电子邮件。
• 测试变量可让您在发送任何内容之前，使用真实数据预览设计效果。

进出口

• 导出任何电子邮件模板，并将其导入到另一家商店中。这对于在多个客户项目中采用统一设计的代理机构非常有用，也能为您花费大量时间精心设计的版式保留一份备份。

首个版本。Shopify Flow 可以在 Shopify 内部实现大量自动化操作，但无法与外部交互 - - 此版本新增了两个能够实现这一功能的操作。

• 发送交易邮件 - - 通过您自己的 SMTP 服务器发送带有品牌标识的邮件。支持 Gmail、SendGrid、Mailgun、Amazon SES 或您自己的邮件服务器。
• **HTTP **请求 - - 调用任何外部 API、Webhook 或服务。支持 GET、POST、PUT、PATCH 和 DELETE 方法，可使用自定义头部和 JSON 正文。适用于所有 Shopify 套餐，包括 Basic 套餐（该套餐中无法使用 Shopify 自带的 HTTP 操作）。
• Secrets - - 将 API 密钥、令牌和密码存储一次，即可在任何地方通过 {{ secrets.keyName }} 引用它们。这些信息绝不会在模板、配置或日志中暴露。
• Liquid 模板化 - - 利用 {{ variables.xxx }} 从 Shopify Flow 数据中生成动态主题、正文、URL 和负载。
• 电子邮件模板 - - 主题和HTML正文可重复使用，因此一种设计即可满足所有客户的需求。
• 事件历史记录 - - 每次执行都会被记录下来，并附有其请求和响应的详细信息，此外，仪表盘上还会显示使用情况、套餐限制和成功率卡片。
• 无Shopify权限 - - 该应用未请求任何访问范围，也从未读取过您的商店数据。