核心用法
Zoho Mail Skill 是 Maton 平台提供的托管式 OAuth 网关服务，允许开发者通过单一 API Key 调用完整的 Zoho Mail 原生 API。使用时需先在 ctrl.maton.ai 创建 OAuth 连接，获取 connection_id 后，即可通过 gateway.maton.ai/zoho-mail 代理端点执行所有邮件操作。
关键操作流程：
1. 注册 Maton 账号并获取 MATON_API_KEY
2. 调用连接管理 API 创建 Zoho Mail OAuth 连接
3. 浏览器打开返回的授权 URL 完成 OAuth
4. 通过 Authorization: Bearer $MATON_API_KEY 调用邮件 API
支持的核心操作：
- 账户管理：获取所有邮箱账户信息
- 文件夹操作：创建、重命名、删除文件夹，支持 Inbox/Drafts/Sent 等系统文件夹
- 标签管理：自定义标签的 CRUD 操作
- 邮件全生命周期：发送/回复/草稿保存、搜索（支持 from: 等语法）、已读标记、移动、归档、标星/标记重要、删除
- 附件处理：上传、下载、获取元信息
- 高级功能：定时发送、邮件线程管理、MIME 原始消息获取
显著优点
1. 零 OAuth 运维成本
Maton 托管全部 OAuth 流程，开发者无需实现 token 刷新、scope 管理或授权回调服务器。多账户场景通过 Maton-Connection 头部即可切换，默认自动回退到最早创建的活跃连接。
2. 原生 API 完整透传
代理层仅做身份注入，请求路径和响应格式与 Zoho 官方完全一致，可直接复用 Zoho 官方文档和 SDK 逻辑。
3. 多语言即拿即用示例
文档内置 Bash/Python/JavaScript 完整代码片段，涵盖从连接创建到邮件发送的全流程，降低接入门槛。
潜在缺点与局限性
1. 强依赖第三方平台可用性
所有流量经过 gateway.maton.ai 和 ctrl.maton.ai，若 Maton 服务中断或停止运营，技能立即失效。Zoho 原生 API 的直接访问能力被完全封装，无法降级绕过。
2. 权限边界由平台管控
OAuth scope 由 Maton 预先申请，若需额外权限（如某些标签管理操作），必须联系 support@maton.ai 人工开通，无法自助配置。文档明确提示 INVALID_OAUTHSCOPE 错误需走人工支持流程。
3. 连接管理复杂度
多账户场景需手动维护 connection_id 与账户的映射关系，文档未提供账户别名字段，实际调用时易混淆。
4. 网络与地域限制
服务依赖 Maton 网关的网络可达性，部分地区可能存在访问延迟或阻断风险。
适合人群
- 需快速集成 Zoho Mail 但不愿自建 OAuth 基础设施的中小企业开发者
- 已有 Maton 生态使用经验、希望统一管理多 SaaS API 密钥的技术团队
- 自动化工作流场景（如 CI/CD 邮件通知、客服工单自动回复）
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 密钥泄露 | `MATON_API_KEY` 泄露可导致账户被完全控制 | 使用环境变量注入，避免硬编码；定期轮换密钥 |
| 授权劫持 | OAuth 授权 URL 被中间人截获 | 确保在 HTTPS 环境下完成授权，及时删除测试连接 |
| 供应商锁定 | 深度依赖 Maton 网关架构 | 保留 Zoho 原生 API 调用能力作为灾备方案 |
| 数据合规 | 邮件内容流经第三方代理 | 敏感行业需评估 Maton 数据处理协议（DPA）是否符合 GDPR/SOC2 要求 |