导入线索
您可以将 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 逗号分隔格式 |
| 许多行被跳过 | 检查工作区中是否有重复邮箱 |
| 字段无法映射 | 检查标题行拼写；在映射界面手动映射 |
| 导入卡住 | 检查定时任务是否在运行（超级管理员 → 系统健康） |
提示
- 在导入数千条线索之前，始终先用小文件（10-20 行）测试。
- 在 CSV 中包含
status以避免所有线索默认为"新建"。 - 使用一致的
source值，以便导入后按来源筛选。