activecampaign-automation

通过 Rube MCP 自动化 ActiveCampaign

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

先决条件

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

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。身份验证和权限取决于宿主环境及当前 Rube 集成；仅添加端点并不能证明已获得访问权限。仅在获得授权后应用宿主配置。

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'（不能小写）
• tags 可以是逗号分隔的字符串（'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 数字字符串（可替代邮箱）

注意事项：

• action 的值必须使用小写：'subscribe' 或 'unsubscribe'
• list_id 是数字字符串（例如，'2'），而不是列表名称
• 可通过 GET /api/3/lists 端点获取列表 ID（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 必须指向现有且已启用的自动化流程
• 该工具分两步执行：先按邮箱查找联系人，再将其加入流程
• 可在 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, report no match; create with ACTIVE_CAMPAIGN_CREATE_CONTACT only when the user requested creation
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 下
• 应使用带回退模式的防御性解析
• 联系人搜索可能返回多个结果；请按邮箱匹配以确保准确性

快速参考

任务	工具 Slug	关键参数
查找联系人	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

适用场景

用于查找或编辑已获授权的 ActiveCampaign 联系人、标签、列表订阅、现有自动化流程注册信息或后续跟进任务。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审核的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。