Webhook可以理解为”自动回电”:你在系统A里登记一个自己的接收地址,当系统A发生指定事件(比如新订单、表单提交)时,它会主动把数据推送到这个地址,从而触发你的自动化流程。与反复询问”有了吗”的轮询相比,它是事件驱动、即时到达的。
Webhook和普通API调用有什么区别?
| 对比项 | 普通API调用(拉) | Webhook(推) |
|---|---|---|
| 发起方 | 你主动去请求对方 | 对方在事件发生时推给你 |
| 实时性 | 取决于你查询的频率 | 事件发生即推送 |
| 资源消耗 | 频繁轮询浪费请求 | 无事件则无消耗 |
| 典型用途 | 查询数据、执行操作 | 接收通知、触发流程 |
两者常常配合使用:Webhook负责”有事叫我”,API负责”具体去查、去做”。
Webhook在自动化工具里怎么配置?
- 在自动化平台新建一个Webhook触发节点,得到一个专属URL;
- 把这个URL填到来源系统的Webhook设置里,选择要订阅的事件;
- 让来源系统发一条测试事件,确认自动化流程能收到数据;
- 解析推送内容,接上后续节点:写表格、发通知、调接口都可以。
在n8n、各类表单与代码托管平台上,这套流程几乎一致,学会一次到处可用。
使用Webhook要注意什么?
- 验证来源:用密钥签名校验推送方身份,防止伪造请求;
- 及时响应:收到后尽快返回成功状态,耗时处理放到后续节点做;
- 处理重复:网络重试可能造成重复推送,流程里要做幂等判断;
- 地址保密:URL泄露可能被恶意触发,必要时定期更换。
Webhook有哪些典型用法?
- 表单来了就归档:用户提交表单,自动写入表格并通知负责人跟进;
- 下单后触发履约:新订单同时推给仓库与客服系统,各自开工;
- 代码事件联动:代码合并后自动部署、跑测试、在群里发结果;
- 监控告警转群:服务异常时把告警推到值班群,附上详情链接。
这些场景的共同点是:事件源头在别的系统里,而你需要”它一发生我就知道”。把这条通道打通之后,再复杂的联动都只是往触发器后面加节点而已。
更多自动化工具与教程入口,见AI导航。把”定时轮询”改成”Webhook触发”,往往是让自动化流程又快又省的关键一步。
常见问题FAQ
Webhook和API接口是一回事吗?
不是。API是你主动调用对方的功能,Webhook是对方在事件发生时主动推送给你,方向相反,通常配合使用。
收不到推送怎么排查?
按顺序检查:事件类型是否勾选、URL是否复制完整、接收端服务是否可被公网访问、来源系统的推送日志里有没有报错。
Webhook有费用吗?
多数SaaS产品对基础Webhook推送不单独收费,需要留意的是接收端自动化平台的执行次数额度。
推送过来的数据格式看不懂怎么办?
先在触发节点打印原始数据看结构,多数平台会提供示例载荷;字段含义不清楚时查来源系统的接口文档,把需要的字段映射到后续节点即可。