# Webhook是什么？它有什么用？

> Webhook（网络钩子）会在软件内发生事件的瞬间，自动向其他系统发送通知。本文讲解Webhook的工作原理，提供面向中小企业的数字化示例，并提醒您需要留意的常见安全陷阱。

更新于 2026年10月15日 · https://app.pilotiko.com/zh/glossary/webhook

Webhook是一种机制：当某个特定事件发生时（例如收到一笔付款或创建了一个预约），软件会自动向您指定的网址发送一个包含数据的HTTP请求。因此，接收通知的系统无需反复查询源软件。

## 要点
- 只需订阅一次某个事件，之后通知就会自动到达。
- Webhook是API的补充：它主动推送信息，而不是等别人来索取。
- 必须验证收到的每条消息的签名。
- 一个好的接收端会快速响应，并且能够处理同一通知重复到达的情况。

## Webhook是如何工作的？

GitHub的文档很好地概括了其原理：您订阅软件系统中发生的事件，每当这些事件发生时，就会自动向您的服务器投递数据。它的好处是在信息产生的当下就能收到，而不必时不时地查询[API](https://app.pilotiko.com/zh/glossary/api)看看有没有新内容[1]。

创建Webhook时，需要指明一个网址（URL）以及您关心的事件。当其中某个事件发生时，源软件会向该网址发送一个包含事件详情的HTTP请求。监听的服务器随后就可以采取行动：发送通知、更新记录、启动下一个步骤[1]。

许多[软件服务](https://app.pilotiko.com/zh/glossary/saas)都提供Webhook。它们常用于在预约到达时立即创建[工作单](https://app.pilotiko.com/zh/glossary/work-order)，或通知负责准备[报价单](https://app.pilotiko.com/zh/glossary/quote)的人员。

## 服务型中小企业中，哪些事件会触发Webhook？

| 源软件中的事件 | 发送的数据 | 可能的响应 |
|---|---|---|
| 银行卡付款成功 | 金额、客户、发票编号 | 在会计系统中将发票标记为已付款 |
| 网站上创建了预约 | 日期、服务、联系方式 | 为技术人员创建工作单 |
| 报价表单已填写 | 需求描述、地址 | 通知负责准备报价单的人员 |
| 订阅已取消 | 客户、结束日期 | 将该客户从已排定的路线中移除 |

可提供哪些事件完全取决于各个软件，请查阅其文档。

## 如果接收服务器出现故障会怎样？

优秀的服务商会重试。例如，Stripe指出，在正式模式下，它会尝试投递事件最长三天，重试间隔逐渐拉长；在其测试环境中，则会在几小时内重试三次[2]。

实际后果是：同一条通知可能不止一次到达。接收端必须能识别已处理过的事件，以免例如重复创建同一张发票。

## Webhook能避免多少无谓的调用？

**计算：里穆斯基一家拥有3间诊室的物理治疗诊所同步其预约**

- 方案1：每5分钟查询一次API，每天12小时 : 每天144次调用
- 每天实际新增预约数（假设） : 18
- 没有任何新内容的调用（144 − 18） : 126
- 方案2：针对“预约已创建”事件设置Webhook : 每天18条通知
- 方案1中看到一个预约的最长延迟 : 最多5分钟
- **= Webhook只在事件发生时传递这18个有用的事件，而不是进行144次检查（其中126次一无所获）。**

## 常见的安全与设计错误有哪些？

- 不验证签名就接受发往Webhook网址的任何消息：任何人都可以发送一条伪造的“已收到付款”。
- 在验证签名之前修改消息的原始正文：Stripe明确指出，任何修改都会导致验证失败[2]。
- 先完成全部处理再响应：对某些服务商来说，响应过慢可能被视为失败，并引发重新发送。
- 不处理重复通知，而重试本来就是正常现象。
- 接入一个[自动化](https://app.pilotiko.com/zh/glossary/process-automation)流程，在收到通知后立即给客户发信，而没有人工把关。

## Pilotiko使用Webhook吗？

Pilotiko的功能清单中没有描述任何向客户提供的Webhook，因此我们不对外宣称有此功能。至于对外发送，我们的立场则很明确：在Pilotiko中，凡涉及客户、资金或对外发送的事项，都要等待[人工批准](https://app.pilotiko.com/zh/glossary/human-in-the-loop)，即使信息是自动到达的。

## 常见问题

### Webhook和API有什么区别？

使用API时，由您的程序在自己决定的时候提出查询。使用Webhook时，源软件会在事件发生时主动通知您。两者往往相辅相成：Webhook提示发生了变化，随后再通过API读取详细内容。

### 接收Webhook需要服务器吗？

需要一个可访问、能监听请求的网址，可以是您自己的服务器、托管函数或自动化工具。该网址必须使用HTTPS，以保护传输的数据。

### Webhook是即时的吗？

它在事件发生的那一刻发出，但实际延迟取决于服务商和网络。如果接收端出现故障，通知可能在多次重试后很久才到达。

### 如何确认Webhook确实来自正确的软件？

大多数服务商会用只有您知道的密钥为每条消息签名。您的接收端重新计算签名，并拒绝任何不匹配的消息。

### 小企业适合使用Webhook吗？

适合，尤其是通过自动化工具，它们会替您提供接收网址。建议先从一个有用的事件开始，例如新预约，并观察几周的运行结果。

## 资料来源

1. GitHub Docs, « About webhooks », https://docs.github.com/en/webhooks/about-webhooks (查阅于 2026-10-15)
2. Stripe Docs, « Receive Stripe events in your webhook endpoint », https://docs.stripe.com/webhooks (查阅于 2026-10-15)
