fathom

🎙️ AI 会议录音管理与智能摘要

Maton 官方提供的 Fathom API 集成方案,通过托管 OAuth 安全访问会议录音、转录文本与 AI 摘要,支持 Webhook 自动化通知,助力企业高效沉淀会议知识资产。

收藏
8.9k
安装
2.5k
版本
v1.0.0
CLS 安全性认证2026-05-18
点击查看完整报告 >

使用说明

Fathom Skill 是 Maton 官方推出的 Fathom API 集成解决方案,旨在通过托管 OAuth 认证机制,为用户提供安全便捷的会议数据访问能力。该技能允许开发者通过统一的 Maton 网关(gateway.maton.ai)访问 Fathom 的原生 API 端点,实现会议录音检索、转录文本获取、AI 摘要生成以及 Webhook 事件通知等核心功能。

核心用法上,用户首先需要在 Maton 平台获取 API Key 并配置环境变量,随后通过标准 HTTP 客户端(如 Python urllib、JavaScript Fetch)向 Maton 网关发送请求。技能支持完整的 OAuth 连接生命周期管理,包括创建、查询、删除连接,并允许用户通过 Maton-Connection 头部指定特定连接。API 功能覆盖会议列表查询(支持多维度筛选)、单条录音详情获取、转录文本与摘要提取(支持同步/异步模式)、团队与成员管理,以及 Webhook 的创建与删除,满足从数据提取到实时通知的全链路需求。

显著优点包括:第一,托管式 OAuth 大幅简化了认证流程,用户无需处理复杂的 OAuth 2.0 令牌刷新逻辑,Maton 自动管理令牌生命周期;第二,文档结构清晰,提供了 Python、JavaScript、Bash 等多语言示例,且所有示例均使用标准库,无额外依赖;第三,支持异步回调机制,适合处理长文本转录等耗时操作;第四,完善的错误处理文档,明确列出了 400、401、404、429 等状态码含义及排查方法。

潜在局限性方面,首先,所有请求必须通过 Maton 网关中转,无法直接访问 Fathom API,这引入了额外的网络延迟和单点故障风险;其次,OAuth 用户在列表端点存在功能限制,无法直接获取转录、摘要等详细内容,必须调用单独的详情接口;再者,功能重度依赖网络连接,离线环境无法使用;最后,需要用户自行管理 MATON_API_KEY 环境变量,增加了配置复杂度。

该技能适合以下群体:需要将会议数据集成到内部系统的开发团队;销售、客户成功等需要批量回顾会议记录的业务团队;希望构建自动化会议工作流(如自动归档、知识库同步)的企业;以及需要实时监控会议状态并触发后续流程的技术运营人员。

使用风险主要包括:API Key 泄露风险,若环境变量配置不当可能导致未授权访问;第三方依赖风险,Maton 网关或 Fathom 服务的可用性直接影响功能;数据隐私考量,会议内容需经过 Maton 网关转发,存在中间人攻击理论风险(尽管使用 HTTPS);速率限制风险,高频调用可能触发 429 错误;以及 Webhook 安全风险,若回调 URL 配置不当可能导致数据泄露。

安全解读

核心用法

Fathom Skill 是 Maton 平台提供的托管式 API 集成方案,允许用户通过单一 API 密钥访问 Fathom 的完整功能栈,无需自行处理复杂的 OAuth 流程。

主要功能模块:

  • 会议检索:支持按时间范围、团队、域名、录制者等多维度筛选会议记录
  • 内容提取:获取会议转录文本(带时间戳和发言人信息)、AI 生成的结构化摘要、行动项列表
  • Webhook 管理:配置自动推送机制,支持团队级或个人级录制触发
  • 连接管理:通过 Maton 控制台集中管理多账户 OAuth 授权

技术架构特点:
所有请求经 gateway.maton.ai 代理转发,自动注入 OAuth Token。采用 RESTful 设计,返回标准 JSON 格式,支持 cursor 分页。同步/异步双模式调用,异步通过 destination_url 回调。

显著优点

1. 零 OAuth 开发成本:Maton 托管 OAuth 生命周期,用户仅需管理单一 API Key
2. 企业级数据过滤:内置 calendar_invitees_domains_type 等字段,支持内外部会议智能分类

3. 灵活触发机制:Webhook 支持 4 种录制范围组合,可细粒度控制数据推送内容

4. 官方文档完整:27 个 API 端点全部有据可查,包含 Python/JS/cURL 多语言示例

潜在局限

  • 功能边界限制:OAuth 用户无法在列表端点直接获取完整转录/摘要,需二次调用详情接口
  • 语言支持单一:目前仅支持英语转录和摘要生成
  • 依赖外部网关:服务可用性与 Maton 基础设施绑定,存在单点依赖风险
  • 异步调试成本:Webhook 集成需自行搭建接收端,调试链路较长

适合人群

  • 销售/客户成功团队:需要批量提取会议洞察、同步至 CRM
  • 产品经理:追踪用户访谈记录,建立研究知识库
  • 合规审计人员:按域名筛选外部会议,满足数据治理要求
  • 自动化开发者:构建会议后处理流水线(摘要 → 任务创建 → 通知推送)

常规风险

  • API 密钥泄露MATON_API_KEY 需严格保管,泄露可能导致会议数据被非法访问
  • Webhook 端点安全:接收端需验证 secret 签名,防止伪造数据注入
  • 数据驻留合规:会议内容经 Maton 网关中转,需确认符合企业数据出境政策
  • 速率限制:高频调用可能触发 429 限制,需实现指数退避重试

fathom 内容

手动下载zip · 5.1 kB
LICENSE.txttext/plain
请选择文件