Workflow WebhooksWorkflow Webhooks

Workflow Webhooks 简介

Shopify Flow 虽然功能强大，但它仅对Shopify内部的事件做出响应。Workflow Webhooks 消除了这一限制。它为您提供了一个安全的URL端点，外部系统可以向其发送POST请求 - - 一旦发送，您的Shopify Flow工作流程将立即触发，且传入的有效负载数据将作为可用变量传递进来。

Workflow Webhooks

工作原理

  • 您的外部工具会向您的 Webhook URL 发送一个包含 JSON 负载的 HTTP POST 请求 （例如：姓名、电子邮件、问题）。可与 n8n、Make、Zapier 或任何支持 HTTP 的工具配合使用。
  • Workflow Webhooks 接收请求，验证请求，并记录包含完整标头的请求 以及负载，然后触发关联的Shopify Flow触发器。
  • Shopify Flow 运行您的自动化流程 - - 给客户打上标签、发送电子邮件、更新 元字段 - - 将负载数据用作命名变量（{{fieldOne}}，{{fieldTwo}}， {{fieldThree}}，{{fieldFour}}）。如果您勾选该选项，还可以发送其他数据 “安全” -> 在 Webhook 上**“允许自定义请求正文**”。
  • 一个 Webhook 端点即可驱动任何 Shopify Flow 自动化流程。

完成的工作流程：Webhook 触发器，基于 Webhook ID 的条件，然后在“True”分支上发送内部邮件
向您的 Webhook URL 发送请求将触发一个 Shopify Flow 工作流程。该条件确保仅触发一次 Webhook；而操作则包括 Shopify Flow 所能执行的所有操作。

功能

功能 描述
Shopify Flow 的 Webhook 触发器 可按需启动任何 Shopify Flow 自动化操作的安全 HTTP 端点
变量映射 将负载字段映射到 Shopify Flow 变量，并分别引用为 {{fieldOne}}、{{fieldTwo}} 等。
身份验证 静态令牌（简单）或 HMAC SHA256（防篡改）
调用历史记录 每个请求的完整日志 - - 时间戳、负载、头部和状态码
CORS 支持 启用基于浏览器的或前端集成
自定义请求正文 支持第三方平台的灵活负载结构
Webhook 仪表盘 在一个地方管理、监控和测试所有终端设备
重复数据保护 忽略那些带有你已经见过的事件 ID 的重复交付

身份验证

方法 工作原理 最适合
无 未通过身份验证 仅用于测试，不用于生产环境
静态令牌 ✓ 修复了X-Api-Key标头中的令牌 大多数集成（n8n、Make、Zapier）
HMAC SHA256 使用负载和密钥生成的签名 高安全性或合规性

变量映射

Workflow Webhooks 可让您将传入的 JSON 负载中的字段映射到 Shopify Flow 可用的命名变量。在“高级设置”选项卡中最多可定义 4 个字段名称。如果您勾选**“安全”->“允许自定义请求正文**”，还可以发送其他数据。

应用中的字段 您的负载密钥 Shopify Flow中的引用
字段 1 name {{fieldOne}}
字段 2 email {{fieldTwo}}
字段 3 question {{fieldThree}}
第4栏 other {{fieldFour}}
Shopify Flow 中“Webhook 触发器”的“添加变量”面板，列出了 webhookId 以及 fieldOne 至 fieldFour，并附有来自最近一次请求的示例值
触发器向您的工作流程传递的内容：Webhook ID 以及您映射的四个字段，以下内容展示了最近一次请求的值。

重复配送防护

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

如果您的发送系统为每个事件分配了一个唯一标识符，请在 Webhook 的**“高级设置”→“重复投递检测**”中为该标识符命名，系统将忽略重复的投递。

行为
具有给定 ID 的第一个请求 按常规处理，触发Shopify Flow
请在24小时内重复此操作 200 OK 使用 duplicate: true - 未发送至 Shopify Flow
不同的ID 已正常处理
请求中没有此头 已正常处理

常见的头文件名称：Event-Id、Idempotency-Key、X-Request-Id。匹配时不区分大小写。

bash
# Second call with the same Event-Id is accepted but not re-sent to Flow
curl -X POST https://.../webhook/<short> \
  -H "Content-Type: application/json" \
  -H "Event-Id: evt_12345" \
  -d '{"orderId":"1001"}'

常见用例

  • 当表单通过外部渠道提交时，为Shopify客户添加标签或更新其信息
  • 从 n8n 或 Make 工作流程触发订单或发货操作
  • 当记录发生变更时，将CRM或客服系统中的联系人数据同步到Shopify
  • 当 Zapier 自动化任务完成时，触发一个Shopify Flow
  • 通过前端表单触发自动化操作（已启用 CORS）
  • 用一个统一的 Webhook 管理器取代多个单一功能的集成

分步集成指南

  1. 如何将 n8n 与 Workflow Webhooks 连接起来
  2. 如何将 Make 与 Workflow Webhooks 连接起来
  3. 如何将Zapier与Workflow Webhooks连接起来

商家怎么说

“这款应用让Shopify Flow的实用性提高了5倍。开发者非常容易联系到。” “而且非常有用。” - - SuperFast Startup，葡萄牙

“Shopify Flow 缺失的那一块 - - 只需一个 Shopify Flow 即可支持所有 “您的 Webhook。” - - 森克尔斯，奥地利

“这正是我之前试图通过一堆第三方应用解决的问题。非常 “推荐。” - - Aloha Tinyboards，美国

安装

从Shopify应用商店安装Workflow Webhooks：从应用商店安装：

支持

需要帮助吗？请访问 支持，或在 Shopify 管理员后台的任意页面中使用聊天气泡图标。