请先连接您的 Shopify 店铺

ChannelDock 通过店铺的 .myshopify.com 域名识别 webhook。如果该店铺尚未作为销售渠道连接到 ChannelDock，webhook 会被拒绝并返回 No API!。请先在 My Channels 下连接店铺，然后再继续。

Webhook 端点

字段	值
URL	https://channeldock.com/portal/webhook/shopify/orders
Event / topic	Order creation
Format	JSON
API version	Latest（保留 Shopify 默认值）

请精确复制该 URL — 不要带末尾斜杠。ChannelDock 通过 X-Shopify-Shop-Domain 请求头自动将传入调用匹配到您已连接的店铺。

Shopify admin 中的步骤

1 打开 Shopify admin

前往 admin.shopify.com 并登录已连接到 ChannelDock 的店铺。

​2 前往 Settings → Notifications

点击 Settings（左下角），然后点击 Notifications。

​3 打开 Webhooks 部分

在 Notifications 页面上，点击 Webhooks（靠近底部）。然后点击 Create webhook。

4 配置 webhook

按下表准确填写对话框：

设置	选择
Event	Order creation
Format	JSON
URL	https://channeldock.com/portal/webhook/shopify/orders
Webhook API version	保留默认值

5 保存

点击 Save。Shopify 现在会在每笔新订单到来时将其发送到 ChannelDock。

---

可选：添加更多事件

同一 URL 也接受其他订单事件。对您想要的每个事件重复第 4 步，使用相同的 URL 和 JSON 格式。

Order creation

推荐。即时导入新订单。这是实现实时导入所需的唯一事件。

Order payment

可选。如果您只想在订单标记为已付款后再处理，此事件很有用。

---

验证是否有效

1. 在 Shopify 店铺中下一笔测试订单（或使用 webhook 旁 Shopify 的 Send test notification 按钮）。
2. 片刻后，该订单应出现在 ChannelDock 的订单中。

故障排除

您看到的内容	含义 / 修复
No API!	店铺未在 ChannelDock 中连接，或那里的 URL 与店铺的 .myshopify.com 域名不匹配。请在 My Channels 下重新连接。
Shopify 中 webhook 失败 / 非 200	检查 URL 是否精确（无末尾斜杠、使用 https），且格式为 JSON。
订单未出现	ChannelDock 会跳过已有订单。请使用全新测试订单来确认导入。

Webhook 是补充 — 而不是替代 — ChannelDock 的常规同步。如果某个 webhook 被错过，正常的定时同步仍会拾取该订单。