Quo API 集成服务，通过托管 OAuth 管理企业电话系统的通话、短信、联系人与对话记录，支持消息发送与通话检索。
说明：
# Quo 企业电话系统集成服务
## 核心用法
Quo 技能是 Maton 提供的 Quo API 代理服务，通过托管 OAuth 认证让用户无需直接管理令牌即可访问企业电话系统功能。核心操作包括：
– **消息管理**：发送 SMS（支持 1600 字符，美国/加拿大 $0.01/条）、查询消息历史、管理对话状态
– **通话管理**：列出来电记录、获取通话详情、下载录音与转录文本、访问语音邮件
– **联系人管理**：创建、更新、删除联系人，支持自定义字段与多来源数据
– **号码与用户**：管理企业电话号码、查询用户权限与角色
所有请求通过 `https://api.maton.ai/quo/{path}` 代理转发，自动注入 OAuth 令牌。需设置 `MATON_API_KEY` 环境变量，并在请求头中包含 `Authorization: Bearer $MATON_API_KEY` 和 `User-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 会话失效**：连接状态需定期检查，过期会导致服务中断
– **数据驻留合规**：录音与转录数据存储位置未明确说明，跨境业务需谨慎
