Импорт лидов

Вы можете выполнить массовый импорт лидов из CSV-файла в своё рабочее пространство. Импортёр сопоставляет столбцы CSV с полями лидов и создаёт записи в фоновом режиме.

---

Шаг 1 — Подготовьте CSV

Ваш CSV-файл должен:

• Содержать строку заголовков (названия столбцов в первой строке)
• Использовать кодировку UTF-8
• Разделяться запятыми (не табуляцией или точкой с запятой)

Поддерживаемые столбцы

Сопоставьте столбцы CSV с полями лидов:

Название столбца CSV (рекомендуемое)	Поле лида
first_name	Имя
last_name	Фамилия
email	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 — Отслеживайте прогресс

Импорт выполняется в фоновом режиме (через очередь). Индикатор прогресса показывает:

• Всего строк
• Обработано строк
• Успешно импортировано
• Пропущено строк (дубликаты или некорректные данные)
• Ошибки

---

Обработка дубликатов

• Если лид с таким же email уже существует в вашем рабочем пространстве, строка пропускается (не обновляется).
• Строки без email импортируются как новые лиды.

---

История импортов

Все прошлые импорты отображаются в разделе Лиды → Импорт лидов. Нажмите на любой импорт, чтобы просмотреть его статус и детали ошибок.

---

Распространённые проблемы

Проблема	Решение
«Неверный формат CSV»	Убедитесь, что файл в кодировке UTF-8, разделитель — запятая
Много пропущенных строк	Проверьте наличие дубликатов email в вашем рабочем пространстве
Поля не сопоставляются	Проверьте написание заголовков; выполните сопоставление вручную
Импорт завис	Проверьте, что задание cron выполняется (Супер-администратор → Состояние системы)

---

Советы

• Всегда тестируйте на небольшом файле (10–20 строк) перед импортом тысяч лидов.
• Включите status в CSV, чтобы не все лиды получили статус «Новый» по умолчанию.
• Используйте единообразные значения source, чтобы после импорта можно было фильтровать по источнику.