Fathom — 会议记录管理

通过托管 OAuth 认证访问 Fathom API。检索会议录音、转写、摘要、行动项，并管理通知用的 webhook。

快速开始

# 列出最近的会议
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/fathom/external/v1/meetings')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

基础 URL

https://gateway.maton.ai/fathom/{native-api-path}

将 {native-api-path} 替换为实际的 Fathom API 端点路径。网关将请求代理到 api.fathom.ai 并自动注入您的 OAuth 令牌。

认证

所有请求都需要在 Authorization 头部中包含 Maton API 密钥：

Authorization: Bearer $MATON_API_KEY

环境变量： 将您的 API 密钥设置为 MATON_API_KEY：

export MATON_API_KEY="YOUR_API_KEY"

获取您的 API 密钥

• 在 maton.ai 登录或创建账户
• 访问 maton.ai/settings
• 复制您的 API 密钥

连接管理

在 https://ctrl.maton.ai 管理您的 Fathom OAuth 连接。

列出连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/fathom')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

添加连接

在浏览器中访问 https://ctrl.maton.ai/connections/fathom/new 以连接您的 Fathom 账户。

API 端点

会议

# 列出会议
GET /fathom/external/v1/meetings
# 获取特定会议
GET /fathom/external/v1/meetings/{meetingId}
# 获取会议转写
GET /fathom/external/v1/meetings/{meetingId}/transcript
# 获取会议摘要
GET /fathom/external/v1/meetings/{meetingId}/summary
# 获取行动项
GET /fathom/external/v1/meetings/{meetingId}/action-items

Webhook

# 列出 webhook
GET /fathom/external/v1/webhooks
# 创建 webhook
POST /fathom/external/v1/webhooks
# 删除 webhook
DELETE /fathom/external/v1/webhooks/{webhookId}

事件类型

支持以下 webhook 事件：

• meeting.created - 创建新会议时
• meeting.ready - 会议准备好进行处理时
• meeting.transcript_available - 转写可用时
• meeting.summary_available - 摘要可用时

使用示例

获取会议详情

python <<'EOF'
import urllib.request, os, json
meeting_id = "your-meeting-id"
req = urllib.request.Request(f'https://gateway.maton.ai/fathom/external/v1/meetings/{meeting_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
result = json.load(urllib.request.urlopen(req))
print(json.dumps(result, indent=2))
EOF

创建 Webhook

python <<'EOF'
import urllib.request, os, json
webhook_data = {
  "url": "https://your-webhook-url.com",
  "events": ["meeting.created", "meeting.summary_available"]
}
req = urllib.request.Request(
  'https://gateway.maton.ai/fathom/external/v1/webhooks',
  data=json.dumps(webhook_data).encode('utf-8'),
  headers={
    'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}',
    'Content-Type': 'application/json'
  }
)
result = json.load(urllib.request.urlopen(req))
print(json.dumps(result, indent=2))
EOF

错误处理

所有错误响应都将包含状态码和错误消息：

{
  "error": {
    "code": "error_code",
    "message": "Error description"
  }
}

常见的状态码：

• 400 - 错误请求
• 401 - 未授权（API 密钥无效）
• 403 - 禁止访问（权限不足）
• 404 - 未找到
• 429 - 请求过多（速率限制）
• 500 - 服务器内部错误

限制

• 速率限制：每分钟 60 次请求
• Webhook 超时：10 秒
• 数据保留：会议数据保留 90 天

支持

如遇到问题，请访问：

• Maton 文档
• Fathom API 文档