---

name: klaviyo-automation description: "通过Rube MCP（Composio）自动化Klaviyo任务：管理邮件/短信营销活动、检查活动消息、跟踪标签和监控发送任务。始终先搜索工具获取当前schema。" risk: safe source: community date_added: "2026-02-27"

通过Rube MCP实现Klaviyo自动化

通过Composio的Klaviyo工具包经由Rube MCP自动化Klaviyo邮件和短信营销操作。

前置条件

• Rube MCP必须已连接（RUBE_SEARCH_TOOLS可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用toolkit klaviyo 建立活跃的Klaviyo连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具schema

设置

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

1. 确认 RUBE_SEARCH_TOOLS 响应来验证Rube MCP可用
2. 使用toolkit klaviyo 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是ACTIVE状态，按照返回的认证链接完成Klaviyo认证
4. 确认连接状态显示ACTIVE后再运行任何工作流

核心工作流

1. 列出和过滤营销活动

何时使用：用户想要浏览、搜索或过滤营销活动

工具序列：

1. KLAVIYO_GET_CAMPAIGNS - 使用渠道和状态过滤器列出活动 [必需]

关键参数：

• channel：活动渠道 - 'email' 或 'sms'（Klaviyo API要求）
• filter：额外过滤字符串（如 equals(status,"draft")）
• sort：排序字段，可选 - 前缀表示降序（如 '-created_at'、'name'）
• page_cursor：下一页的分页游标
• include_archived：包含已归档活动（默认：false）

注意事项：

• channel 是必需的；省略可能产生不完整或意外的结果
• 分页是获取完整数据的必要条件；单次调用只返回一页（默认约10条）
• 跟踪 page_cursor 直到耗尽以获取所有活动
• 通过 filter 进行状态过滤可能返回混合状态；始终在客户端验证 data[].attributes.status
• 状态字符串区分大小写，可以是复合的（如 'Cancelled: No Recipients'）
• 响应结构是嵌套的：response.data.data，状态在 data[].attributes.status

2. 获取活动详情

何时使用：用户想要特定活动的详细信息

工具序列：

1. KLAVIYO_GET_CAMPAIGNS - 查找活动获取其ID [前置]
2. KLAVIYO_GET_CAMPAIGN - 获取完整活动详情 [必需]

关键参数：

• campaign_id：活动ID字符串（如 '01GDDKASAP8TKDDA2GRZDSVP4H'）
• include_messages：在响应中包含活动消息
• include_tags：在响应中包含标签

注意事项：

• 活动ID是字母数字字符串，不是数字
• include_messages 和 include_tags 通过Klaviyo的include机制向响应添加相关数据
• 活动详情包括受众、发送策略、跟踪选项和调度信息

3. 检查活动消息

何时使用：用户想要查看活动的邮件/短信内容

工具序列：

1. KLAVIYO_GET_CAMPAIGN - 查找活动及其消息ID [前置]
2. KLAVIYO_GET_CAMPAIGN_MESSAGE - 获取消息内容详情 [必需]

关键参数：

• id：消息ID字符串
• fields__campaign__message：消息属性的稀疏字段集（如 'content.subject'、'content.from_email'、'content.body'）
• fields__campaign：活动属性的稀疏字段集
• fields__template：模板属性的稀疏字段集
• include：要包含的相关资源（'campaign'、'template'）

注意事项：

• 消息ID与活动ID不同；从活动响应中提取
• 稀疏字段集语法使用点号表示嵌套字段：'content.subject'、'content.from_email'
• 邮件消息有内容字段：subject、preview_text、from_email、from_label、reply_to_email
• 短信消息有内容字段：body
• 包含 'template' 提供邮件的HTML/文本内容

4. 管理活动标签

何时使用：用户想要查看与活动关联的标签以进行组织

工具序列：

1. KLAVIYO_GET_CAMPAIGN_RELATIONSHIPS_TAGS - 获取活动的标签ID [必需]

关键参数：

• id：活动ID字符串

注意事项：

• 仅返回标签ID，不返回标签名称/详情
• 标签ID可与Klaviyo的标签端点配合使用获取完整详情
• 速率限制：突发3/秒，稳定60/分钟（比其他端点更严格）

5. 监控活动发送任务

何时使用：用户想要检查活动发送操作的状态

工具序列：

1. KLAVIYO_GET_CAMPAIGN_SEND_JOB - 检查发送任务状态 [必需]

关键参数：

• id：发送任务ID

注意事项：

• 发送任务ID在发起活动发送时返回
• 任务状态指示发送是排队中、进行中、完成还是失败
• 速率限制：突发10/秒，稳定150/分钟

通用注意事项

• 所有Klaviyo API调用都有速率限制——在批量操作之间添加适当延迟
• 活动ID和消息ID是不同的实体——不要混淆
• 始终先使用 RUBE_SEARCH_TOOLS 验证当前可用的工具和参数schema
• Klaviyo的API使用JSON:API规范——响应结构是嵌套的 data.attributes 格式