Quo

📞 企业电话系统一站式管理

Quo API 集成服务,通过托管 OAuth 管理企业电话系统的通话、短信、联系人与对话记录,支持消息发送与通话检索。

收藏
7.3k
安装
3.6k
版本
1.0.3
CLS 安全性认证2026-06-03
点击查看完整报告 >

使用说明

Quo 企业电话系统集成服务

核心用法

Quo 技能是 Maton 提供的 Quo API 代理服务,通过托管 OAuth 认证让用户无需直接管理令牌即可访问企业电话系统功能。核心操作包括:

  • 消息管理:发送 SMS(支持 1600 字符,美国/加拿大 $0.01/条)、查询消息历史、管理对话状态
  • 通话管理:列出来电记录、获取通话详情、下载录音与转录文本、访问语音邮件
  • 联系人管理:创建、更新、删除联系人,支持自定义字段与多来源数据
  • 号码与用户:管理企业电话号码、查询用户权限与角色

所有请求通过 https://api.maton.ai/quo/{path} 代理转发,自动注入 OAuth 令牌。需设置 MATON_API_KEY 环境变量,并在请求头中包含 Authorization: Bearer $MATON_API_KEYUser-Agent: Maton/1.0

显著优点

  • 托管 OAuth 简化认证:无需自行维护令牌刷新,Maton 自动处理 Quo 的 OAuth 流程
  • 多连接管理:支持同时连接多个 Quo 账户,通过 Maton-Connection 头切换
  • 完整通话记录:集成录音、转录、语音邮件、通话摘要一站式获取
  • 细粒度权限:读写分离,敏感操作需显式用户确认
  • 标准化接口:RESTful API 设计,支持分页、过滤、时间范围查询

潜在缺点与局限性

  • 代理依赖:所有流量经过 Maton 中转,存在单点故障与延迟增加风险
  • 配额与成本:短信按段计费,国际费率差异大;未明确说明 API 调用频次限制
  • 连接管理复杂:多账户场景需手动指定 connection_id,易出错
  • 数据隐私:通话录音、转录文本经过第三方代理,敏感行业需合规评估
  • 功能边界:仅覆盖 Quo 核心 API,不支持高级路由或自定义 IVR 配置

适合人群

  • 中小企业需要自动化 SMS 通知、客户跟进流程
  • 销售/客服团队希望批量导出通话记录与转录用于质检
  • 开发者构建 CRM 集成,同步联系人信息与通话历史
  • 需要多账户管理的代理商或代运营服务商

常规风险

  • 密钥泄露风险MATON_API_KEY 泄露可导致全部 Quo 账户被滥用
  • 误操作风险:删除联系人、发送错误消息等写操作不可逆
  • 费用失控:大量短信发送或国际通话可能产生意外账单
  • OAuth 会话失效:连接状态需定期检查,过期会导致服务中断
  • 数据驻留合规:录音与转录数据存储位置未明确说明,跨境业务需谨慎

安全解读

核心用法

quo 是由 Maton 官方提供的商业电话系统 API 集成 Skill,通过代理层对接 Quo(原 OpenPhone)服务。用户需先在 maton.ai 获取 MATON_API_KEY 并完成 OAuth 授权,即可通过标准化 REST API 管理商务通信:

  • 短信发送:支持 1600 字符内的 SMS,按段计费(美加 $0.01/段)
  • 通话管理:查询通话记录、获取录音/语音信箱/转录文本
  • 联系人管理:创建、更新、删除联系人及自定义字段
  • 会话跟踪:管理对话状态与分配

所有请求通过 api.maton.ai/quo/{endpoint} 代理,自动注入 OAuth Token,需携带 User-Agent: Maton/1.0 头。

显著优点

1. 托管式 OAuth:无需自行处理令牌刷新,Maton 代理层自动管理授权生命周期
2. 完整 API 覆盖:涵盖 Quo 核心功能(消息、通话、联系人、录音、转录)

3. 安全设计:API Key 从环境变量读取,无硬编码凭证;写操作需用户显式确认

4. 多语言示例:提供 Bash、Python、JavaScript 完整代码片段,快速上手

5. 分页与错误处理:标准化 token 分页机制,详细的 HTTP 状态码说明

潜在缺点与局限性

  • 外部依赖:功能完全依赖 Maton 代理服务与 Quo API,任一方故障将导致服务中断
  • 地域计费差异:国际短信费率未明确公示,可能产生意外费用
  • 单参与者限制:通话列表查询仅支持 1 对 1 会话,不支持多方通话筛选
  • 密钥管理责任:用户需自行安全存储 MATON_API_KEY,泄露风险由用户承担
  • 无实时推送:仅支持轮询 API,无 WebSocket 或 webhook 实时通知机制

适合人群

  • 中小企业主:需要程序化发送预约提醒、订单通知等商务短信
  • 客服团队:批量导出通话记录与转录文本进行质量分析
  • 开发者:快速集成商务电话功能至 CRM、ERP 等内部系统
  • 远程办公团队:统一管理多成员的企业电话号码与通信记录

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **密钥泄露** | 环境变量配置不当导致 API Key 暴露 | 使用专用密钥、定期轮换、配置使用限额 |
| **费用失控** | 短信发送或国际通话产生意外账单 | 在 Maton 后台设置预算上限与告警 |
| **授权滥用** | OAuth 连接被恶意利用访问商务数据 | 定期审查授权连接,移除闲置授权 |
| **数据滞留** | 通话录音、转录文本在第三方存储 | 评估 Quo/Maton 数据保留策略是否符合合规要求 |

Quo 内容

手动下载zip · 4.5 kB
SKILL.mdtext/markdown
请选择文件