用途:部署 Fathom AI 会议集成服务,包括 webhook 处理器与会议同步服务,用于处理会议转录、摘要和行动项。触发短语如“deploy fathom”“fathom webhook server”“fathom cloud function”。
主要能力:提供容器化部署方案,基于 Docker 构建生产镜像;包含环境变量配置(FATHOM_API_KEY、FATHOM_BASE_URL、FATHOM_WEBHOOK_SECRET、LOG_LEVEL、PORT、NODE_ENV);提供健康检查端点,验证 Fathom API 连通性与转录获取;支持滚动更新策略,避免丢失 webhook 事件。
使用方式:先构建镜像 docker build -t fathom-integration:latest .,再运行 docker run -d --name fathom-integration -p 3000:3000 -e FATHOM_API_KEY -e FATHOM_BASE_URL -e FATHOM_WEBHOOK_SECRET fathom-integration:latest,然后用 curl -s http://localhost:3000/health | jq . 验证。滚动更新时构建新镜像并停止、删除、重新运行容器。
前置条件:需要版本化部署配置、已批准的租户/数据/同意策略、限定范围的密钥引用、负责人和回滚计划。
流程要求:先在开发/暂存环境用合成会议数据验证访问、映射、回调、脱敏遥测和恢复;仅通过已批准的生产金丝雀发布并指定观察者;出现同意、访问、数据、交付或可靠性回归时回滚或暂停。输出为分阶段部署回执,含负责人批准、合成验证、金丝雀证据和回滚引用。
限制与错误处理:401 表示 API 密钥无效或过期,需在 Fathom 开发者设置中重新生成;403 表示 API 权限不足,需申请会议和转录访问权限;404 表示会议 ID 不存在,需从 webhook 负载验证;429 表示超出速率限制,需实现退避并批量获取转录;webhook 签名不匹配表示 FATHOM_WEBHOOK_SECRET 错误,需从 Fathom webhook 设置重新复制。后续可参考 fathom-webhooks-events。