Импорт лидов
Вы можете выполнить массовый импорт лидов из 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 — Отслеживайте прогресс
Импорт выполняется в фоновом режиме (через очередь). Индикатор прогресса показывает:
- Всего строк
- Обработано строк
- Успешно импортировано
- Пропущено строк (дубликаты или некорректные данные)
- Ошибки
Обработка дубликатов
- Если лид с таким же email уже существует в вашем рабочем пространстве, строка пропускается (не обновляется).
- Строки без email импортируются как новые лиды.
История импортов
Все прошлые импорты отображаются в разделе Лиды → Импорт лидов. Нажмите на любой импорт, чтобы просмотреть его статус и детали ошибок.
Распространённые проблемы
| Проблема | Решение |
|---|---|
| «Неверный формат CSV» | Убедитесь, что файл в кодировке UTF-8, разделитель — запятая |
| Много пропущенных строк | Проверьте наличие дубликатов email в вашем рабочем пространстве |
| Поля не сопоставляются | Проверьте написание заголовков; выполните сопоставление вручную |
| Импорт завис | Проверьте, что задание cron выполняется (Супер-администратор → Состояние системы) |
Советы
- Всегда тестируйте на небольшом файле (10–20 строк) перед импортом тысяч лидов.
- Включите
statusв CSV, чтобы не все лиды получили статус «Новый» по умолчанию. - Используйте единообразные значения
source, чтобы после импорта можно было фильтровать по источнику.