Instantly Automation
Instantlyを使ったコールドメールアウトリーチを自動化 — マルチステップシーケンスを備えたキャンペーンの作成・管理、送信スケジュールの設定、リードの一括インポート、送信アカウントの管理、キャンペーンのパフォーマンス追跡 — すべて自然言語のコマンドで行えます。
ツールキットドキュメント: composio.dev/toolkits/instantly
セットアップ
- Composio MCPサーバーをクライアント設定に追加します:
https://rube.app/mcp - プロンプトに従ってInstantlyアカウントを接続します（APIキー認証）。
- 自然言語コマンドを発行して、アウトリーチキャンペーンを管理します。
コアワークフロー
1. 送信アカウント一覧
Instantlyワークスペースに設定されているすべてのメールアカウントを、ステータスやプロバイダーでフィルタリングして取得します。
ツール: INSTANTLY_LIST_ACCOUNTS
プロンプト例:
「Instantlyワークスペースのアクティブな送信アカウントをすべて表示して」
主要パラメータ:
status— ステータスでフィルタ:1(アクティブ),2(一時停止),-1(接続エラー),-2(ソフトバウンスエラー),-3(送信エラー)provider_code— プロバイダーでフィルタ:1(カスタムIMAP/SMTP),2(Google),3(Microsoft),4(AWS)search— メールアドレス部分文字列またはドメインで検索limit— 最大アイテム数 (1〜100)starting_after— 前回のレスポンスからのページネーションカーソルtag_ids— カンマ区切りのタグUUID
2. キャンペーンの作成
スケジュール、メールシーケンス、A/Bテストバリアント、送信設定を備えた新しいアウトリーチキャンペーンを起動します。
ツール: INSTANTLY_CREATE_CAMPAIGN
プロンプト例:
「'Q1アウトリーチ'というInstantlyキャンペーンを作成して。月曜から金曜の9時〜17時（中部時間）で、3ステップのメールシーケンスを設定して」
主要パラメータ:
name(必須) — キャンペーン名campaign_schedule(必須) — スケジュール設定:schedules(必須) — スケジュールオブジェクトの配列。各オブジェクト:name— スケジュール名timing—{from: "09:00", to: "17:00"}(HH:mm形式)days— 曜日インデックス文字列 "0" (日) 〜 "6" (土) を真偽値にマッピングしたオブジェクトtimezone— 対応タイムゾーン: "America/Chicago", "America/Detroit", "America/Boise", "America/Anchorage"
start_date/end_date— ISO 8601日付
email_list— 送信アカウントのメールアドレスの配列（事前設定済みのアカウントである必要あり。有効なアドレスを確認するにはINSTANTLY_LIST_ACCOUNTSを使用）sequences— 配列（最初の要素のみ使用）:steps— ステップオブジェクトの配列:type— "email" である必要がありますdelay— 次のメールまでの日数（整数、最小0）variants— A/Bテスト用の{subject, body}オブジェクトの配列
daily_limit— 1日あたりの送信上限email_gap— メール間の間隔（分）stop_on_reply— リードが返信した場合にキャンペーンを停止（真偽値）stop_on_auto_reply— 自動返信で停止（真偽値）open_tracking/link_tracking— トラッキングを有効化（真偽値）
タイムゾーンの注意:
- 動作確認済み: "America/Chicago" (中部), "America/Detroit" (東部), "America/Boise" (山岳部)
- 自動マッピング: "America/New_York" → "America/Detroit", "America/Denver" → "America/Boise"
- 非対応: "America/Los_Angeles", "US/Pacific" — 代替として"America/Anchorage"または"America/Dawson"を使用してください
3. キャンペーン設定の更新
既存のキャンペーンのスケジュール、送信制限、シーケンス、トラッキング設定を変更します。
ツール: INSTANTLY_UPDATE_CAMPAIGN
プロンプト例:
「Instantlyキャンペーンを更新して、1日あたりの送信上限を100にして、開封トラッキングを有効にして」
主要パラメータ:
id(必須) — キャンペーンUUID- 任意の組み合わせ:
name,campaign_schedule,email_list,sequences,daily_limit,email_gap,stop_on_reply,open_tracking,link_trackingなど - パラメータを
nullに設定すると解除されます
4. リードリストの管理と一括インポート
専用のリードリストを作成し、プロスペクトを一括でインポートしてキャンペーンターゲティングに使用します。
ツール: INSTANTLY_CREATE_LEAD_LIST, INSTANTLY_ADD_LEADS_BULK
プロンプト例:
「'Q1見込み客'というリードリストを作成して、50件のリードをInstantlyキャンペーンに追加して」
リードリスト作成の主要パラメータ:
- リスト名と設定
一括リードインポートの主要パラメータ:
- インポート先のキャンペーンまたはリストID
- メールアドレスとメタデータを含むリードオブジェクトの配列
- 重複処理オプション
- リード検証設定
5. キャンペーン詳細の確認
キャンペーンの全設定を取得して、設定の確認、シーケンスの検査、更新の準備を行います。
ツール: INSTANTLY_GET_CAMPAIGN
プロンプト例:
「Instantlyキャンペーンの詳細をすべて表示して」
主要パラメータ:
id(必須) — キャンペーンUUID
6. 全キャンペーン一覧
ワークスペース内のすべてのキャンペーンを、オプションのフィルターとページネーション付きで列挙します。
ツール: INSTANTLY_LIST_CAMPAIGNS
プロンプト例:
「すべてのInstantlyキャンペーンを表示して」
主要パラメータ:
- オプションのフィルターとページネーションパラメータ
既知の問題点
- タイムゾーンの制限: Instantly APIは限られたタイムゾーン文字列のみを受け入れます。Pacific Time ("America/Los_Angeles") はサポートされていません。代替として"America/Anchorage" (UTC-9/UTC-8) または"America/Dawson" (UTC-7 通年) を使用してください。
- 無効なスケジュールペイロードで400エラー:
campaign_scheduleが不正（days、from、to、またはschedulesが欠落）だとHTTP 400が発生します。400が繰り返される場合は、一時的な障害ではなくペイロードの問題を示しています。 - シーケンスは完全である必要がある: 各シーケンスステップには、有効な
type("email")、delay、および少なくとも1つのバリアント（subjectとbodyの両方を含む）が必要です。不完全なバリアントはキャンペーン作成をブロックします。 - 最初のシーケンス要素のみ使用される: APIは
sequences[0]のみを処理します。追加のシーケンスは無視されます。 - email_listは既存のアカウントを参照する必要がある:
email_listフィールドには、Instantlyワークスペースで事前設定された送信アカウントのメールアドレスが必要であり、任意の受信者アドレスではありません。有効な送信アドレスを見つけるには、常にINSTANTLY_LIST_ACCOUNTSを使用してください。 - キャンペーン作成時の401スコープエラー: キャンペーン作成が「無効なスコープです。必須: campaigns:create」で失敗することがあります。書き込みを再試行する前にAPIキーの権限を更新してください。
- 読み取り時のフィールド名の差異:
INSTANTLY_GET_CAMPAIGNのレスポンスのフィールド名は、作成ペイロードと異なる場合があります（例:timing.from_vstiming.from）。防御的にパースしてください。
クイックリファレンス
| アクション | ツールスラッグ | 必須パラメータ |
|---|---|---|
| 送信アカウント一覧 | INSTANTLY_LIST_ACCOUNTS | なし（オプションフィルターあり） |
| キャンペーン作成 | INSTANTLY_CREATE_CAMPAIGN | name, campaign_schedule |
| キャンペーン更新 | INSTANTLY_UPDATE_CAMPAIGN | id |
| キャンペーン詳細取得 | INSTANTLY_GET_CAMPAIGN | id |
| キャンペーン一覧 | INSTANTLY_LIST_CAMPAIGNS | なし（オプションフィルターあり） |
| リードリスト作成 | INSTANTLY_CREATE_LEAD_LIST | リスト名 |
| リード一括インポート | INSTANTLY_ADD_LEADS_BULK | キャンペーン/リストID、リード |
Powered by Composio