SuperAPI AI 工具集

fireflies-webhooks-events

编程与开发

查看项目

更新于 10-15 23:25

技能介绍

用途:实现一个符合当前 Fireflies Webhooks V2 契约的消费端,处理 webhook 投递并保证安全与可靠性。

主要能力:V2 载荷包含 event、timestamp、meeting_id 及可选 client_reference_id,已记录事件有 meeting.transcribed 与 meeting.summarized。X-Hub-Signature 为对原始请求体的 sha256= 签名;有效投递需在 10 秒内返回 2xx。技能覆盖原始字节捕获、签名格式与定时安全 HMAC 校验(在 JSON 解析前)、严格 schema 校验、未知事件隔离、基于投递元数据与事件/会议标识的去重、容忍 summarized 晚于 transcribed 到达,以及先快速确认再异步获取授权数据。

使用方式:仅在 HTTPS 端点订阅已批准的 V2 事件类型。认证操作从批准的密钥管理器注入 FIREFLIES_API_KEY,仅以 Authorization: Bearer REDACTED_KEY 发送到 https://api.fireflies.ai/graphql,不得打印、提交、放入 URL、转发浏览器或写入证据;webhook 签名密钥与 API 密钥分开,不可复用。日志只记录签名结果、事件类型、延迟、去重结果与任务 ID,不含载荷内容。

限制与边界:订阅全团队事件、事件后获取转录内容、重放投递或保留载荷均需审批。缺少签名时返回 401;重复投递只确认不重复副作用;未知事件仅隔离元数据,不推断 schema。使用 Read、Glob、Grep 检查代码与配置,Write/Edit 仅用于已批准的改动;不得因调用本技能而查询 Fireflies、获取会议内容、创建 AskFred 线程、上传媒体、更改账户状态、重放事件或部署。依赖字段、权限或计划限制前应查阅官方 Fireflies.ai 资料。