onboarding-kickoff

キックオフ後のクライアントオンボーディング

目標

キックオフコール後に実行する自動オンボーディングワークフローです。見込み客を獲得し、キャンペーンを作成して、自動返信システムを設定します。

入力（キックオフコールで取得）

必須：

• client_name：会社名
• client_email：主な連絡先のメールアドレス
• service_type：提供するサービス
• target_location：対象地域
• offers：3つのオファー（パイプ区切り）
• target_audience：ターゲットとする相手
• social_proof：実績・成果

任意：

• lead_limit：見込み客の件数（デフォルト：500）
• value_proposition：追加情報

スクリプト

• ./scripts/gmaps_lead_pipeline.py - 見込み客の獲得
• ./scripts/casualize_company_names_batch.py - 会社名のカジュアル化
• ./scripts/instantly_create_campaigns.py - キャンペーンの作成
• ./scripts/onboarding_post_kickoff.py - 全体のオーケストレーション
• ./scripts/update_sheet.py - シートの更新

プロセス

ステップ 1：見込み客検索クエリを生成

形式：{service_type} in {target_location} 例：「Austin TX の配管工」

ステップ 2：見込み客をスクレイピングして情報を補完

python3 ./scripts/gmaps_lead_pipeline.py \
  --search "{service_type} in {target_location}" \
  --limit {lead_limit} \
  --sheet-name "{client_name} - Leads" \
  --workers 5

ステップ 3：会社名をカジュアル化

python3 ./scripts/casualize_company_names_batch.py \
  --sheet-url "{sheet_url}" \
  --column "business_name" \
  --output-column "casualCompanyName"

ステップ 4：Instantly キャンペーンを作成

python3 ./scripts/instantly_create_campaigns.py \
  --client_name "{client_name}" \
  --client_description "..." \
  --offers "{offers}" \
  --target_audience "{target_audience}" \
  --social_proof "{social_proof}"

ステップ 5：見込み客をキャンペーンにアップロード

Instantly API を使って、見込み客を3つのキャンペーンに均等に割り振ります。

ステップ 6：ナレッジベースのエントリーを追加

自動返信ナレッジベースのシートにエントリーを追加し、適切な応答処理を可能にします。

ステップ 7：概要メールを送信

完了メールをクライアントに送信します。メールには以下を含めます。

• キャンペーンのリンクと見込み客数
• 見込み客のスプレッドシート URL
• 自動返信の設定詳細
• 次のステップ

出力

{
  "status": "success",
  "client_name": "...",
  "sheet_url": "...",
  "lead_count": 50,
  "campaigns": [...],
  "leads_uploaded": true,
  "knowledge_base_updated": true,
  "summary_email_sent": true
}

所要時間

• ワークフロー全体：見込み客50件の場合、約10～15分
• 見込み客のスクレイピングでは、デフォルトで5つのワーカーを使用

エラー処理

• 見込み客が10件未満：警告を出しますが、続行します
• 見込み客が0件：エラー（検索クエリに問題があります）
• Instantly API エラー：内容を記録し、手動修正が必要な項目として記載します
• シート／メールの失敗：ログに記録しますが、ワークフローは完了します

---

スキーマ

入力

名前	型	必須	説明
client_name	string	はい	会社名
client_email	string	はい	主な連絡先のメールアドレス
service_type	string	はい	提供するサービス
target_location	string	はい	対象地域
offers	string	はい	3つのオファー（パイプ区切り）
target_audience	string	はい	ターゲットとする相手
social_proof	string	はい	実績・成果
lead_limit	integer	いいえ	見込み客の件数（デフォルト：500）

出力

名前	型	説明
status	string	成功／失敗
sheet_url	string	見込み客のスプレッドシート URL
lead_count	integer	獲得した見込み客の件数
campaigns	array	作成されたキャンペーン ID
summary_email_sent	boolean	概要メールが送信されたかどうか

認証情報

名前	ソース
APIFY_API_TOKEN	.env
ANTHROPIC_API_KEY	.env
INSTANTLY_API_KEY	.env

組み合わせ可能なスキル

このスキルと連携しやすいスキル：gmaps-leads、casualize-names、instantly-campaigns、welcome-email

コスト

見込み客500件＋キャンペーンで約5～10ドル