fathom-prod-checklist

用途

Fathom 提供 AI 会议智能能力，包括自动转录、摘要和行动项提取。生产环境中的集成通常会摄取会议录音、处理转录文本，并将行动项同步到下游系统。若集成失败，可能导致会议上下文丢失、跟进遗漏，或转录数据泄露到未授权渠道。本检查清单用于确保会议数据管道可靠且合规。

前置条件

明确指名的租户/数据所有者
经批准的录音/同意/数据使用政策
身份与密钥边界
回滚计划

指令

为访问、同意、留存、集成、CRM 映射、可观测性、事件响应和回滚完成证据门禁。
验证合成或经批准的 canary 工作流，并核验其访问/数据边界。
当任一数据、同意、安全、归属或恢复门禁未验证时，阻止生产启用。

输出

一份生产就绪回执，包含证据、负责人、例外项、canary 结果和经测试的回滚路径。

示例

使用经批准的合成会议数据试运行类生产配置，验证同意/访问/CRM 行为与告警路由，然后在声明的时间窗口内观察。若任一门禁失败，则恢复先前配置；不得通过扩大访问范围或发送真实跟进来掩盖缺陷。

认证与密钥

FATHOM_API_KEY 存放于密钥管理器（而非环境文件）
若构建面向公众的集成，需注册 OAuth 应用
记录密钥轮换计划（90 天周期）
开发/预发/生产环境使用独立凭据
配置 Webhook 签名密钥以验证载荷

API 集成

配置生产基础 URL（https://api.fathom.video/v1）
实施带退避的速率限制处理（标准套餐 60 请求/分钟）
注册 Webhook 端点并使用示例载荷测试
会议录音获取需能处理大文件下载
为长会议（>60 分钟）实现转录分页
使用多种会议形式测试行动项提取
验证日历集成同步（Google Calendar / Outlook）

错误处理与韧性

为 Fathom API 中断配置熔断器
针对 429/5xx 响应实施指数退避重试
处理空转录或部分转录（静默会议、音质差）
Webhook 投递失败时通过轮询触发重新获取
记录会议数据 PII 处理方式（GDPR 同意、留存）
配置备用 Webhook URL 以实现故障转移

监控与告警

按端点跟踪 API 延迟（会议、转录）
设置错误率告警（阈值：10 分钟内 >5%）
转录处理失败触发通知
监控 Webhook 投递成功率
每日摘要对比已处理会议数与计划数

验证脚本

async function checkFathomReadiness(): Promise<void> {
  const checks: { name: string; pass: boolean; detail: string }[] = [];
  // API connectivity
  try {
    const res = await fetch('https://api.fathom.video/v1/meetings?limit=1', {
      headers: { Authorization: `Bearer ${process.env.FATHOM_API_KEY}` },
    });
    checks.push({ name: 'Fathom API', pass: res.ok, detail: res.ok ? 'Connected' : `HTTP ${res.status}` });
  } catch (e: any) { checks.push({ name: 'Fathom API', pass: false, detail: e.message }); }
  // Credentials present
  checks.push({ name: 'API Key Set', pass: !!process.env.FATHOM_API_KEY, detail: process.env.FATHOM_API_KEY ? 'Present' : 'MISSING' });
  // Webhook endpoint reachable
  const webhookUrl = process.env.FATHOM_WEBHOOK_URL;
  if (webhookUrl) {
    try {
      const res = await fetch(webhookUrl, { method: 'HEAD' });
      checks.push({ name: 'Webhook Endpoint', pass: res.ok, detail: `HTTP ${res.status}` });
    } catch (e: any) { checks.push({ name: 'Webhook Endpoint', pass: false, detail: e.message }); }
  } else { checks.push({ name: 'Webhook Endpoint', pass: false, detail: 'URL not configured' }); }
  for (const c of checks) console.log(`[${c.pass ? 'PASS' : 'FAIL'}] ${c.name}: ${c.detail}`);
}
checkFathomReadiness();

错误处理风险表

检查项	跳过的风险	优先级
API 密钥轮换	密钥过期会中断转录管道	P1
Webhook 验证	伪造载荷会注入错误数据	P1
PII 留存政策	会议数据违反 GDPR/CCPA	P1
空转录处理	下游系统在 null 上崩溃	P2
速率限制退避	批量会议导入被 429 阻塞	P3

适用场景

适用于准备将 Fathom 会议智能集成推入生产环境的团队，尤其涉及转录处理、行动项同步、CRM 对接、日历同步与合规数据留存等场景。

限制

资料未提供具体的定价、收费模式、支持平台范围或效果保证；其他未列明的事项暂未提供。后续可参考 fathom-security-basics 了解会议数据隐私与同意模式。