activecampaign-automation

ActiveCampaign Automation 技能用于通过 Rube MCP（基于 Composio 的 ActiveCampaign 工具包）自动化 ActiveCampaign 的 CRM 与营销自动化操作。

【用途】 该技能面向需要在 ActiveCampaign 中批量或程序化执行联系人管理、标签管理、列表订阅管理、自动化流程注册以及任务创建等操作的用户，通过 Rube MCP 提供的工具调用来完成这些工作流。

【前置条件】

1. 需连接 Rube MCP（确认 RUBE_SEARCH_TOOLS 可用）。
2. 需通过 RUBE_MANAGE_CONNECTIONS 以工具包 active_campaign 建立有效的 ActiveCampaign 连接。
3. 建议始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

【设置步骤】

1. 获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器，无需 API 密钥。
2. 确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用。
3. 调用 RUBE_MANAGE_CONNECTIONS 并传入工具包 active_campaign。
4. 若连接不是 ACTIVE 状态，按返回的授权链接完成 ActiveCampaign 认证。
5. 确认连接状态为 ACTIVE 后再运行工作流。

【主要能力与工作流】

1. 创建与查找联系人：使用 ACTIVE_CAMPAIGN_FIND_CONTACT（按 email、id、phone 查找）和 ACTIVE_CAMPAIGN_CREATE_CONTACT（email 为必填，可含 first_name、last_name、phone、organization_name、job_title、tags）。
2. 管理联系人标签：使用 ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG，action 为 'Add' 或 'Remove'（首字母大写），tags 可为逗号分隔字符串或数组，需提供 contact_id 或 contact_email（contact_id 优先）。
3. 管理列表订阅：使用 ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION，action 为 'subscribe' 或 'unsubscribe'（小写），list_id 为数字字符串，需提供 email 或 contact_id。
4. 将联系人加入自动化：使用 ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION，需 contact_email 和 automation_id；联系人须已存在，自动化须为激活状态，且自动化只能通过 ActiveCampaign UI 创建。
5. 创建联系人任务：使用 ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK，需 relid（联系人 ID）、duedate（ISO 8601 含时区）、dealTasktype；可选 title、note、assignee、edate、status。

【常见模式】 联系人查找流程：先用 email 查找，若存在则提取联系人 ID 供后续操作；若不存在则创建联系人，再用于标签、订阅或自动化。批量打标签时可使用 contact_email 避免单独查找，并适当延迟以符合速率限制。ID 解析：通过 email 查找联系人后从响应中提取 id。

【已知限制与注意事项】

• 动作大小写敏感：标签操作为 'Add'/'Remove'（大写），订阅操作为 'subscribe'/'unsubscribe'（小写），混用会报错。
• 所有 ID 应以字符串形式传递（如 '123'），非整数。
• 自动化无法通过 API 创建，只能注册联系人；自动化须处于激活状态；重复注册可能无效。
• ActiveCampaign API 有速率限制，遇 429 应实施退避，批量操作需适当间隔。
• 响应数据可能嵌套在 data 或 data.data 下，需防御性解析。
• 联系人搜索可能返回多个结果，应按 email 精确匹配。
• 列表 ID 需通过 ActiveCampaign UI 获取（Composio 未提供该工具）。
• 创建联系人时若 email 已存在，可能更新现有联系人。
• FIND_CONTACT 中同时使用 email 和 phone 时，结果在客户端过滤。

【快速参考】 查找联系人：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。

【适用场景】 适用于需要通过 MCP 集成来自动化 ActiveCampaign 联系人管理、标签分类、列表订阅、自动化流程注册和任务创建等操作的场景。

【限制】 具体收费、价格、平台兼容性等细节暂未提供。