activecampaign-automation

通过 Rube MCP 实现 ActiveCampaign 自动化

通过 Rube MCP 使用 Composio 的 ActiveCampaign 工具包，自动执行 ActiveCampaign CRM 和营销自动化操作。

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

先决条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 ActiveCampaign 连接，并使用工具包 active_campaign
• 始终先调用 RUBE_SEARCH_TOOLS，以获取最新的工具架构

设置

获取 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 界面）
• 如果同时提供 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 必须指向一个现有且处于启用状态的自动化流程
• 该工具分两步执行：先按邮箱查找联系人，再将其加入自动化流程
• 可以在 ActiveCampaign UI 中或通过 GET /api/3/automations 查找自动化流程 ID

5. 创建联系人任务

适用场景：用户希望创建与联系人关联的后续任务

工具调用顺序：

1. ACTIVE_CAMPAIGN_FIND_CONTACT - 查找要与任务关联的联系人 [前置条件]
2. ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK - 创建任务 [必需]

关键参数：

• relid：要与任务关联的联系人 ID（必需）
• duedate：采用带时区的 ISO 8601 格式的截止日期（必需，例如 '2025-01-15T14:30:00-05:00'）
• dealTasktype：根据可用类型指定的任务类型 ID（必需）
• title：任务标题
• note：任务描述/内容
• assignee：被指派任务的用户 ID
• edate：采用 ISO 8601 格式的结束日期（必须晚于 duedate）
• status：0 表示未完成，1 表示已完成

注意事项：

• duedate 必须是带时区偏移量的有效 ISO 8601 日期时间；请勿使用占位值
• edate 必须晚于 duedate
• dealTasktype 是引用 ActiveCampaign 中配置的任务类型的字符串 ID
• relid 是数字形式的联系人 ID，不是邮箱地址
• assignee 是用户 ID；请通过 ActiveCampaign UI 将用户名解析为 ID

常见模式

联系人查找流程

1. Call ACTIVE_CAMPAIGN_FIND_CONTACT with email
2. If found, extract contact ID for subsequent operations
3. If not found, create contact with ACTIVE_CAMPAIGN_CREATE_CONTACT
4. Use contact ID for tags, subscriptions, or automations

批量为联系人添加标签

1. For each contact, call ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG
2. Use contact_email to avoid separate lookup calls
3. Batch with reasonable delays to respect rate limits

ID 解析

联系人邮箱 -> 联系人 ID：

1. Call ACTIVE_CAMPAIGN_FIND_CONTACT with email
2. Extract id from the response

已知注意事项

操作名称的大小写：

• 标签操作：'Add'、'Remove'（首字母大写）
• 订阅操作：'subscribe'、'unsubscribe'（小写）
• 大小写混用会导致错误

ID 类型：

• 联系人 ID：数字字符串（例如 '123'）
• 列表 ID：数字字符串
• 自动化流程 ID：数字字符串
• 所有 ID 都应以字符串而非整数形式传入

自动化流程：

• 不能通过 API 创建自动化流程；只能将联系人加入自动化流程
• 自动化流程必须处于启用状态才能接收新联系人
• 将已在自动化流程中的联系人再次加入可能不会产生任何效果

速率限制：

• ActiveCampaign API 对每个账户设有速率限制
• 收到 429 响应时应实施退避策略
• 应合理安排批量操作的间隔

响应解析：

• 响应数据可能嵌套在 data 或 data.data 下
• 应使用带回退模式的防御性解析
• 联系人搜索可能返回多个结果；请按邮箱匹配以确保准确性

快速参考

任务	工具标识	关键参数
查找联系人	ACTIVE_CAMPAIGN_FIND_CONTACT	email, id, phone
创建联系人	ACTIVE_CAMPAIGN_CREATE_CONTACT	email, first_name, last_name, tags
添加/移除标签	ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG	action, tags, contact_email
订阅/取消订阅	ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION	action, list_id, email
添加到自动化流程	ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION	contact_email, automation_id
创建任务	ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK	relid, duedate, dealTasktype, title

---

由 Composio 提供支持