メインコンテンツまでスキップ

リードのインポート

CSV ファイルからワークスペースにリードを一括インポートできます。インポーターは CSV 列をリードフィールドにマッピングし、バックグラウンドでリードレコードを作成します。

ステップ 1 — CSV を準備する​

CSV ファイルの要件：

  • ヘッダー行があること（最初の行に列名）
  • UTF-8 エンコーディングを使用していること
  • カンマ区切りであること（タブやセミコロンは不可）

対応する列​

CSV 列を以下のリードフィールドにマッピングします：

CSV 列名（推奨）リードフィールド
first_name名前
last_name姓
emailメール
phone電話番号
company企業名（企業が存在しない場合は作成）
statusステータス（new, contacted, qualified, converted, lost）
sourceリードソース
lead_scoreスコア
deal_value商談価値
tagsカンマ区切りのタグ名
notesメモ（プレーンテキスト）

認識されない列は無視されます。マッピングされていない列はインポート時に手動でマッピングできます。

ステップ 2 — インポートを開始する​

  1. サイドバーのリード → リードのインポートに移動します。
  2. 新規インポートをクリックします。
  3. CSV ファイルをアップロードします。

ステップ 3 — 列をマッピングする​

インポーターに CSV のプレビューが表示され、各列をリードフィールドにマッピングできます。

  1. 各 CSV 列に対して、ドロップダウンから対応するリードフィールドを選択します。
  2. スキップしたい列は「インポートしない」のままにします。
  3. サンプル行を確認してマッピングが正しいことを確認します。
  4. インポートを開始をクリックします。

ステップ 4 — 進捗を監視する​

インポートはバックグラウンドで実行されます（キュー経由）。進捗バーに以下が表示されます：

  • 総行数
  • 処理済み行数
  • インポート成功数
  • スキップされた行数（重複または無効なデータ）
  • エラー

重複の処理​

  • ワークスペースに同じメールを持つリードが既に存在する場合、その行はスキップされます（更新されません）。
  • メールのない行は新規リードとしてインポートされます。

インポート履歴​

過去のインポートはすべてリード → リードのインポートに一覧表示されます。任意のインポートをクリックして状態とエラーの詳細を確認します。

よくある問題​

問題解決方法
「CSV 形式が無効です」ファイルが UTF-8 カンマ区切りであることを確認
多くの行がスキップされるワークスペース内の重複メールを確認
フィールドがマッピングされないヘッダー行のスペルを確認；マッピング画面で手動マッピング
インポートが止まっているCron ジョブが動作していることを確認（スーパーアドミン → システムヘルス）

ヒント​

  • 数千件のリードをインポートする前に、小さいファイル（10〜20行）でテストしてください。
  • CSV に status を含めると、すべてのリードが「新規」にデフォルト設定されるのを防げます。
  • インポート後にソースでフィルタリングできるよう、一貫した source 値を使用してください。