ActiveCampaign 自動化 via Rube MCP は何をしますか?
Composio の ActiveCampaign ツールキットを介し、Rube MCP を使って ActiveCampaign CRM とマーケティング自動化の操作を自動化します。
前提条件
- Rube MCP が接続されていること(
RUBE_SEARCH_TOOLSが利用可能であること) RUBE_MANAGE_CONNECTIONSでactive_campaignツールキットを使用した ActiveCampaign 接続がアクティブであること- 最初に必ず
RUBE_SEARCH_TOOLSを呼び出して、現在のツールスキーマを取得すること
セットアップ
Rube MCP の取得: クライアント設定で MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要で、エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認して、Rube MCP が利用可能であることを確認します。- ツールキット
active_campaignを指定してRUBE_MANAGE_CONNECTIONSを呼び出します。 - 接続がアクティブでない場合は、返された認証リンクに従って 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 UI を使用)
emailとcontact_idの両方が指定された場合、contact_idが優先されます- 登録解除するとステータスは '2'(登録解除)に変わりますが、リレーションシップレコードは残ります
4. 連絡先を自動化に追加
いつ使用するか: ユーザーが連絡先を自動化ワークフローに登録したい場合
ツールの順序:
ACTIVE_CAMPAIGN_FIND_CONTACT- 連絡先が存在することを確認します [前提条件]ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION- 連絡先を自動化に登録します [必須]
主要パラメータ:
contact_email: 登録する連絡先のメールアドレス(必須)automation_id: 対象の自動化の ID(必須)
落とし穴:
- 連絡先は ActiveCampaign にすでに存在している必要があります
- 自動化は API 経由では作成できず、ActiveCampaign UI でのみ作成可能です
automation_idは既存のアクティブな自動化を参照している必要があります- このツールは 2 段階のプロセスを実行します。連絡先をメールアドレスで検索し、その後登録します
- 自動化 ID は ActiveCampaign UI または 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はduedateより後である必要がありますdealTasktypeは ActiveCampaign で設定されたタスクタイプを参照する文字列 ID ですrelidは数値の連絡先 ID であり、メールアドレスではありませんassigneeはユーザー ID です。ユーザー名は ActiveCampaign UI で 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 |
使用時
このスキルは、概要に記載されたワークフローやアクションを実行する場合に適用されます。
制限事項
- タスクが上記の範囲に明確に一致する場合にのみ、このスキルを使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、成功基準が不足している場合は、立ち止まって明確化を求めてください。