# 用 Webhook 向你的系统发送事件

> Webhook 会在店铺发生某件事（例如新订单或库存变化）的那一刻通知你自己的系统。在设置 > Webhook 中添加端点网址，选择事件，发送测试，并查看每次投递及其响应。

帮助中心 / 集成 - 更新于 2026年11月2日

Webhook 会在店铺发生某件事的那一刻，向你选择的网址发送一条消息。例如，新订单可以直接送达你的履约系统，库存变化可以送达你的库存表，新客户可以送达你的 CRM。你的系统无需不停地向 Shoprocket 查询变化。

你需要一个接收消息的地方：你自己服务器上的地址，或能提供地址的工具，例如自动化平台。设置接收端通常是开发者的工作。

## 开始之前

- Webhook 在 **Growth** 及以上套餐中提供。在较低的套餐中，页面会显示哪个套餐包含它。
- 它们属于 **开发者工具** 应用，和 **API 密钥** 在一起。如果侧边栏的 **设置** 下看不到 **Webhook**，请前往 **应用**，在 **开发者** 下找到 **开发者工具** 并点击 **添加**。参见 [添加和移除应用](https://shoprocket.io/zh/help/the-apps-page.md)。

## 添加端点

1. 在后台进入 **设置 > Webhook**，点击 **添加端点**。
2. 输入 **名称**。请以它发送数据的系统命名，这样移除时你就知道什么会停止工作。
3. 输入 **端点网址**。它必须以 `https://` 开头。
4. 对于承载真实业务的端点，请保持 **测试模式端点** 关闭。对于只应接收测试订单的端点，请开启它。
5. 选择要发送的事件。逐个勾选事件，对某一组使用 **全选**，或使用 **订阅所有事件**。最好只选择你的系统会处理的事件。点击事件旁的 **示例** 可查看它发送的消息。
6. 点击 **添加端点**。

![添加 Webhook 端点抽屉：名称 Fulfilment、https 端点 URL、测试模式端点关闭，勾选了 order.created 并展开其示例负载](https://shoprocket.io/img/help/webhooks/add-endpoint.webp)

## 事件

| 分组 | 事件 |
|---|---|
| **订单** | 创建、更新、已付款、已退款、已履行、部分履行、已删除 |
| **客户** | 创建、更新、已删除 |
| **商品** | 创建、更新、已删除 |
| **库存** | 库存已更新 |
| **折扣** | 创建、更新、已删除 |
| **分类** | 创建、更新、已删除 |
| **订阅** | 创建、已续订、续订失败、已暂停、已恢复、已取消、已过期 |
| **许可证密钥** | 已分配、已暂停、已恢复、已过期、已吊销 |

## 发送测试

点击端点上的 **发送测试**。Shoprocket 会立即发送一个测试事件，并告诉你端点是否接受了它以及服务器如何响应，例如“140ms 内响应 200。”，或者根本无法连接。

## 查看发送了什么

端点下方的 **最近的投递** 卡片列出 Shoprocket 尝试发送的每个事件：发送时间、服务器返回的响应码以及尝试次数。投递状态为 **已送达**、**排队中**、**重试中** 或 **失败**。在你修复了自己这边的问题后，点击任意投递上的 **重新发送** 即可再次发送。

![某个端点的最近的投递：HTTP 200 的已送达事件，一个 HTTP 500 的重试中事件，以及重新发送按钮](https://shoprocket.io/img/help/webhooks/recent-deliveries.webp)

## 投递失败时

你的服务器应以任意 2xx 响应码回复每条消息。否则，Shoprocket 会持续重试大约一天。

如果对某个端点的投递连续失败 20 次，该端点会被关闭并说明原因。修复端点后，点击 **立即重新启用**。关闭期间排队的内容随后都会被发送。端点被关闭之前，会在失败不断累积时提醒你，例如“已连续 3 次投递失败。达到 20 次后，我们会自动关闭此端点。”

## 编辑或删除端点

点击端点的编辑按钮可修改名称、地址或事件，然后点击 **保存**。要永久停止向它发送，请点击 **删除** 并确认。

## 开发者须知

每条消息都使用端点的签名密钥签名，以便你的服务器验证它确实来自 Shoprocket。点击端点上的 **显示签名密钥** 即可复制。每条消息还包含事件名称和投递 ID，这样你的服务器就能忽略重复消息。开发者指南包含签名校验、每个事件的负载以及重试细节。请参阅 [Webhook](https://shoprocket.io/docs/webhooks.md)。

## 相关文章

- [创建 API 密钥](https://shoprocket.io/zh/help/api-keys.md)
- [Zapier](https://shoprocket.io/zh/help/zapier.md)
- [测试模式与正式模式](https://shoprocket.io/zh/help/test-mode-vs-live.md)

[在后台打开 Webhook](https://app.shoprocket.io/go/settings/webhooks)

---

- HTML version: https://shoprocket.io/zh/help/webhooks
- Language: 中文 (zh)
- Also in: [العربية](https://shoprocket.io/ar/help/webhooks.md), [Deutsch](https://shoprocket.io/de/hilfe/ereignisse-mit-webhooks-senden.md), [Ελληνικά](https://shoprocket.io/el/help/webhooks.md), [English](https://shoprocket.io/help/webhooks.md), [Español](https://shoprocket.io/es/ayuda/envia-eventos-con-webhooks.md), [Français](https://shoprocket.io/fr/aide/envoyer-des-evenements-avec-les-webhooks.md), [עברית](https://shoprocket.io/he/help/webhooks.md), [हिन्दी](https://shoprocket.io/hi/help/webhooks.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/webhook.md), [Italiano](https://shoprocket.io/it/aiuto/invia-eventi-con-i-webhook.md), [日本語](https://shoprocket.io/ja/help/webhooks.md), [Lietuvių](https://shoprocket.io/lt/pagalba/webhookai.md), [Norsk](https://shoprocket.io/nb/hjelp/webhooks.md), [Nederlands](https://shoprocket.io/nl/hulp/webhooks.md), [Polski](https://shoprocket.io/pl/pomoc/webhooki.md), [Português](https://shoprocket.io/pt/ajuda/envie-eventos-com-webhooks.md), [Română](https://shoprocket.io/ro/ajutor/webhooks.md), [Русский](https://shoprocket.io/ru/help/webhooks.md), [ไทย](https://shoprocket.io/th/help/webhooks.md), [Türkçe](https://shoprocket.io/tr/yardim/webhooklar.md)
