---

name: activecampaign-automation description: "通过 Rube MCP (Composio) 自动化 ActiveCampaign 任务：管理联系人、标签、列表订阅、自动化注册和任务。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 ActiveCampaign 自动化

通过 Composio 的 ActiveCampaign 工具包经由 Rube MCP 自动化 ActiveCampaign CRM 和营销自动化操作。

前置条件

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

设置

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

1. 通过确认 `RUBE_SEARCH_TOOLS` 有响应来验证 Rube MCP 可用
2. 使用工具包 `active_campaign` 调用 `RUBE_MANAGE_CONNECTIONS`
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 ActiveCampaign 认证
4. 在运行任何工作流之前确认连接状态显示为 ACTIVE

核心工作流

1. 创建和查找联系人

何时使用：用户想要创建新联系人或查找现有联系人

工具调用顺序：

1. `ACTIVE_CAMPAIGN_FIND_CONTACT` - 搜索现有联系人 [可选]
2. `ACTIVE_CAMPAIGN_CREATE_CONTACT` - 创建新联系人 [必需]

查找的关键参数：

• `email`：按邮箱地址搜索
• `id`：按 ActiveCampaign 联系人 ID 搜索
• `phone`：按电话号码搜索

创建的关键参数：

• `email`：联系人邮箱地址（必填）
• `first_name`：联系人名字
• `last_name`：联系人姓氏
• `phone`：联系人电话号码
• `organization_name`：联系人所属组织
• `job_title`：联系人职位
• `tags`：要应用的标签，逗号分隔

注意事项：

• `email` 是创建联系人唯一的必填字段
• 电话搜索内部使用通用搜索参数；可能返回部分匹配结果
• 在 FIND_CONTACT 中组合 `email` 和 `phone` 时，结果在客户端过滤
• 创建时提供的标签会立即应用
• 使用已存在的邮箱创建联系人可能会更新现有联系人

2. 管理联系人标签

何时使用：用户想要为联系人添加或移除标签

工具调用顺序：

1. `ACTIVE_CAMPAIGN_FIND_CONTACT` - 通过邮箱或 ID 查找联系人 [前置条件]
2. `ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG` - 添加或移除标签 [必需]

关键参数：

• `action`：'Add' 或 'Remove'（必填）
• `tags`：标签名称，逗号分隔字符串或字符串数组（必填）
• `contact_id`：联系人 ID（提供此项或 contact_email）
• `contact_email`：联系人邮箱地址（contact_id 的替代项）

注意事项：

• `action` 值首字母大写：'Add' 或 'Remove'（非小写）
• 标签可以是逗号分隔字符串（'tag1, tag2'）或数组（['tag1', 'tag2']）
• 必须提供 `contact_id` 或 `contact_email`；`contact_id` 优先
• 添加不存在的标签会自动创建该标签
• 移除不存在的标签不会报错（静默操作）

3. 管理列表订阅

何时使用：用户想要为联系人订阅或取消订阅列表

工具调用顺序：

1. `ACTIVE_CAMPAIGN_FIND_CONTACT` - 查找联系人 [前置条件]
2. `ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION` - 订阅或取消订阅 [必需]

关键参数：

• `action`：'subscribe' 或 'unsubscribe'（必填）
• `list_id`：数字列表 ID 字符串（必填）
• `email`：联系人邮箱地址（提供此项或 contact_id）
• `contact_id`：数字联系人 ID 字符串（email 的替代项）

注意事项：

• `action` 值为小写：'subscribe' 或 'unsubscribe'
• `list_id` 是数字字符串（如 '2'），不是列表名称
• 列表 ID 可通过 GET /api/3/lists 端点获取（不作为 Composio 工具提供；使用 ActiveCampaign UI）
• 如果同时提供 `email` 和 `contact_id`，`contact_id` 优先
• 取消订阅会将状态更改为 '2'（已取消订阅），但关系记录仍保留

4. 将联系人添加到自动化

何时使用：用户想要将联系人注册到自动化工作流中

工具调用顺序：

1. `ACTIVE_CAMPAIGN_FIND_CONTACT` - 验证联系人存在 [前置条件]
2. `ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION` - 将联系人注册到自动化 [必需]

关键参数：

• `contact_email`：要注册的联系人邮箱（必填）
• `automation_id`：目标自动化的 ID（必填）

注意事项：

• 联系人必须已存在于 ActiveCampaign 中
• 自动化只能通过 ActiveCampaign UI 创建，不能通过 API
• `automation_id` 必须引用一个已存在的活跃自动化
• 该工具执行两步操作：通过邮箱查找联系人，然后注册
• 自动化 ID 可在 ActiveCampaign UI 或通过 GET /api/3/automations 找到

5. 创建联系人任务

何时使用：用户想要为联系人创建后续任务

工具调用顺序：

1. `ACTIVE_CAMPAIGN_FIND_CONTACT` - 查找联系人 [前置条件]
2. `ACTIVE_CAMPAIGN_CREATE_TASK` - 创建任务 [必需]

关键参数：

• `title`：任务标题（必填）
• `contact_id`：关联的联系人 ID（必填）
• `due_date`：截止日期
• `note`：任务备注