campaign-sending

キャンペーンの実行

シーケンス設定と送信のために、確定済みのメールをアップロードします。

環境

プロバイダーの選択と認証情報の設定は、ワークフローのステップ 0 で行います。

ワークフロー

ステップ 0：プロバイダーを確認して API を把握する

1. 使用するメールシーケンスプロバイダーをユーザーに尋ねます。決めかねている場合は、ローカルのリファレンスドキュメントを利用できる事前設定済みの選択肢が references/ にあります。
2. プロバイダーの API ドキュメントを取得または確認し、以下を特定します。
   • キャンペーン／シーケンスの作成エンドポイント
   • リードのアップロードエンドポイントとスキーマ
   • 重複排除のオプション
   • カスタム変数／パーソナライズのサポート
   • 認証方法と認証情報
   • スループット制限とアップロードの制約
3. API 認証情報を尋ね、アクセスを確認します。
4. プロバイダーのリードスキーマに基づいてフィールドのマッピングを計画し、続行する前にユーザーの確認を得ます。

ステップ 1：確定済みのメールを読み込み、分析する

確定済みのメール CSV（email-generation の出力）を読み込みます。CSV ヘッダーを確認して、利用可能な列をすべて把握します。必須列（email、first_name、company_name、company_domain）が存在することを確認します。プロバイダーの変数にマッピングする必要があるすべてのコンテンツ列（段落フィールド、仮説、ティアなど）を特定します。

ステップ 2：DNC リストを確認する

コンテキストファイルを読み込み、DNC リストにあるドメインをすべて除外します。除外した件数を報告します。

ステップ 3：キャンペーンを作成または検索する

選択したプロバイダーの API を使用します。

• 既存のキャンペーンを一覧表示します。
• 必要に応じて新しいキャンペーンを作成します（業種と日付に基づく名前を提案します）。

キャンペーンを地域とタイムゾーンに基づいて指定するよう、ユーザーに尋ねます。送信スケジュールを受信者の現地営業時間に合わせるため、地域やタイムゾーンが異なるリードは別々のキャンペーンに分けます。

既存のキャンペーンを使用するか、新しいキャンペーンを作成するか、ユーザーに尋ねます。

ステップ 4：フィールドをプロバイダーのリードスキーマにマッピングする

ステップ 1 で確認した CSV ヘッダーを分析し、プロバイダーに対応するフィールドを作成します。

1. email、first_name、last_name、company_name、company_domain をプロバイダーの標準リードフィールドにマッピングします。
2. CSV の残りの列ごとに、プロバイダーに対応するカスタム変数／パーソナライズフィールドを作成します。
3. マッピングの全容をユーザーに提示し、アップロード前に確認を得ます。

ステップ 5：リードをバッチでアップロードする

プロバイダーの API を使ってバッチ単位でアップロードします（ステップ 0 で確認したレート制限を守ります）。プロバイダーが対応している場合は、重複排除を有効にします。

アップロード件数、スキップ件数（重複排除）、試行総数を報告します。

ステップ 6：送信前の確認チェックリスト

キャンペーンを有効にする前に、次のチェックリストをユーザーに提示します。

## Pre-Send Verification Checklist

Campaign: [name]
Leads uploaded: [N]
Leads skipped (dedup): [N]

### Verify in your sequencer:

- [ ] **Email accounts connected** — at least 2-3 sending accounts are linked and warmed
- [ ] **Sending schedule set** — check timezone, sending hours, daily limits
- [ ] **Email sequence configured** — first email + follow-up(s) are set up in the campaign
- [ ] **Custom variables working** — preview 3-5 emails to confirm {{variables}} render correctly
- [ ] **Unsubscribe link present** — required for compliance
- [ ] **DNC list checked** — confirm no blacklisted domains made it through
- [ ] **Reply handling set** — auto-stop sequence on reply is enabled
- [ ] **Warmup active** — sending accounts have adequate warmup history

### Sample emails to spot-check:

[Show 3 random emails from the upload for the user to visually verify]

ステップ 7：手動での有効化を促す

キャンペーンを自動で有効にしてはいけません。 必ずユーザーに次のように伝えます。

「リードをアップロードしました。シーケンサーでキャンペーンを確認し、シーケンスと送信設定をチェックしてから、準備ができた時点で手動で有効にしてください。キャンペーンを自動で開始することはありません。」

送信後：フィードバックループ

キャンペーンの実行開始から通常 1～2 週間後に、フィードバックループを実行するようユーザーに促します。

1. シーケンサーから結果（開封、返信、バウンス）をエクスポートします。
2. フィードバックループモードで context-building を実行し、Campaign History を更新します。
3. 結果を活用して仮説を見直し、今後のキャンペーンを改善します。

API リファレンス

事前設定済みプロバイダーのドキュメントは references/ ディレクトリにあります。その他のプロバイダーのドキュメントはステップ 0 で取得します。