创建 Webhook

Webhook 是用于从特定事件检索和存储数据的工具。它们可用于注册 https:// URL，其中的事件数据以 JSON 或 XML 格式存储。Webhook 通常用于以下场景：

下单
更改产品价格
在您离线时，向您的 IM 客户端或寻呼机发送通知
针对数据仓库收集数据
集成您的会计软件
筛选订单项目并通知各个托运人有关订单的信息
在客户卸载应用时从您的数据库中删除客户数据

本页相关主题

受支持的 Webhook 事件

创建 Webhook 时，您可从任何列出的事件中进行选择。例如，如果您想创建在每次订单付款时发送的 Webhook，请选择订单付款。再比如，如果您想创建在每次更新商店属性时发送的 Webhook，请选择 Shop 更新。

列出 Shopify 后台中可用的受支持 Webhook 事件的表格。
类别	活动
购物车	购物车创建购物车更新
结账	结账创建结账删除结账更新
产品系列	产品系列创建产品系列删除产品系列更新
客户	客户短信营销同意更新客户账户设置更新客户创建客户删除客户禁用客户电子邮件营销同意更新客户启用客户群创建客户群删除客户群更新已添加客户标签已删除客户标签客户更新
折扣	折扣创建折扣删除折扣更新
草稿订单	草稿订单创建草稿订单删除草稿订单更新
发货	发货创建发货服务无法完成发货订单发货订单的订单项目已准备好进行取货发货订单已移动发货订单已设为暂停发货订单已重新安排已安排的发货订单已到发货时间发货订单的订单路线规划完成发货订单已取消发货订单取消请求已接受发货订单取消请求已拒绝发货订单取消请求已提交发货订单发货请求已接受发货订单发货请求已拒绝发货订单发货请求已提交发货订单已解除暂停已经为本地配送准备好发货订单商品条目发货订单已合并发货订单已拆分发货更新
库存	库存商品创建库存商品删除库存商品更新库存水平连接库存水平断开连接库存水平更新
地点	地点激活地点创建地点停用地点删除地点商品更新
市场	市场创建市场删除市场更新
订购	订单取消订单创建订单删除订单编辑订单发货订单付款订单风险评估已更改订单更新
产品	产品创建产品删除产品更新
退款	退款创建
Shop	商店更新
法定货币	法定货币交易创建
模板	模板创建模板删除模板发布模板更新
交易	交易创建

创建 Webhook

您随时可以创建 Webhook。Webhook 使用 ID 进行签名，该 ID 由您商店独有的字母和数字组合构成。

步骤：

桌面

在 Shopify 后台中，转至设置 > 通知。
点击 Webhook。
点击 ⊕ 创建 Webhook。
在事件下拉菜单中，选择要用作 Webhook 事件的任何受支持的 Webhook 事件。创建 Webhook 后，您便无法更改 Webhook 事件。
在格式下拉菜单中，选择您希望 Shopify 将此信息发送给您的格式。有 JSON 或 XML 两个选项。
在 URL 字段中，输入要存储数据的 URL。Webhook 无法返回到以下 URL：
- 本地主机
- 以“internal”一词结尾的任何 URL（例如 example.com/internal）
- 来自任何附加到该商店的自定义域名的任何 URL
- “虚假”域名（例如 www.example.com）
- Shopify 域名（例如 shopify.com 和 myshopify.com）
在 Webhook API 版本中，选择您的首选 Webhook 版本。
点击保存。

iPhone

在 Shopify 应用中，点击 ... 按钮，然后点击设置。
在商店设置部分，点击通知。
点击 Webhook。
点击 ⊕ 创建 Webhook。
在事件下拉菜单中，选择要用作 Webhook 事件的任何受支持的 Webhook 事件。创建 Webhook 后，您便无法更改 Webhook 事件。
在格式下拉菜单中，选择您希望 Shopify 将此信息发送给您的格式。有 JSON 或 XML 两个选项。
在 URL 字段中，输入要存储数据的 URL。Webhook 无法返回到以下 URL：
- 本地主机
- 以“internal”一词结尾的任何 URL（例如 example.com/internal）
- 来自任何附加到该商店的自定义域名的任何 URL
- “虚假”域名（例如 www.example.com）
- Shopify 域名（例如 shopify.com 和 myshopify.com）
在 Webhook API 版本中，选择您的首选 Webhook 版本。
轻触保存。

Android

在 Shopify 应用中，点击 ☰ 按钮，然后点击设置。
在商店设置部分，点击通知。
点击 Webhook。
点击 ⊕ 创建 Webhook。
在事件下拉菜单中，选择要用作 Webhook 事件的任何受支持的 Webhook 事件。创建 Webhook 后，您便无法更改 Webhook 事件。
在格式下拉菜单中，选择您希望 Shopify 将此信息发送给您的格式。有 JSON 或 XML 两个选项。
在 URL 字段中，输入要存储数据的 URL。Webhook 无法返回到以下 URL：
- 本地主机
- 以“internal”一词结尾的任何 URL（例如 example.com/internal）
- 来自任何附加到该商店的自定义域名的任何 URL
- “虚假”域名（例如 www.example.com）
- Shopify 域名（例如 shopify.com 和 myshopify.com）
在 Webhook API 版本中，选择您的首选 Webhook 版本。
轻触 ✓。

保存新 Webhook 后，它将显示在 Webhook 页面。

编辑 Webhook

您可以在创建 Webhook 后编辑其配置。但是，您无法修改已选的 Webhook 事件。

步骤：

桌面

在 Shopify 后台中，转至设置 > 通知。
点击 Webhook。
在包含要编辑的 Webhook 的行中，点击 ... > 编辑。
在编辑 Webhook 对话框中，根据需要修改 Webhook。
点击保存。

iPhone

在 Shopify 应用中，点击 ... 按钮，然后点击设置。
在商店设置部分，点击通知。
点击 Webhook。
在包含要编辑的 Webhook 的行中，点击 ... > 编辑。
在编辑 Webhook 对话框中，根据需要修改 Webhook。
轻触保存。

Android

在 Shopify 应用中，点击 ☰ 按钮，然后点击设置。
在商店设置部分，点击通知。
点击 Webhook。
在包含要编辑的 Webhook 的行中，点击 ... > 编辑。
在编辑 Webhook 对话框中，根据需要修改 Webhook。
轻触 ✓。

测试 Webhook

您可以测试 Webhook，确保将您想要的事件信息发送到正确的 URL。

步骤：

桌面

在 Shopify 后台中，转至设置 > 通知。
点击 Webhook。
在包含要测试的 Webhook 的行中，点击 ... > 发送测试。
在为 Webhook 指定的 URL 处，验证通知是否有效。

iPhone

在 Shopify 应用中，点击 ... 按钮，然后点击设置。
在商店设置部分，点击通知。
点击 Webhook。
在包含要测试的 Webhook 的行中，点击 ... > 发送测试。
在为 Webhook 指定的 URL 处，验证通知是否有效。

Android

在 Shopify 应用中，点击 ☰ 按钮，然后点击设置。
在商店设置部分，点击通知。
点击 Webhook。
在包含要测试的 Webhook 的行中，点击 ... > 发送测试。
在为 Webhook 指定的 URL 处，验证通知是否有效。

删除 Webhook

您可以从 Shopify 后台中删除 Webhook。此操作无法撤销。

步骤：

桌面

在 Shopify 后台中，转至设置 > 通知。
点击 Webhook。
在包含要删除的 Webhook 的行中，点击 ... > 删除。

iPhone

在 Shopify 应用中，点击 ... 按钮，然后点击设置。
在商店设置部分，点击通知。
点击 Webhook。
在包含要删除的 Webhook 的行中，点击 ... > 删除。

Android

在 Shopify 应用中，点击 ☰ 按钮，然后点击设置。
在商店设置部分，点击通知。
点击 Webhook。
在包含要删除的 Webhook 的行中，点击 ... > 删除。