更新日志

这款应用支持您的语言

现在，整个应用将根据您在Shopify管理后台中使用的语言进行显示。支持英语、德语、法语、西班牙语、意大利语、荷兰语、丹麦语、葡萄牙语（巴西和葡萄牙）、日语以及中文（简体和繁体）。更改管理后台语言后，应用将在下次页面加载时自动同步。

• 每个页面、对话框和消息均已翻译，包括 Webhook 编辑器、签名测试工具及其分步诊断、历史记录和帮助页面。
• 在Shopify Flow中，工作流程模板会以您的语言显示其标题、描述和设置说明。
• 日期和数字的显示方式遵循您所用语言的书写习惯。
• **本帮助中心也已翻译。**每篇指南均提供相同语言版本；请从语言菜单中选择您所需的语言。
• **触发器和操作名称仍保留为英文。**Shopify Flow 显示的步骤名称为英文，因此该应用也是如此 - - 您在应用中看到的名称始终与 Shopify Flow 中显示的名称一致。诸如 fieldOne 等负载字段名称也不会发生变化。

Shopify Flow 中的七个现成工作流程

打开“流程”，选择**“浏览模板**”，然后搜索“Webhook”。每个模板都是基于 Webhook 触发器的完整工作流程；您只需创建该 Webhook，并将您的系统指向它即可。

• 接收 Webhook 时的订单状态 - - 第三方物流（3PL）、ERP 或无代码工具将订单标记为“已发货”、“已开票”或“已审核”。
• 收到 Webhook 时添加订单备注 - - 将来自支持工具或 ERP 的消息附加到订单备注中。
• 在收到 Webhook 通知时将订单标记为已支付 - - 即您的银行、开票系统或支付系统确认付款后。
• 在收到 Webhook 时为产品添加标签 - - 供应商、PIM 或 ERP 系统会保持产品系列和标签的同步。
• 在收到 Webhook 时创建客户 - - 从落地页和表单中收集潜在客户。
• 在收到 Webhook 时更新客户元字段 - - 忠诚度、CRM 或积分系统会在客户记录中存储一个数字。
• 在收到 Webhook 时返回订单状态 - - 通过同步响应，向聊天机器人、客服系统或客户门户提供订单的支付和发货状态。

每个模板的设置说明中都会注明需要映射哪些字段。请参阅 工作流程模板。

Shopify的新版管理后台设计

Shopify 正在为管理后台推出全新界面。在已启用该功能的商店中，Workflow Webhooks 现采用与管理后台其他部分相同的配色、字体和图标，因此该应用的界面风格与管理后台的其他部分保持一致。在尚未启用该功能的商店中，界面保持不变。

您的 Webhook 现可按定时器运行，验证几乎任何发件人的签名，并支持 JSON 以外的格式。

通过任何 API 按定时器运行工作流程

每个 Webhook 都有一个新的**“计划**”选项卡，并且有一个直接的进入方式：选择**“创建 Webhook**”，并在“什么会触发此 Webhook？”的问题中选择“无 - - 按计划运行”。 该应用每 5 分钟（最多每天一次）会抓取一个 URL，并将响应发送至 Webhook，因此任何 API 均可通过 Shopify Flow 工作流程按计划运行。

• 每次获取数据时触发，还是仅在响应发生变化时触发？
• 如果 API 需要请求头，请添加。这些请求头将以加密形式存储。
• “立即运行”会执行一次请求，并向您显示响应结果。
• 该选项卡显示日程安排与您的计划相比的情况。跑步记录在“历史记录”中显示为**“已安排”**。
• 一个连续失败20次的计划会自动暂停。

参见 定时URL轮询。

针对几乎所有发件人的签名验证

22 个内置预设（从 6 个增加至 22 个），每个预设均根据发送方自身的文档进行了核对：Stripe、GitHub、Shopify、Slack、Typeform、Calendly、标准 Webhook（OpenAI、Supabase）， Svix（Clerk、Resend）、Paddle、Linear、WooCommerce、Square、Sentry、Vercel、Zendesk、Lemon Squeezy、Razorpay、Paystack、Customer.io、Sendcloud、Mollie 和 Sanity。

• 对于未预设签名的发件人，可使用自定义签名：选择签名头、算法、编码方式、具有重放保护的时间戳，以及待签名的确切文本。
• 编辑器中的签名测试工具会显示哪个验证步骤失败，并能生成一个有效的示例请求。
• 创建 Webhook 时，首先要确定将向其发送什么内容。

请参阅 验证已签名的 Webhook，其中为每位发件人提供了分步指南。

更多身份验证方式

• 对于无法设置自定义标头的发送方，静态令牌现在可以以 Bearer 令牌、基本认证（用户名和密码）或 URL 参数的形式传入。URL 中的令牌在“历史记录”中会被屏蔽，且绝不会传递给 Shopify Flow。
• **在不影响服务的情况下轮换密钥。**对于静态令牌和所有签名方案，系统都会同时接受第一个密钥和第二个密钥。
• **IP 白名单。**在任何身份验证的基础上，将能够访问该 URL 的用户限制为列表中列出的地址或地址范围。参见 IP白名单。

参见 身份验证。

表单和XML正文，以及数组拆分

• 表单提交、文件上传表单和 XML 现可像 JSON 一样被读取到可映射字段中。符合 JSON 格式的表单正文仍会被作为 JSON 读取，因此现有发送方的行为不会发生改变。
• **将数组拆分为多个运行。**将新设置指向负载中的一个列表，每个项目都会启动自己的 Shopify Flow 运行，每个请求最多 100 个。每个项目都算作一次调用。

参见 正文格式和数组拆分。

一款基于Shopify的Web组件重新构建的、运行更流畅的应用程序

现在，整个应用直接运行在Shopify管理后台的Web组件上，而非依赖于独立的界面库。由于需要加载的内容减少了，页面加载速度更快，而且每个字段、菜单和对话框的外观及行为都与管理后台的其他部分保持一致。

• Webhook 编辑器是一个构建器。左侧是设置；右侧是包含 Webhook URL 和 Webhook ID 的“端点”卡片，上方则是“实时预览”、“测试”和“使用情况” - - 因此，您可以一边修改设置，一边在并排的视图中观察请求的到达。
• Webhook 列表显示了每个 Webhook 的调用次数、调用者的身份验证方式以及最后一次修改时间，每行都配有一个菜单，可用于编辑、启用、禁用或删除该 Webhook。
• **连接经过签名的发送方。**针对 Stripe、GitHub 或其他提供商的 Webhook 会显示连接步骤以及一个跳转至其设置指南的按钮，而不是一个永远无法通过验证的示例请求。

本版本还包含以下内容

• **仪表盘上的被拦截请求。**此前，因套餐限额而被拒绝的请求不会留下任何记录。现在，仪表盘会显示过去 30 天内被拦截的请求数量，而套餐卡则充当了使用量计数器。
• Webhook 列表中的分页功能已正常工作，且“历史记录”中的**“清除全部**”操作也会清除“已重播”筛选条件。
• 每个页面都链接到了帮助中心中的相应指南，而“帮助”页面则列出了我们为Shopify Flow开发的其他应用。
• 例行安全维护。无需进行任何操作。

此前，Webhook 只能确认收到请求 - - 你的 Shopify Flow 工作流程会在之后运行，而调用方永远无法得知结果。同步响应改变了这一情况：应用程序会保持请求处于打开状态，直到你的工作流程将数据发回，然后将其返回给调用方。

当调用方需要结果而非回执时，此功能非常有用 - - 例如显示结果的表单、等待计算结果的系统，以及查询操作。

工作原理

在 Webhook 的“高级设置”中启用**“同步响应**”。然后基于新的**“同步 Webhook 触发器**”构建工作流程，并使用新的**“返回 Webhook 响应**”操作结束该工作流程。

使用触发器的变量，将响应正文直接写入操作中：

{"ok": true, "orderId": "{{fieldOne}}", "email": "{{fieldTwo}}"}

或者在“运行代码”操作中构建一个更复杂的程序，并将结果绑定上去。

典型的往返时间是2到4秒。如果您的工作流程在15秒内未作出响应，呼叫方只会收到常规响应 - - 绝不会出现错误，也不会出现挂断情况。

完整指南：同步响应：

除非你打开它，否则什么都不会改变

所有 Webhook 默认处于关闭状态。现有 Webhook 仍会立即响应，并继续使用标准的 Webhook 触发器，与之前完全一致。

REST API 和 MCP 服务器现在有了自己的永久托管地：

https://shopify.workflow-webhooks.app

因此，API 位于 https://shopify.workflow-webhooks.app/api/v1，MCP 服务器位于 https://shopify.workflow-webhooks.app/api/mcp。两者在**“开发者**”页面上均显示有一个“复制”按钮。

此前，这些内容位于应用的嵌入式 URL 中。将它们分离出来后，您粘贴到脚本、CI 任务或 AI 助手中的地址将保持稳定，且与应用在您的管理后台中的嵌入方式无关。新的主机名仅用于提供 API 服务 - - 应用本身仍保留在原位置，您已配置的内容无需进行任何更改。

更多文档

docs.workflow-Webhooks.app 上已发布九个新页面：

• 创建你的第一个 Webhook - - 端到端操作，包括配置 Shopify Flow 端
• 身份验证 - - 静态令牌、HMAC，以及适用于 Stripe、GitHub、Shopify、Slack、Typeform 和 Calendly 的预设
• 负载映射与流变量 - - 点路径、嵌套值，以及当四个字段不够用时该怎么办
• 重复配送防护
• 历史与故障排除 - - 所有拒绝代码及其应对措施
• 从 Shopify Flow 调用 Webhook
• 套餐与使用情况 - - 哪些计入流量上限，哪些不计入
• 得力助手和人工智能助手
• 常见问题

《开发者 API 和 MCP 指南》也已发布。

大多数系统在未收到快速响应时会重试 Webhook。如果第一次尝试确实已送达，那么您的 Shopify Flow 工作流程将针对同一事件运行两次 - - 发送第二封电子邮件、添加第二个标签，以及生成重复的订单备注。

**“重复投递防护”**功能可解决此问题。如果您的发送系统为每个事件分配了一个唯一标识符，请告知我们该标识符位于哪个请求头中，我们将忽略重复的投递。

在**“高级设置”->“任何 Webhook 触发时重复发送**”下进行设置。输入发件人使用的标头名称 - - 通常为 Event-Id、Idempotency-Key 或 X-Request-Id。

• 具有给定 ID 的第一个请求运行正常。
• 如果在24小时内再次发送，将收到标准的200 OK响应，因此发件人会停止发送 正在重试 - - 但不会再次发送至 Shopify Flow。
• 被屏蔽的重复项不计入您的套餐限额。
• 你仍然可以看到它们：“实时请求检查器”会显示该请求，并将其标记为一个 隐藏了重复项，因此看起来该调用从未消失过。

将该字段留空，则一切保持不变 - - 每个请求都会像以前一样被处理。此功能在所有现有 Webhook 中默认处于关闭状态。

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

• 全新开发者页面：创建范围限定 API 密钥，并获取适用于 Claude Code、Claude Desktop、Cursor、VS Code、Gemini CLI 和 OpenAI Codex 的可直接复制连接命令。
• /api/v1 上的 REST API - - 列出和管理 Webhook、读取调用历史记录和统计信息、列出模板。
• MCP 服务器位于 /api/mcp，因此 AI 助手可以在对话中实现相同的功能。
• **三种访问级别。**读取密钥仅可查看数据；写入密钥除可查看外，还可创建、更新和删除 Webhook；执行密钥除上述功能外，还可触发测试调用或重放过去的调用 - - 这确实能运行您的 Shopify Flow 工作流程。
• **您的数据始终受到保护。**Webhook 的授权令牌绝不会通过 API 被读取，且请求负载中的个人数据（电子邮箱地址、电话号码、姓名、卡号）在离开服务器之前就会被屏蔽。

**Flow Webhooks 现已更名为 Workflow Webhooks。**应用、安装方式和 Webhook 均保持不变 - - 只是更名了，以与我们工作流程系列的其他产品保持一致。

• 新的文档网站位于 docs.workflow-webhooks.app，其中包含 n8n、Make 和 Zapier 的完整操作指南，包括视频教程。
• 全新帮助中心 - - 您可以通过专用表单直接向我们提交错误报告、提出功能请求或联系我们，并请附上屏幕截图。
• 应用内聊天 - - 现在，聊天气泡会出现在应用的每一页上，当对话框打开时，它会礼貌地让出空间。
• 仪表盘上的设置指南，将引导您从第一个 Webhook 开始，直至成功搭建一个可运行的 Shopify Flow 工作流程。它会记住您是否将其折叠起来。

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

• 电子邮件通知 - - 当您接近套餐限额、达到限额，以及 Webhook 失败次数超过平时水平时，系统会向您发送提醒。除商店所有者外，还可添加其他收件人，每位收件人都有独立的退订链接。
• HMAC 签名预设 - - 无需手动配置格式，即可匹配常见发件人的签名方案。
• 选择接收更多请求数据 - - 针对每个 Webhook，选择是否将请求头、查询字符串参数和原始请求正文传递给 Shopify Flow。
• 按负载内容搜索调用历史记录。

Sidekick 现在可以直接回答关于此应用的问题。你可以询问诸如“我的联系表单是否有 Webhook”、“我的 n8n Webhook 是否已启用”、“本周它触发了多少次”或“为什么我上次的调用失败了”等问题。

只读 - Sidekick 可以查看您的 Webhook、其配置及其调用记录，但无法进行任何修改。

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

• Webhook 处理已迁移至一个带有死信处理功能的托管队列，因此调用绝不会被无声丢弃。
• 数据库和缓存均位于欧盟境内，且采用静态加密。
• 商家机密（即您的静态令牌和 HMAC 密钥）现在由专用的密钥管理服务进行加密，而不仅仅是在磁盘层面上以加密形式存储。
• 跨可用区的高可用性实例。

其结果是，Webhook接收时的延迟降低，且在高负载下的表现大幅提升。

• 自定义静态令牌标头 - - 令牌标头不再必须为X-Api-Key。您可以在“高级设置”中为每个 Webhook 设置自定义名称，以匹配发送系统当前发送的名称。出于安全考虑，系统会拒绝预留的以及由代理控制的标头名称。
• 自动会话刷新 - - 访问令牌现已在后台进行刷新，因此长时间运行的商店不再会因令牌过期而导致配送失败。
• 更智能的重试机制 - - 对投递失败的情况采用退避策略进行重试，而对于永久性失败的情况，则会立即停止重试，而非无谓地消耗重试次数。

• 添加了数据库索引，以加快繁忙商店的历史记录和统计查询速度。
• 新增了真实用户性能监控功能，以便我们在管理后台及时发现加载缓慢的页面。
• 应用范围内的安全检查：更新依赖项并移除不安全的 HTML 渲染功能。

• 围绕指标卡片、日期范围选择器和调用次数图表，重新构建了仪表盘。
• **未保存的更改现已受到保护。**编辑 Webhook 时会显示 Shopify 的保存栏；当有待保存的编辑内容时，切换标签页或点击“返回”按钮会先弹出提示，而不是直接丢弃这些更改。

已重新索引 Webhook 历史记录。调用量较大的商店将发现，历史记录页面和仪表盘的加载速度显著提升。

• 重放 - - 只需单击一下，即可打开任何历史调用并再次发送。这是搭建 Shopify Flow 工作流程最快捷的方式：在 Shopify Flow 中记录事件，然后重放真实的调用，而无需重新触发源系统。
• **Webhook **模板 - - 针对 n8n、Make、Zapier、联系表单和自定义集成的预配置起点。

• 修复了一个可能导致有效请求被拒绝的身份验证边界情况。
• 修复了代理路径解析问题，确保应用代理 URL 能正确路由。
• 修复了 Webhook 列表中的显示错误。

• Shopify Flow 操作 - - 反向操作。Shopify Flow 工作流程现在可以将 Webhook 作为操作步骤进行调用，因此 Shopify Flow 不仅可以由 Webhook 触发，还可以将数据推送至 Webhook。
• 仪表盘统计数据 - - 调用总数、成功率以及您所选日期范围内的图表。
• 调用来源追踪 - - 历史记录现可显示调用源自 Shopify Flow、测试、curl 还是外部系统，并且您可以据此进行筛选。

Shopify Flow 由于变量是扁平字符串，因此过去嵌套的对象和数组往往无法使用。

现在，系统会自动检测为对象或数组的值，并将它们作为 JSON 字符串传递给 Shopify Flow，因此数据在输入过程中不会被悄无声息地丢失。

推出了包含每月调用配额的套餐，并在仪表盘上增加了使用情况跟踪功能，以便您随时查看当前使用情况与配额限额的对比情况。

每个套餐均包含所有身份验证方法、字段映射、CORS、历史记录和重放功能 - - 各套餐的区别仅在于每月流量配额。

• 应用代理端点 - - 现在，每个 Webhook 也可以通过 Shopify 格式的应用代理 URL 访问，从而避免了基于浏览器的调用方遇到的跨域问题。
• 历史记录页面上的日期范围筛选功能，这样您就可以直接定位到出现问题的具体日期，而无需滚动页面。

四个映射字段并不总是足够的。在 Webhook 的“安全”设置下启用“允许自定义请求正文”选项后，除了这四个命名字段之外，整个传入的负载都会被传递到 Shopify Flow。

当无法控制发送系统的负载形状时，此方法非常有用。

• Webhook 配置现已缓存，因此接收调用时所需的工作量更少，响应速度也更快。
• 已禁用的 Webhook 在列表中会显示明显的标记，因此一眼就能看出为何某个 Webhook 没有触发。
• 重新设计了 Webhook 详情页，并进行了一系列小幅修复。

首个版本。Shopify Flow 仅响应 Shopify 内的事件 - - 此版本消除了这一限制。

• Webhook 端点 - - 每个 Webhook 都有一个专属的安全 URL，任何外部系统都可以向其发送 POST 请求。
• 三种身份验证模式 - - “无”（用于测试）、X-Api-Key头中的静态令牌，或用于防篡改签名的HMAC SHA256。
• 负载映射 - - 从传入的 JSON 中映射最多四个字段，并在 Shopify Flow 中将其作为 {{fieldOne}} 映射到 {{fieldFour}}。
• 调用历史记录 - - 每次调用都会连同其头部、负载、状态和时间一起被记录下来。
• 支持 CORS - - 启用此功能后，即可直接接收来自浏览器或店面表单的请求。
• Webhook 仪表盘 - - 在同一界面中创建、启用、禁用并批量管理所有端点，并配备一键式令牌生成器。