activecampaign-automation

Rube MCP による ActiveCampaign の自動化

Rube MCP を介して Composio の ActiveCampaign ツールキットを使用し、ActiveCampaign の CRM およびマーケティングオートメーション業務を自動化します。

前提条件

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

セットアップ

Rube MCP の取得：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。認証と権限は、ホストおよび現在の Rube 統合の状況によって異なります。エンドポイントを追加しただけでは、アクセスが可能であることの証明にはなりません。権限がある場合にのみ、ホストの設定を適用してください。

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

認可と検証

ツールのスラッグとパラメーターに関する注記は例です。検出された現在のスキーマを優先してください。対象となるアカウント、連絡先、依頼された変更内容を特定し、既存の状態を読み取り、タグ付けやオートメーションへの登録によってメッセージが送信されるかどうかを確認します。連絡先の作成は、サブスクリプションへの同意を意味しません。送信や登録によってそうした影響が生じる場合は、明示的な認可を得て、配信停止や抑制のステータスを保持してください。結果を読み返して確認し、冪等でない操作を再試行する前に、タイムアウトがあった場合は処理状況を照合してください。

主なワークフロー

1. 連絡先の作成と検索

使用する場面：新しい連絡先の作成、または既存の連絡先の検索をユーザーが希望する場合

ツールの手順：

1. ACTIVE_CAMPAIGN_FIND_CONTACT — 作成や更新を依頼された場合は、既存の連絡先と完全一致するものがないか事前に検索します
2. 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. 連絡先タグの管理

使用する場面：連絡先へのタグの追加または削除をユーザーが希望する場合

ツールの手順：

1. ACTIVE_CAMPAIGN_FIND_CONTACT — メールアドレスまたは ID で連絡先を検索します［前提条件］
2. 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. リストの購読を管理する

使用する場面：ユーザーが連絡先のリストへの登録または登録解除を希望している場合

ツールの順序：

1. ACTIVE_CAMPAIGN_FIND_CONTACT - 連絡先を検索します［前提条件］
2. 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. 連絡先をオートメーションに追加する

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

ツールの順序：

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, report no match; create with ACTIVE_CAMPAIGN_CREATE_CONTACT only when the user requested creation
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

使用する場合

権限のある ActiveCampaign の連絡先、タグ、リストの購読、既存のオートメーションへの登録、またはフォローアップタスクを検索または編集する場合に使用します。

制限事項

• このスキルは、タスクが上記の説明範囲に明確に該当する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。