brevo-automation

通过 Rube MCP 自动化 Brevo

通过 Rube MCP 使用 Composio 的 Brevo 工具包，自动执行 Brevo（原 Sendinblue）电子邮件营销操作。

工具包文档：composio.dev/toolkits/brevo

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 Brevo 连接，工具包为 brevo
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 是否可用
2. 调用 RUBE_MANAGE_CONNECTIONS，并指定工具包 brevo
3. 如果连接状态不是 ACTIVE，请按照返回的授权链接完成 Brevo 身份验证
4. 运行任何工作流前，确认连接状态为 ACTIVE

核心工作流

1. 管理电子邮件营销活动

适用场景：用户想要列出、查看或更新电子邮件营销活动

工具调用顺序：

1. BREVO_LIST_EMAIL_CAMPAIGNS - 使用筛选条件列出所有营销活动 [必需]
2. BREVO_UPDATE_EMAIL_CAMPAIGN - 更新营销活动内容或设置 [可选]

列表查询的关键参数：

• type：营销活动类型（'classic' 或 'trigger'）
• status：营销活动状态（'suspended'、'archive'、'sent'、'queued'、'draft'、'inProcess'、'inReview'）
• startDate/endDate：日期范围筛选条件（格式为 YYYY-MM-DDTHH:mm:ss.SSSZ）
• statistics：要包含的统计数据类型（'globalStats'、'linksStats'、'statsByDomain'）
• limit：每页结果数（最大值为 100，默认值为 50）
• offset：分页偏移量
• sort：排序顺序（'asc' 或 'desc'）
• excludeHtmlContent：设为 true 以减小响应大小

更新的关键参数：

• campaign_id：数字格式的营销活动 ID（必需）
• name：营销活动名称
• subject：电子邮件主题行
• htmlContent：HTML 电子邮件正文（不能与 htmlUrl 同时使用）
• htmlUrl：HTML 内容的网址
• sender：包含 name、email 或 id 的发件人对象
• recipients：包含 listIds 和 exclusionListIds 的对象
• scheduledAt：计划发送时间（格式为 YYYY-MM-DDTHH:mm:ss.SSSZ）

注意事项：

• startDate 和 endDate 必须同时提供，或都不提供
• 只有在未传入 status 或将其设为 'sent' 时，日期筛选条件才有效
• htmlContent 和 htmlUrl 不能同时使用
• 营销活动的 sender 邮箱必须是 Brevo 中已验证的发件人
• A/B 测试字段（subjectA、subjectB、splitRule、winnerCriteria）需要设置 abTesting: true
• scheduledAt 使用包含时区的完整 ISO 8601 格式

2. 创建和管理电子邮件模板

适用场景：用户想要创建、编辑、列出或删除电子邮件模板

工具调用顺序：

1. BREVO_GET_ALL_EMAIL_TEMPLATES - 列出所有模板 [必需]
2. BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE - 创建新模板或更新现有模板 [必需]
3. BREVO_DELETE_EMAIL_TEMPLATE - 删除未启用的模板 [可选]

列表操作的关键参数：

• templateStatus：筛选已启用（true）或未启用（false）的模板
• limit：每页结果数（最大 1000，默认 50）
• offset：分页偏移量
• sort：排序顺序（'asc' 或 'desc'）

创建/更新操作的关键参数：

• templateId：提供此参数可更新模板；省略则创建新模板
• templateName：模板显示名称（创建时必需）
• subject：电子邮件主题行（创建时必需）
• htmlContent：HTML 模板正文（至少 10 个字符；使用此参数或 htmlUrl）
• sender：包含 name 和 email 的发件人对象，或 id（创建时必需）
• replyTo：回复地址
• isActive：启用或停用模板
• tag：模板的类别标签

注意事项：

• 提供 templateId 时，工具会更新模板；省略时则会创建模板
• 创建时必须提供 templateName、subject 和 sender
• htmlContent 至少需要 10 个字符
• 模板个性化使用 {{contact.ATTRIBUTE}} 语法
• 只能删除未启用的模板
• htmlContent 和 htmlUrl 不能同时使用

3. 管理发件人

适用场景：用户想要查看已授权的发件人身份

工具调用顺序：

1. BREVO_GET_ALL_SENDERS - 列出所有已验证的发件人 [必需]

关键参数：（无必需参数）

注意事项：

• 发件人必须经过验证，才能用于营销活动或模板
• 发件人验证需通过 Brevo 网页界面完成，无法通过 API 完成
• 发件人 ID 可用于营销活动和模板中的 sender.id 字段

4. 配置 A/B 测试营销活动

适用场景：用户想要为营销活动设置或修改 A/B 测试参数

工具调用顺序：

1. BREVO_LIST_EMAIL_CAMPAIGNS - 查找目标营销活动 [前置步骤]
2. BREVO_UPDATE_EMAIL_CAMPAIGN - 配置 A/B 测试参数 [必需]

关键参数：

• campaign_id：要配置的营销活动
• abTesting：设为 true 以启用 A/B 测试
• subjectA：A 版本的主题行
• subjectB：B 版本的主题行
• splitRule：测试的百分比分配比例（1-99）
• winnerCriteria：用于确定胜出版本的 'open' 或 'click'
• winnerDelay：选出胜出版本前的等待小时数（1-168）

注意事项：

• 设置版本字段之前，必须先启用 A/B 测试（abTesting: true）
• splitRule 是收到 A 版本的联系人所占百分比
• winnerDelay 定义测试时长，测试结束后会将胜出版本发送给其余联系人
• 仅适用于 'classic' 类型的营销活动

常见模式

营销活动生命周期

1. Create campaign (status: draft)
2. Set recipients (listIds)
3. Configure content (htmlContent or htmlUrl)
4. Optionally schedule (scheduledAt)
5. Send or schedule via Brevo UI (API update can set scheduledAt)

分页

• 使用 limit（每页大小）和 offset（起始索引）
• 默认 limit 为 50；最大值因端点而异（营销活动为 100，模板为 1000）
• 每翻一页，将 offset 增加 limit
• 检查响应中的 count 以确定可用结果总数

模板个性化

- First name: {{contact.FIRSTNAME}}
- Last name: {{contact.LASTNAME}}
- Custom attribute: {{contact.CUSTOM_ATTRIBUTE}}
- Mirror link: {{mirror}}
- Unsubscribe link: {{unsubscribe}}

已知注意事项

日期格式：

• 所有日期均使用带毫秒的 ISO 8601 格式：YYYY-MM-DDTHH:mm:ss.SSSZ
• 在日期时间格式中传入时区，以确保结果准确
• startDate 和 endDate 必须同时使用

发件人验证：

• 所有发件人电子邮件地址都必须先在 Brevo 中验证，才能使用
• 未经验证的发件人会导致创建/更新营销活动失败
• 使用 GET_ALL_SENDERS 检查可用的已验证发件人

速率限制：

• Brevo API 的速率限制取决于账户套餐
• 收到 429 响应时实施退避策略
• 模板操作的限制低于读取操作

响应解析：

• 响应数据可能嵌套在 data 或 data.data 下
• 使用回退模式进行稳健解析
• 营销活动 ID 和模板 ID 均为数字整数

快速参考

任务	工具标识	关键参数
列出营销活动	BREVO_LIST_EMAIL_CAMPAIGNS	type, status, limit, offset
更新营销活动	BREVO_UPDATE_EMAIL_CAMPAIGN	campaign_id, subject, htmlContent
列出模板	BREVO_GET_ALL_EMAIL_TEMPLATES	templateStatus, limit, offset
创建模板	BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE	templateName, subject, htmlContent, sender
更新模板	BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE	templateId, htmlContent
删除模板	BREVO_DELETE_EMAIL_TEMPLATE	templateId
列出发件人	BREVO_GET_ALL_SENDERS	（无）

---

由 Composio 提供支持