核心功能与用法
Brevo Skill 是 Maton AI 提供的托管式 API 网关，将 Brevo（原 Sendinblue）的邮件营销平台能力封装为标准化 REST API。用户仅需 Maton API Key，无需管理 OAuth 令牌或 Brevo 原生凭证，即可调用完整功能集。
核心能力覆盖：
- 事务邮件：单封/批量发送，支持 HTML/纯文本双格式、附件、定时投递、模板变量（
{{params.name}}语法） - 联系人管理：CRUD 操作、自定义属性（UPPERCASE 命名）、黑名单管理、分群标签
- 列表与文件夹：订阅列表生命周期管理、文件夹层级组织、批量增删联系人
- 营销自动化：邮件模板设计、营销活动（Campaign）创建与调度、A/B 测试支持
- 数据分析：送达统计、打开率/点击率追踪、事件日志查询
接入方式：所有请求经由 https://gateway.maton.ai/brevo/v3/ 代理，Maton 自动注入 OAuth Token。支持 Maton-Connection 头部指定多账户场景。
显著优势
1. 零凭证管理：OAuth 授权由 Maton 托管，避免令牌泄露风险与过期维护负担
2. 完整功能映射：覆盖 Brevo v3 API 的 50+ 端点，从基础发送到高级营销自动化无缺口
3. 多语言示例：官方提供 Python、JavaScript、cURL 完整代码片段，开箱即用
4. 企业级特性：支持 SMTP Relay 配置、发件人域名验证、阻止列表管理、速率限制透明化（x-sib-ratelimit-* 头部）
5. 灵活分页：标准 offset/limit 分页，单页最大 500 条，适合大规模数据同步
局限性与注意事项
- 速率限制：免费套餐 300 请求/分钟，高频场景需升级或实施客户端退避
- 属性命名强制大写：
FIRSTNAME等属性名必须全大写，易因大小写错误导致数据丢失 - 发件人验证依赖：外部发件地址需预先在 Brevo 控制台完成验证，无法通过 API 自动绕过
- 模板编辑限制：HTML 模板需自行编写，无可视化拖拽编辑器集成
- 环境变量依赖：
MATON_API_KEY必须在运行时可用，管道（pipe）场景存在变量展开风险（文档已警示）
适合人群
- SaaS 产品团队：需快速集成事务邮件（注册确认、密码重置、通知推送）
- 营销运营人员：通过 API 自动化邮件列表管理、活动创建与效果追踪
- 数据工程师：批量联系人同步、CRM 数据打通、营销归因分析
- 开发者工具链：构建内部邮件管理后台、客户成功自动化工作流
常规风险评估
| 风险类别 | 等级 | 说明 |
|---------|------|------|
| 数据泄露 | 中 | Maton 托管 OAuth 降低凭证泄露面，但 API Key 本身需妥善保管 |
| 误操作群发 | 中 | 缺少预发送二次确认，测试环境配置错误可能导致真实用户收到邮件 |
| 速率超限 | 低 | 明确的限速头部与 429 响应，可编程处理 |
| 供应商锁定 | 低 | 标准 REST 封装，迁移至原生 Brevo API 成本可控 |
| 合规性 | 中 | 需自行确保 GDPR/CCPA 同意记录管理，API 层面不提供合规自动化 |
建议：生产环境启用独立 Maton 连接（Connection）隔离测试/生产数据，配合 updateEnabled 参数谨慎处理联系人更新，避免意外覆盖用户偏好。