SuperAPI AI 工具集

klaviyo-webhooks-events

营销与增长

查看项目

更新于 10-15 23:26

技能介绍

用途:搭建 Klaviyo Webhook 端点,完成签名校验、事件接收与分发、幂等去重,并通过 Webhooks API 管理订阅。覆盖从创建订阅、验证请求签名、Express 接收事件、按主题路由、Redis 去重到订阅管理的六步流程。

主要能力:使用 HMAC-SHA256 校验 webhook-signature 头;支持 Profile、List、Segment、Campaign、Flow 及自定义事件等主题;按 event.type 分发到各主题处理器;以 Redis 记录已处理事件 ID 与 TTL 防止重复处理;可列出、查看主题并删除 webhook。

必要用法:前置条件包括启用 Webhooks 的 Klaviyo 账户、可从公网访问的 HTTPS 端点、具备 webhooks:read 与 webhooks:write 权限的 API 密钥,以及用于幂等的 Redis 或数据库。用 webhooksApi.createWebhook 创建订阅并保存返回的签名密钥;Express 路由需使用 express.raw({ type: 'application/json' }) 保留原始请求体;成功返回 200 { received: true },重复事件返回 200 { status: 'already_processed' },签名错误返回 401,处理异常返回 500。建议先返回 200 再异步处理以避免超时。

适用场景:将新建或更新的 Profile 同步至自有数据库,或将 campaign.sent 等事件转发至分析管道。

限制:签名密钥错误、使用 JSON body parser、订阅主题错误等会导致验证失败或事件缺失;文中未提供收费、价格与完整代码示例,完整实现见 references/implementation.md 与 references/examples.md。