リードのインポート
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 — インポ ートを開始する
- サイドバーのリード → リードのインポートに移動します。
- 新規インポートをクリックします。
- CSV ファイルをアップロードします。
ステップ 3 — 列をマッピングする
インポーターに CSV のプレビューが表示され、各列をリードフィールドにマッピングできます。
- 各 CSV 列に対して、ドロップダウンから対応するリードフィールドを選択します。
- スキップしたい列は「インポートしない」のままにします。
- サンプル行を確認してマッピングが正しいことを確認します。
- インポートを開始をクリックします。
ステップ 4 — 進捗を監視する
インポートはバックグラウンドで実行されます（キュー経由）。進捗バーに以下が表示されます：
- 総行数
- 処理済み行数
- インポート成功数
- スキップされた行数（重複または無効なデータ）
- エラー
重複の処理
- ワークスペースに同じメールを持つリードが既に存在する場合、その行はスキップされます（更新されません）。
- メールのない行は新規リードとしてインポートされます。
インポート履歴
過去のインポートはすべてリード → リードのインポートに一覧表示されます。任意のインポートをクリックして状態とエラーの詳細を確認します。
よくある問題
| 問題 | 解決方法 |
|---|---|
| 「CSV 形式が無効です」 | ファイルが UTF-8 カンマ区切りであることを確認 |
| 多くの行がスキップされる | ワークスペース内の重複メールを確認 |
| フィールドがマッピングされない | ヘッダー行のスペルを確認；マッピング画面で手動マッピング |
| インポートが止まっている | Cron ジョブが動作していることを確認（スーパーアドミン → システムヘルス） |
ヒント
- 数千件のリードをインポートする前に、小さいファイル（10〜20行）でテストしてください。
- CSV に
statusを含めると、すべてのリードが「新規」にデフォルト設定されるのを防げます。 - インポート後にソースでフィルタリングできるよう、一貫した
source値を使用してください。