用途:验证并处理 Salesloft Webhook 投递,在解析 JSON 或触发副作用前,先认证投递的精确字节与订阅密钥,使副作用幂等。
主要能力:以 x-salesloft-event 识别事件类型;以 x-salesloft-signature 作为使用 callback_token 为密钥、对精确原始请求体计算的十六进制 SHA-1 HMAC 进行校验;payload 内也含 callback token 需一并验证;支持事件路由、持久化去重与通过 API 读取对账。
使用方式:先取得已批准的 HTTPS 回调 URL 与事件类型、高熵 callback token 及 JSON 解析前的原始请求体访问权限,并准备持久化去重存储与对账负责人。在任何中间件改写请求体前捕获原始字节与所需请求头;拒绝缺失、畸形、长度不等或不匹配的签名;签名通过后再解析 JSON 并校验 callback token 与预期事件类型;由事件类型、规范业务标识与 payload 摘要派生稳定去重键;在确认或分发副作用前持久化接收与去重状态;异步处理并做有界重试,通过 API 读取对账遗漏变更。使用 Read、Glob、Grep 检查解析、签名比较、队列与副作用,仅在需要当前官方文档时用 WebFetch,确认处理边界后再用 Write 或 Edit。
限制与注意:不要在没有负责人批准时创建或更改订阅、回调 URL、事件范围或生产令牌;不要为调试方便而接受无法验证的事件。失败投递会以 15 秒间隔额外重试三次;订阅范围随事件类型不同,须查当前事件表。签名不匹配应在解析前拒绝并记录脱敏元数据;重复投递返回先前结果不重复副作用;处理器失败保留接收记录并使用有界内部重试;疑似遗漏事件通过相关读取端点或游标轮询对账。输出事件类型、签名与 callback token 判定、去重键、队列接收、处理结果、重试状态与对账状态,不含 payload 数据。