activecampaign-automation

Rube MCP による ActiveCampaign の自動化

Rube MCP 経由で Composio の ActiveCampaign ツールキットを使用して、ActiveCampaign CRM とマーケティングオートメーションの操作を自動化します。

ツールキットのドキュメント: composio.dev/toolkits/active_campaign

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS を利用可能）
• active_campaign ツールキットを使用する RUBE_MANAGE_CONNECTIONS 経由で ActiveCampaign に接続されていること
• 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の入手: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを確認します
2. active_campaign ツールキットを指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って ActiveCampaign の認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. コンタクトの作成と検索

使用する場面: ユーザーが新しいコンタクトを作成したい場合、または既存のコンタクトを検索したい場合

ツールの順序:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - 既存のコンタクトを検索 [Optional]
2. ACTIVE_CAMPAIGN_CREATE_CONTACT - 新しいコンタクトを作成 [Required]

検索での主なパラメーター:

• 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 でコンタクトを検索 [Prerequisite]
2. ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG - タグを追加または削除 [Required]

主なパラメーター:

• 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. リスト登録の管理

使用する場面: ユーザーがコンタクトをリストに登録、または登録解除したい場合

ツールの順序:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - コンタクトを検索 [Prerequisite]
2. ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION - 登録または登録解除 [Required]

主なパラメーター:

• 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. オートメーションに連絡先を追加する

使用する場面：ユーザーが連絡先をオートメーションワークフローに登録したい場合

ツールの手順：

1. ACTIVE_CAMPAIGN_FIND_CONTACT - 連絡先が存在することを確認します［前提条件］
2. ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION - 連絡先をオートメーションに登録します［必須］

主なパラメーター：

• contact_email：登録する連絡先のメールアドレス（必須）
• automation_id：対象のオートメーションの ID（必須）

注意点：

• 連絡先はすでに ActiveCampaign に存在している必要があります
• オートメーションは ActiveCampaign の UI からのみ作成でき、API からは作成できません
• automation_id は、既存の有効なオートメーションを参照している必要があります
• このツールは、メールアドレスで連絡先を検索してから登録する、2 段階の処理を実行します
• オートメーション ID は、ActiveCampaign の UI または GET /api/3/automations で確認できます

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, 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 の解決

連絡先のメールアドレス -> 連絡先 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 の下にネストされている場合があります
• フォールバックパターンを使用して、堅牢に解析してください
• 連絡先の検索で複数の結果が返されることがあります。正確性を確保するため、メールアドレスで照合してください

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
連絡先を検索	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

---

Composio 提供