SuperAPI AI 工具集

fathom-common-errors

编程与开发

查看项目

更新于 10-15 23:25

技能介绍

用途:该技能用于诊断 Fathom 会议、转录、集成、CRM 同步与授权相关问题,强调以最少且脱敏的证据进行排查,并采用可回滚的修复方式。

适用前提:需准备有边界的非敏感复现步骤、环境与版本信息、同意与数据策略说明,以及经批准的诊断渠道。

主要能力与用法:先定位受影响的会议或动作状态,仅收集不透明 ID、状态、配置版本和时间信息;在修复前校验范围、访问权限、同意状态、映射关系及限流条件;用合成记录测试最小安全修复并记录验证结果。输出应包含分类后的失败信息、脱敏证据、有界修复方案、负责人及已验证的恢复或升级路径。

常见错误参考:401 未授权,可在 Settings > Integrations > API Access 重新生成 API 密钥;429 限流为所有 API 密钥合计每分钟 60 次调用,需实现指数退避并批量请求;转录为空可能因会议仍在处理、录音过短或音频质量问题,建议录制后等待 5-10 分钟并在 Fathom UI 中检查;摘要缺失通常因 AI 处理未完成,可轮询录制端点直至摘要可用;Webhook 未触发需在 Settings > Integrations > Webhooks 验证 URL,并可用以下命令测试:

curl -X POST https://your-url.com/webhooks/fathom
-H "Content-Type: application/json"
-d '{"type": "test"}'

OAuth 令牌过期时,用刷新令牌刷新访问令牌。

快速诊断命令:

curl -s -o /dev/null -w "%{http_code}" -H "X-Api-Key: ${FATHOM_API_KEY}"
https://api.fathom.ai/external/v1/meetings?limit=1

安全与限制:若同意或访问权限不明确,应停止处理与共享,先核实归属与策略;CRM 映射错误时暂停同步,修正并测试映射后再重放;出现重复动作时按稳定 ID 去重,不自动重发。排查时不要查看或分享客户录音,未解决时以脱敏证据升级。其他资源、完整错误清单及更详细诊断步骤暂未提供。