核心用法
Brevo skill 是 Maton 平台提供的 Brevo API 网关封装，通过 gateway.maton.ai 代理访问 Brevo 原生 API，支持完整的邮件营销与 CRM 工作流。用户需先获取 Maton API Key 并在 ctrl.maton.ai 完成 OAuth 授权建立连接。
主要功能模块：
- 事务邮件：通过
/smtp/email发送单封邮件，支持模板、附件、定时发送 - 联系人管理：CRUD 操作联系人，支持列表/文件夹组织，自定义属性（FIRSTNAME 等）
- 邮件营销：创建经典或触发式邮件活动（Campaign），管理发送状态
- 模板系统：创建 HTML 模板，使用
{{params.name}}语法实现动态内容 - 数据统计：查询邮件送达、打开、点击、退回等事件统计
技术特点：
- 自动注入 OAuth Token，无需直接管理 Brevo 凭证
- 支持多连接切换（
Maton-Connection头部） - 标准 offset 分页，limit 最大 500
- 统一返回格式，PUT/DELETE 返回 204
显著优点
1. 托管安全：OAuth 授权由 Maton 托管，避免 API Key 泄露风险
2. 功能完整：覆盖 Brevo 官方 v3 API 绝大部分能力，非阉割版
3. 多语言示例：提供 Bash/cURL、Python、JavaScript 完整代码
4. 连接管理：支持多账户切换，适合代理运营场景
潜在缺点与局限性
- 依赖 Maton 平台：若 Maton 服务中断则完全不可用，存在单点故障
- 速率限制：免费计划 300 次/分钟，大规模发送需升级 Brevo 账户
- 无实时 webhook：需轮询查询状态，无推送通知机制
- 模板语法限制：仅支持 Brevo 原生
{{params}}语法，无高级逻辑
适合人群
- 需要自动化发送事务邮件的开发者（订单确认、密码重置等）
- 中小型企业进行邮件营销campaign管理
- 已使用 Maton 生态、希望统一 API 网关管理的团队
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | `MATON_API_KEY` 若泄露可导致账户被滥用 | 使用环境变量，避免硬编码；定期轮换密钥 |
| 误发邮件 | 错误的收件人列表或模板参数导致错发 | 正式发送前使用 `sendTest` 功能验证 |
| 退信与信誉受损 | 高频发送或低质量列表导致域名/IP 被拉黑 | 维护退信列表，遵循 Brevo 发送最佳实践 |
| 数据合规 | 联系人数据涉及 GDPR/CCPA 等法规 | 确保获得明确同意，支持退订功能 |
| 服务商依赖 | Maton 或 Brevo 单方面调整服务条款 | 保留数据导出能力，关注服务状态页 |