SuperAPI AI 工具集

fathom-webhooks-events

通用与其它

查看项目

更新于 10-15 23:25

技能介绍

用途:Fathom Webhooks 在会议录制内容就绪时,向指定 URL 推送会议数据,用于自动化会议处理、接收实时转录或触发后续流程。

主要能力:Webhook 可包含摘要、转录和行动项;可在 Settings 或通过 API 配置。API 示例:curl -X POST -H "X-Api-Key: ${FATHOM_API_KEY}" -H "Content-Type: application/json" https://api.fathom.ai/external/v1/webhooks -d '{"url":"https://your-app.com/webhooks/fathom","include_summary":true,"include_transcript":true,"include_action_items":true,"fire_on_own_meetings":true,"fire_on_shared_meetings":false}'。也可在 Settings > Integrations > Webhooks > Create Webhook 创建。

事件与处理:事件类型如 meeting_content_ready,载荷含 recording_id、url、share_url、title、summary、transcript、action_items。处理时先验证签名再解析载荷,并在文档规定的超时内确认;用稳定不透明 ID 去重,仅记录必要的脱敏元数据;对瞬时错误做有界重试/退避,对永久失败进行隔离。

测试:可用 webhook.site 或 ngrok http 5000 做本地测试,使用合成事件验证签名、去重与有界失败路径,仅记录事件 ID/状态/结果,不要持久化转录文本、会议内容、联系人或 webhook 密钥。

限制:需预先准备已验证的回调端点、签名/认证规则、幂等存储、脱敏策略和事件负责人;签名失败应拒绝事件并排查配置,重复事件返回幂等成功,永久失败需隔离并修复契约后再重放。性能优化参见 fathom-performance-tuning。