name: activecampaign-automation
description: “Automate ActiveCampaign tasks via Rube MCP (Composio): manage contacts, tags, list subscriptions, automation enrollment, and tasks. Always search tools first for current schemas.”
risk: critical
source: community
date_added: “2026-02-27”
通过 Rube MCP 的 ActiveCampaign 自动化
通过 Rube MCP，通过 Composio 的 ActiveCampaign 工具包自动化 ActiveCampaign CRM 和营销自动化操作。
先决条件
- Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
- 通过工具包
active_campaign使用RUBE_MANAGE_CONNECTIONS的 Active ActiveCampaign 连接 - 始终先调用
RUBE_SEARCH_TOOLS以获取当前工具架构
设置
获取 Rube MCP：在您的客户端配置中将https://rube.app/mcp添加为 MCP 服务器。无需 API 密钥 — 只需添加该端点即可使用。
- 通过确认
RUBE_SEARCH_TOOLS响应来验证 Rube MCP 是否可用 - 使用工具包
active_campaign调用RUBE_MANAGE_CONNECTIONS - 如果连接未激活，请按照返回的认证链接完成ActiveCampaign认证
- 在运行任何工作流之前，确认连接状态显示为活动
核心工作流程
1. 创建和查找联系人
使用时机：用户想要创建新联系人或查找现有联系人
工具顺序：
ACTIVE_CAMPAIGN_FIND_CONTACT- 搜索现有联系人 [可选]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. 管理联系人标签
使用时机：用户想要向联系人添加或移除标签
工具顺序：
ACTIVE_CAMPAIGN_FIND_CONTACT- 通过电子邮件或ID查找联系人 [先决条件]ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG- 添加或移除标签 [必填]
关键参数：
action：‘添加’ 或 ‘移除’（必填）tags：标签名称，可为逗号分隔的字符串或字符串数组（必填）contact_id：联系人ID（提供此项或 contact_email）contact_email：联系电子邮件地址（作为 contact_id 的替代）
陷阱：
action值首字母大写：‘Add’ 或 ‘Remove’（不是小写）- 标签可以是用逗号分隔的字符串（‘tag1, tag2’）或数组（[‘tag1’, ‘tag2’]）
contact_id或contact_email必须提供；contact_id优先- 添加不存在的标签会自动创建它
- 删除一个不存在的标签是无操作的（不会报错）
3. 管理列表订阅
使用时机：用户想要订阅或取消订阅联系人列表
工具顺序：
ACTIVE_CAMPAIGN_FIND_CONTACT- 查找联系人 [先决条件]ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION- 订阅或取消订阅 [必填]
关键参数：
action：‘subscribe’ 或 ‘unsubscribe’（必填）list_id：数字列表 ID 字符串（必填）email：联系电子邮件地址（提供此项或 contact_id）contact_id：数字联系人 ID 字符串（替代电子邮件）
陷阱：
action值是小写：‘subscribe’ 或 ‘unsubscribe’list_id是一个数字字符串（例如 ‘2’），而不是列表名称- 列表 ID 可以通过 GET /api/3/lists 端点获取（不作为 Composio 工具提供；请使用 ActiveCampaign 用户界面）
- 如果同时提供了
email和contact_id，contact_id优先 - 取消订阅会将状态更改为“2”（已取消订阅），但关系记录仍然存在
4. 将联系人添加到自动化
使用时机：用户希望将联系人注册到自动化工作流程中
工具顺序：
ACTIVE_CAMPAIGN_FIND_CONTACT- 验证联系人是否存在 [前提条件]ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION- 将联系人加入自动化 [必填]
关键参数：
contact_email：要注册的联系人的电子邮件（必填）automation_id：目标自动化的ID（必填）
陷阱：
- 该联系人必须已经存在于ActiveCampaign中
- 自动化只能通过 ActiveCampaign 用户界面创建，不能通过 API 创建
automation_id必须引用一个存在的、活动的自动化- 该工具执行两步操作：通过电子邮件查找联系人，然后注册
- 自动化 ID 可以在 ActiveCampaign 用户界面中找到，也可以通过 GET /api/3/automations 获取
5. 创建联系人任务
使用时机：用户希望创建与联系人相关的后续任务
工具顺序：
ACTIVE_CAMPAIGN_FIND_CONTACT- 查找要关联任务的联系人 [先决条件]ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK- 创建任务 [必填]
关键参数：
relid：用于将任务关联的联系人ID（必填）duedate：ISO 8601 格式的截止日期，带时区（必填，例如 ‘2025-01-15T14:30:00-05:00’）dealTasktype：基于可用类型的任务类型ID（必填）title: 任务标题注意: 任务描述/内容assignee：要分配任务的用户 IDedate：结束日期，采用 ISO 8601 格式（必须晚于截止日期）status：0 表示未完成，1 表示已完成
陷阱：
duedate必须是带有时区偏移的有效 ISO 8601 日期时间；请勿使用占位符值edate必须晚于duedatedealTasktype是一个字符串 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:
1. Call ACTIVE_CAMPAIGN_FIND_CONTACT with email 2. Extract id from the response已知陷阱
行动资本化：
- 标签操作：‘添加’，‘移除’（首字母大写）
- 订阅操作：‘subscribe’、‘unsubscribe’（小写）
- 大小写混用会导致错误
身份证类型：
- 联系人ID：数字字符串（例如，“123”）
- 列表ID：数字字符串
- 自动化 ID：数字字符串
- 所有ID应作为字符串传递，而不是整数
自动化：
- 无法通过 API 创建自动化；只能进行注册
- 必须启用自动化才能接收新联系人
- 将已经在自动化中的联系人注册可能不会有任何效果
速率限制：
- ActiveCampaign API 每个账户都有速率限制
- 在收到 429 响应时实施退避
- 批量操作应适当间隔
响应解析:
- 响应数据可能嵌套在
data或data.data下 - 使用回退模式进行防御性解析
- 联系人搜索可能会返回多个结果；通过电子邮件匹配以确保准确性
快速参考
| Task | Tool Slug | Key Params |
|---|---|---|
| Find contact | ACTIVE_CAMPAIGN_FIND_CONTACT | email, id, phone |
| Create contact | ACTIVE_CAMPAIGN_CREATE_CONTACT | email, first_name, last_name, tags |
| Add/remove tags | ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG | action, tags, contact_email |
| Subscribe/unsubscribe | ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION | action, list_id, email |
| Add to automation | ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION | contact_email, automation_id |
| Create task | ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK | relid, duedate, dealTasktype, title |
何时使用
此技能可用于执行概述中描述的工作流程或操作。
限制
- 仅当任务明确符合上述描述的范围时才使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少所需的输入、权限、安全界限或成功标准，请停下来并要求澄清。
