透過 Rube MCP 自動化 ActiveCampaign
透過 Composio 的 ActiveCampaign 工具集（經由 Rube MCP）自動化 ActiveCampaign CRM 與行銷自動化操作。
前置要求
- Rube MCP 必須已連線（
RUBE_SEARCH_TOOLS可用） - 使用
RUBE_MANAGE_CONNECTIONS並指定工具集active_campaign建立有效的 ActiveCampaign 連線 - 務必先呼叫
RUBE_SEARCH_TOOLS以取得最新的工具結構定義
設定
取得 Rube MCP：在您的客戶端設定中將 https://rube.app/mcp 新增為 MCP 伺服器。不需要 API 金鑰，只需加入端點即可運作。
- 確認
RUBE_SEARCH_TOOLS有回應，以驗證 Rube MCP 可用 - 使用工具集
active_campaign呼叫RUBE_MANAGE_CONNECTIONS - 若連線狀態非 ACTIVE，請依照回傳的驗證連結完成 ActiveCampaign 身分驗證
- 在執行任何工作流程前，確認連線狀態顯示為 ACTIVE
核心工作流程
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：'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. 管理列表訂閱
適用時機：使用者想要訂閱或退訂聯絡人的列表
工具順序：
ACTIVE_CAMPAIGN_FIND_CONTACT- 查詢聯絡人 [前置]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. 新增聯絡人至自動化流程
適用時機：使用者想要將聯絡人註冊到自動化工作流程中
工具順序：
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：任務標題note：任務描述/內容assignee：指派任務的使用者 IDedate：ISO 8601 格式的結束日期（必須晚於 duedate）status：0 表示未完成，1 表示已完成
常見陷阱：
duedate必須是有效的 ISO 8601 日期時間並包含時區偏移；請勿使用佔位符值edate必須晚於duedatedealTasktype是參照 ActiveCampaign 中設定的任務類型的字串 IDrelid是數值聯絡人 ID，而非電子郵件地址assignee是使用者 ID；請透過 ActiveCampaign 介面將使用者名稱解析為 ID
常見模式
聯絡人查詢流程
1. 以電子郵件呼叫 ACTIVE_CAMPAIGN_FIND_CONTACT
2. 若找到，擷取聯絡人 ID 以供後續操作使用
3. 若未找到，使用 ACTIVE_CAMPAIGN_CREATE_CONTACT 建立聯絡人
4. 使用聯絡人 ID 進行標籤、訂閱或自動化流程操作
大量標籤操作
1. 對每個聯絡人呼叫 ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG
2. 使用 contact_email 以避免額外的查詢呼叫
3. 分批處理並加入適當延遲以遵守速率限制
ID 解析
聯絡人電子郵件 -> 聯絡人 ID：
1. 以電子郵件呼叫 ACTIVE_CAMPAIGN_FIND_CONTACT
2. 從回應中擷取 id
已知陷阱
動作參數大小寫：
- 標籤動作：'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 |
使用時機
此技能適用於執行概述中所述的工作流程或操作。
限制
- 僅在任務明確符合上述範圍時使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代方案。
- 若缺少所需的輸入、權限、安全邊界或成功標準，請停止並要求釐清。