
要点
Webhook 可以在业务事件发生时将数据发送到工作流入口。接入时重点确认事件来源可信、字段含义一致,以及重复或延迟到达的事件怎样处理。收到请求只代表接收成功,不等于后续业务已经完成。
明确什么变化会触发流程
先定义事件,例如新增询价、资料更新或审核完成。说明发送方、事件编号、发生时间和业务对象,并确定哪些字段是当前快照,哪些只是需要后续查询的标识。
不同系统可能在记录创建和修改时都发送事件。如果处理范围不清,一条记录的后续更新也可能重复触发原来的流程,甚至形成相互调用。
验证来源与接收条件
按发送方文档核验签名、身份或其他认证方式,限制入口接受的请求格式。公开地址本身不是身份凭证,业务参数仍需校验。测试地址与正式地址应分别管理。
n8n 的 Webhook 节点可以接收事件并触发流程,官方文档也区分测试与生产 URL。接入前要用实际部署环境验证可达性,不能只看编辑器中的测试成功。
处理重复、延迟和顺序变化
为已接收事件记录业务标识和处理状态。重复到达时核查是否完成,旧事件晚到时检查是否会覆盖较新的状态。涉及写入时,去重规则还应与目标系统保持一致。
向发送方返回的接收结果与流程最终结果应分开表达。出现处理失败时,保留可恢复位置并通知相应负责人,避免请求被接收后就消失在无人查看的队列中。
把接收状态与处理结果分开
对一条询盘事件分别测试正常、重复和迟到请求,核对身份、事件标识与对象当前状态。接收回执只表达已接收,最终完成另有结果记录;测试入口与生产入口分别验证。
参考来源
外部资料用于说明方法;具体功能、费用和许可条件以供应商现行说明及实际验证为准。
- n8n Docs|Webhook事件接收与测试、生产入口区别