Webhook是什么?它有什么用?

与其不停地询问“有新消息吗?”,不如让软件在事情发生的那一刻就收到通知。

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

Try 30 days free

30 days free, no credit card.

作者 Pilotiko editorial team · 更新于

要点

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

Webhook是如何工作的?

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

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

许多软件服务都提供Webhook。它们常用于在预约到达时立即创建工作单,或通知负责准备报价单的人员。

服务型中小企业中,哪些事件会触发Webhook?

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

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

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

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

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

Webhook能避免多少无谓的调用?

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

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

Pilotiko使用Webhook吗?

Pilotiko的功能清单中没有描述任何向客户提供的Webhook,因此我们不对外宣称有此功能。至于对外发送,我们的立场则很明确:在Pilotiko中,凡涉及客户、资金或对外发送的事项,都要等待人工批准,即使信息是自动到达的。

常见问题

Webhook和API有什么区别?

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

接收Webhook需要服务器吗?

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

Webhook是即时的吗?

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

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

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

小企业适合使用Webhook吗?

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

资料来源

  1. GitHub Docs, About webhooks (查阅于 2026年10月15日).
  2. Stripe Docs, Receive Stripe events in your webhook endpoint (查阅于 2026年10月15日).

Your whole business, on one screen.

Each department is a room. Pilotiko prepares the work; you approve with one click.

Try 30 days free

The Pilotiko office of a sample company: each department is a room.
  • Call answered
  • Appointment confirmed
  • Email reply ready
  • Invoice prepared

和您的团队一起试用办公室

免费 30 天。

免费试用 30 天