brevo

核心用法

brevo skill 是一个纯文档型 API 集成工具，通过 Maton 网关代理访问 Brevo（原 Sendinblue）邮件营销平台。用户需先在 maton.ai 获取 API key 并完成 OAuth 授权，即可通过标准 HTTP 请求调用 Brevo v3 API 的全部功能。主要功能模块包括：账户管理、联系人/列表/文件夹的 CRUD 操作、自定义属性管理、事务性邮件发送、邮件模板管理、营销活动创建与发送、发送者管理以及阻止列表控制。

使用流程分为三步：配置 MATON_API_KEY 环境变量、在 ctrl.maton.ai 创建 Brevo OAuth 连接、通过 gateway.maton.ai 发起 API 请求。支持多连接管理，可通过 Maton-Connection 头部指定特定连接。

显著优点

安全架构设计：采用 OAuth 2.0 + API Key 双层认证，用户 Brevo 凭证由 Maton 网关托管，skill 本身不存储任何敏感信息，从根本上杜绝凭证泄露风险。

功能覆盖全面：完整封装 Brevo v3 API，涵盖邮件营销全链路——从联系人管理、列表细分、模板设计到营销活动执行和效果追踪，满足企业级邮件营销需求。

零代码依赖：纯 Markdown 文档型 skill，无可执行代码，无第三方依赖，部署简单，兼容任何支持 HTTP 请求的编程环境。

网关增值能力：Maton 网关自动处理 OAuth token 注入、请求转发和 rate limit 监控，降低集成复杂度。

潜在缺点与局限性

平台锁定风险：完全依赖 Maton 网关服务（gateway.maton.ai 和 ctrl.maton.ai），若该服务不可用或政策变更，将直接影响 skill 功能。

网络依赖性强：所有操作均需实时联网，无法离线使用；且需同时保证与 Maton 网关和 Brevo API 的网络连通性。

功能边界限制：作为代理网关模式，部分 Brevo 高级功能（如 Webhook 配置、自定义域名验证）可能需要直接在 Brevo 控制台操作。

Rate Limit 约束：免费版 Brevo 账户限制 300 次/分钟，大规模数据同步或批量邮件发送场景下可能成为瓶颈。

适合的目标群体

• 中小企业营销团队：需要快速搭建邮件营销系统，但缺乏专业开发资源
• SaaS 产品经理：需集成事务性邮件（注册确认、密码重置、通知推送）到应用工作流
• 自动化工程师：构建联系人同步、营销自动化等数据管道
• 电商运营人员：管理客户列表、执行促销邮件活动、追踪营销效果

使用风险

误操作风险：技能支持真实的邮件发送、联系人删除等操作，测试时建议使用专门的测试列表，避免向真实用户发送测试内容。

凭证管理风险：MATON_API_KEY 需通过环境变量注入，若泄露可能导致账户被滥用；建议定期轮换密钥并限制 IP 访问范围。

数据合规风险：联系人数据流经 Maton 网关并存储于 Brevo 平台，涉及 GDPR、CCPA 等隐私法规时需确认数据处理协议（DPA）覆盖范围。

服务连续性风险：依赖 Maton 平台的商业可持续性，建议评估供应商稳定性并制定备选方案。