Workflow WebhooksWorkflow Webhooks

如何将 Slack 与 Shopify Flow 连接起来

Slack 会使用您应用的签名密钥，对发送到您应用的每条请求（包括斜杠命令、交互式消息和 Events API 推送）进行签名。Workflow Webhooks 将该调用转换为 Shopify Flow 触发器，以便您的商店能够对此做出响应：标记客户、添加订单备注、发送内部邮件、更新元字段 - - 任何 Shopify Flow 能做的事情。

本指南详细介绍了整个工作流程 - - Slack 发送请求，Workflow Webhooks 接收并验证，Shopify Flow 执行操作 - - 每个请求都会验证 Slack 的 HMAC 签名，因此只有 Slack 才能启动您的工作流程。

你可以制作什么

  • 让您的团队能够通过 Slack 中的斜杠命令触发 Shopify Flow 工作流程，而无需授予任何人管理员权限。
  • 在 Slack 中批准某项内容后，让 Shopify Flow 为该已批准的订单或客户添加标签。
  • 将 Slack 快捷方式转换为商店操作 - - 添加标签、发送电子邮件、更新元字段。

典型的发送事件包括：诸如 /restock 之类的斜杠命令、交互式消息中的按钮点击，以及 Events API 事件。

开始之前

  • Workflow Webhooks 已安装在您的 Shopify 商店中。
  • Shopify Flow 已安装，该应用可从Shopify应用商店免费下载。
  • 一个具有创建 Webhook 权限的 Slack 账户。

步骤 1 - 在 Workflow Webhooks 上创建 Webhook

  1. 打开 Workflow Webhooks -> Webhook -> 创建 Webhook，并为其命名一个在 Shopify Flow 中能认出的名称，例如 Slack events。
  2. 在**“身份验证**”下，选择 HMAC。
  3. 在**“签名提供商**”下，选择 Slack。该应用会自动为您填写标头、算法、已签名负载和重放窗口 - - 无需进行其他配置。
  4. 暂时将“密钥”字段留空，然后点击“保存”。复制页面上显示的 Webhook URL。

有关其他身份验证模式，请参阅 身份验证；有关如何选择哪些字段会传输到 Shopify Flow，请参阅 负载映射和流变量。

步骤 2 - 在 Slack 中添加端点

在您的 Slack 应用配置中，将该 URL 添加为斜杠命令、交互功能或事件 API 的“请求 URL”，并从**“基本信息”→“应用凭据”中复制“签名密钥**”。

如何查找您的 Slack 签名密钥

Slack 应用的签名密钥（基本信息 -> 应用凭据）。

Slack 关于 Webhook 签名的官方文档 中，提供了您账户的具体措辞和截图。

将该密钥粘贴到 Workflow Webhooks 页面中 Webhook 的**“Secret**”字段中，然后保存。从那时起，每条 Slack 消息在到达 Shopify Flow 之前都会经过验证。

此处检查的内容

什么 值
签名头 X-Slack-Signature
签名的位置 前缀v0=之后的标头值
签署了什么 v0:{timestamp}:{body}
签名 HMAC-SHA256，十六进制编码
时间戳 X-Slack-Request-Timestamp 头文件，以 Unix 秒为单位
回放保护 签名时间戳与当前时间相差超过5分钟的请求将被拒绝
秘密 作为纯文本使用。请完全按照发件人显示的内容粘贴

在已签名的负载中，{body} 是原始请求正文（按字节对字节复制），而 {timestamp} 则是上文提到的时间戳。

如果请求未通过上述任何一项检查，则该请求将被401状态拒绝，并记录在历史与故障排除中，且永远不会启动工作流程。

步骤 3 - 构建Shopify Flow工作流程

  1. 在 Shopify Flow 中，创建一个工作流程，并选择“Workflow Webhooks”触发器。
  2. 点击**“记录事件**”，然后从 Slack 发送一个测试事件（或在 Workflow Webhooks 中使用**“发送测试**”功能），以便 Shopify Flow 学习您的数据结构。
  3. 您拥有的每个 Webhook 都会触发同一个 Shopify Flow 触发器，因此请在 Webhook ID 上添加第一个条件，以确保该工作流程仅在 Slack 中运行。该 ID 显示在 Webhook 页面上。
  4. 添加操作 - - 标记客户、添加备注、发送内部邮件、更新元字段。
Shopify Flow
在Shopify Flow中，选择“Select a trigger”（选择触发器），打开Workflow Webhooks（应用触发器），然后选择“Webhook Trigger”（Webhook 触发器）。
一个 Shopify Flow 条件：Webhook ID 等于某个 Webhook 的 ID
每个工作流程的第一步：基于 Webhook ID 的条件，确保工作流程仅针对此 Webhook 运行。
完成的工作流程：Webhook 触发器，基于 Webhook ID 的条件，然后在“True”分支上发送内部邮件
完成的工作流程：触发器，基于 Webhook ID 的条件，然后在“True”分支上执行您的操作。

第 4 步 - - 进行端到端测试

在 Slack 中触发一个真实事件。在“Workflow Webhooks”→“History”中，您应该能看到状态为“Success”的调用记录。如果签名有误，您会看到一条显示失败原因的记录；验证已签名的 Webhook 介绍了签名测试工具，该工具会精确显示哪个步骤失败了。

“History”中打开了一个调用，其中包含其请求头、负载、状态、持续时间和标识符
“History”中的已交付事件：状态为“Success”表示 Shopify Flow 已接受该事件。
签名不匹配▾

按以下顺序：密钥（最常见的原因 - - 多余的空格，或来自错误环境的密钥）、发送方是否使用了其他端点的密钥，以及Slack与应用之间是否存在任何会重写正文的内容。签名涵盖原始字节，因此会重新格式化JSON的代理会破坏签名。 Webhook 页面上的签名测试工具会显示被签名的确切文本内容。

每次请求都会返回401错误▾

请确认 Webhook 的身份验证方式已设置为 HMAC 且已选择 Slack 提供商，密钥已填写，并且 Slack 发送到该 URL 的内容与应用中显示的完全一致，包括末尾的代码。

“历史”中未显示任何内容▾

该请求从未送达。请在 Slack 中重新检查 URL，并查看 Slack 自身的投递日志以了解其收到的响应。如果出现 404，则表示 Webhook 错误或已被删除；如果出现 429，则表示您已超出套餐的调用限制 - - 请参阅 套餐与使用情况。

工作流程针对错误的事件运行▾

您商店中的每个 Webhook 都会触发同一个 Shopify Flow 触发器。请在工作流程的第一步中添加一个基于 Webhook ID 的条件，或者缩小从 Slack 发送的事件范围。

请求失败，错误信息为“时间戳超出容差范围”▾

Slack 会对事件戳进行签名，且该应用会拒绝任何超过 5 分钟的事件。这通常是发送方的时间同步问题，或者 Slack 在很久之后使用原始时间戳重试了该事件。来自同一原始请求的重试将无法通过；请让 Slack 发送一个新的事件。

相关