通过Rube MCP实现ActiveCampaign自动化

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

先决条件

• 必须已连接Rube MCP（确保RUBE_SEARCH_TOOLS可用）
• 通过以下方式建立有效的ActiveCampaign连接RUBE_MANAGE_CONNECTIONS并使用工具包active_campaign
• 请始终首先调用RUBE_SEARCH_TOOLS以获取当前工具的模式信息

设置

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

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

核心工作流

1. 创建和查找联系人

使用时机：用户希望创建新联系人或查找现有联系人

工具序列：

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

查找关键参数：

• 电子邮件：通过电子邮件地址搜索
• ID：通过ActiveCampaign联系人ID搜索
• 电话：通过电话号码搜索

创建的关键参数:

• 电子邮箱: 联系人的电子邮箱地址（必填）
• 名字: 联系人的名字
• 姓氏: 联系人的姓氏
• 电话: 联系人的电话号码
• 公司名称: 联系人的公司
• 职位头衔: 联系人的职位头衔
• 标签: 要应用的标签列表（以逗号分隔）

注意事项:

• 电子邮箱是创建联系人时唯一必填的字段
• 电话搜索在内部使用通用搜索参数；可能会返回部分匹配的结果
• 当结合电子邮箱和电话在 FIND_CONTACT 中，结果在客户端进行筛选
• 创建时提供的标签会立即应用
• 使用现有电子邮件创建联系人可能会更新现有联系人

2. 管理联系人标签

使用时机：用户希望添加或移除联系人标签

工具序列：

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

关键参数：

• action：'添加' 或 '移除'（必需）
• tags：标签名称，以逗号分隔的字符串或字符串数组形式提供（必需）
• contact_id：联系人ID（提供此参数或 contact_email）
• contact_email联系邮箱地址（contact_id的替代项）

注意事项：

• 操作值需大写：'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'），而非列表名称
• 可通过GET /api/3/lists端点获取列表ID（此功能不作为Composio工具提供；请使用ActiveCampaign用户界面）
• 如果同时提供了email和联系人ID已提供时，联系人ID优先
• 取消订阅会将状态更改为“2”（已取消订阅），但关系记录仍保留

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

使用时机：用户希望将联系人加入自动化工作流

工具序列：

1. ACTIVE_CAMPAIGN_FIND_CONTACT- 验证联系人存在 [前提条件]
2. ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION- 将联系人加入自动化流程 [必需]

关键参数：

• contact_email：要加入的联系人邮箱（必需）
• automation_id：目标自动化流程的ID（必需）

注意事项：

• 联系人必须已存在于ActiveCampaign中
• 自动化流程只能通过ActiveCampaign界面创建，无法通过API创建
• automation_id必须引用一个已存在的、处于活动状态的自动化流程
• 该工具执行两步流程：先按邮箱查找联系人，然后进行注册
• 自动化ID可以在ActiveCampaign界面中或通过GET /api/3/automations接口找到

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格式（必须晚于截止日期）
• status: 0 表示未完成，1 表示完成

注意事项:

• duedate必须是有效的ISO 8601日期时间格式并包含时区偏移量；请勿使用占位符值
• edate必须晚于duedate
• dealTasktype是一个字符串ID，引用在ActiveCampaign中配置的任务类型
• relid是数字联系人ID，不是电子邮件地址
• assignee是用户ID；请通过ActiveCampaign用户界面将用户名解析为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
• 层级下
• 建议采用防御性解析并设置备用匹配模式

联系人搜索可能返回多个结果；建议通过邮箱精确匹配