Перейти к основному содержимому

Импорт лидов

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


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

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

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

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

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

Название столбца CSV (рекомендуемое)Поле лида
first_nameИмя
last_nameФамилия
emailEmail
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, чтобы после импорта можно было фильтровать по источнику.