用途:帮助开发者搭建 Fireflies.ai Webhook 处理器,验证签名并处理会议转写、摘要等事件。新集成应基于 Webhooks V2,V1 已弃用但仍可继续投递。
主要能力:区分 V1/V2(V2 签名为 sha256= 前缀、字段 snake_case、事件名如 meeting.transcribed、meeting.summarized、meeting.bot_joined);用 HMAC-SHA256 对原始请求体做时序安全比较;解析载荷中的 event、timestamp、meeting_id、client_reference_id;并提示 webhook 只是通知,需再用 meeting_id 查询 Fireflies GraphQL API 获取转写与摘要。
使用方式:在 Webhooks V2 配置页设置回调 URL、签名密钥与订阅事件。签名密钥可选,未配置时 Fireflies 不发送 X-Hub-Signature 头;生产环境应配置密钥并拒绝未签名请求。示例提供 Node 与 Python 校验函数,完整处理器见 examples/express、examples/nextjs、examples/fastapi。本地调试可用 npx hookdeck-cli listen 3000 fireflies --path /webhooks/fireflies。环境变量为 FIREFLIES_WEBHOOK_SECRET。
限制:无官方 Fireflies SDK,各框架需手动校验;V2 需在 10 秒内返回 2xx;X-Webhook-Delivery-Id 未见于文档,仅供日志与幂等参考;V1 文档未明确签名覆盖原始字节还是重新序列化 JSON,需自行记录原始体排查。