Fathom技能使用说明
2026-03-31
新闻来源：网淘吧
围观:15
电脑广告
手机广告
Fathom 技能
连接到Fathom AI以获取通话录音、文字记录和摘要。
设置
1. 获取您的 API 密钥
- 前往developers.fathom.ai
- 创建一个 API 密钥
- 复制密钥（格式：
v1XDx...）
2. 配置
# Option A: Store in file (recommended)
echo "YOUR_API_KEY" > ~/.fathom_api_key
chmod 600 ~/.fathom_api_key
# Option B: Environment variable
export FATHOM_API_KEY="YOUR_API_KEY"
3. 测试连接
./scripts/setup.sh
命令
列出最近通话
./scripts/list-calls.sh # Last 10 calls
./scripts/list-calls.sh --limit 20 # Last 20 calls
./scripts/list-calls.sh --after 2026-01-01 # Calls after date
./scripts/list-calls.sh --json # Raw JSON output
获取文字记录
./scripts/get-transcript.sh 123456789 # By recording ID
./scripts/get-transcript.sh 123456789 --json
./scripts/get-transcript.sh 123456789 --text-only
获取摘要
./scripts/get-summary.sh 123456789 # By recording ID
./scripts/get-summary.sh 123456789 --json
搜索通话
./scripts/search-calls.sh "product launch" # Search transcripts
./scripts/search-calls.sh --speaker "Lucas"
./scripts/search-calls.sh --after 2026-01-01 --before 2026-01-15
API 参考
| 端点 | 方法 | 描述 |
|---|---|---|
/meetings | GET | 使用筛选器列出会议 |
/recordings/{id}/transcript | GET | 包含发言人的完整转录文本 |
/recordings/{id}/summary | GET | AI 总结 + 行动项 |
/webhooks | POST | 注册用于自动同步的 Webhook |
基础 URL: https://api.fathom.ai/external/v1
认证: X-API-Key请求头
列表调用的过滤器
| 过滤器 | 描述 | 示例 |
|---|---|---|
--limit N | 结果数量 | --limit 20 |
--after DATE | 指定日期之后的通话 | --after 2026-01-01 |
--before DATE | 日期前通话 | --before 2026-01-15 |
--cursor TOKEN | 分页游标 | --cursor eyJo... |
输出格式
| 标志 | 描述 |
|---|---|
--json | API原始JSON数据 |
--table | 格式化表格（列表默认格式） |
--text-only | 纯文本（仅限转录稿） |
示例
获取您最近一次通话的摘要
# Get latest call ID
CALL_ID=$(./scripts/list-calls.sh --limit 1 --json | jq -r '.[0].recording_id')
# Get summary
./scripts/get-summary.sh $CALL_ID
导出上周所有通话
./scripts/list-calls.sh --after $(date -d '7 days ago' +%Y-%m-%d) --json > last_week_calls.json
查找提及某个主题的通话
./scripts/search-calls.sh "quarterly review"
故障排除
| 错误 | 解决方案 |
|---|---|
| "未找到API密钥" | 运行设置或设置环境变量FATHOM_API_KEY |
| "401 未授权" | 检查API密钥是否有效 |
| "429 请求频率受限" | 等待后重试 |
| "录音未找到" | 确认录音ID存在 |
Webhook设置（高级）
如需自动获取转录文本，请参阅Webhook设置指南：
./scripts/setup-webhook.sh --url https://your-endpoint.com/webhook
需要可公开访问的HTTPS端点。
微信扫一扫，打赏作者吧～文章底部电脑广告
手机广告位-内容正文底部
