Імпорт контактів з Excel

Швидко завантажити готову базу клієнтів. Підтримуються формати .xlsx, .xls, .csv. Максимальний розмір файлу — 10 МБ (приблизно 50 000 рядків).

Шлях

Контакти → кнопка «Імпорт» на вкладці «Ліди» або «Клієнти» → відкривається 4-крокова модалка.

Крок 1. Завантажити файл

Перетягуємо файл у зону, або натискаємо «Обрати файл». Система прочитає першу строку як заголовки колонок і покаже превью.

Поряд є кнопка «Завантажити шаблон» — Excel-файл з готовою шапкою всіх стандартних полів. Заповнюємо і повертаємось.

Крок 2. Мапінг колонок

Система спробує автоматично зіставити заголовки вашого файлу з полями CRM. Перевіряємо в таблиці мапінгу:

Ваша колонка	Поле CRM
«Ім'я»	firstName ✓
«Номер»	phone (auto-mapped)
«E-mail»	email ✓
«Місто»	city ✓

Якщо мапінг неправильний — натискаємо на дропдаун біля колонки і вибираємо потрібне поле CRM. Можна пропустити колонку (опція «Не імпортувати»).

Підтримувані поля для імпорту

firstName, lastName, middleName, phone, email, companyName, edrpou, contactPerson, city, address, source, tags, notes, birthDate, position, telegramUsername, instagramUsername, facebookUserName, viberUserName, iban, bank, mfo.
Кастомні поля також — назви колонок мають збігатися з назвами кастомних полів вашої компанії.

Обов'язкове поле

firstName (Ім'я) — без нього рядок не імпортується. Решта опційно. Якщо firstName порожній — рядок потрапляє в звіт помилок.

Валідація

• Phone — будь-який формат, нормалізується до 380XXXXXXXXX. Приймається також E.164 (міжнародний, 10-15 цифр). Невалідні залишаються в полі як є, але без нормалізації.
• Email — має містити @, інакше пропускається з помилкою.
• EDRPOU — формат не валідується, приймається будь-який текст.
• IBAN — приймається будь-який текст, валідація формату тільки в інтерактивному вводі.

Крок 3. Прогрес

Імпорт йде пакетами по 100 рядків. Видно прогрес-бар. На сервері створюються контакти один за одним, з нормалізацією телефону і перевіркою дублікатів.

Як обробляються дублікати

За замовчуванням імпорт перевіряє існуючі контакти за телефоном і email. Якщо знайдено дубль:

• Стандартна поведінка — пропустити рядок, додати в звіт «Пропущено: дубль».
• Можна вибрати «Об'єднати» у налаштуваннях імпорту — тоді існуючий контакт оновиться даними з файлу (заповнюються лише порожні поля, існуючі не перетираються).
• Можна вибрати «Створити дубль» — імпорт створить новий контакт навіть з однаковим телефоном.

Крок 4. Звіт

Після завершення показується:

• Створено — N контактів.
• Пропущено (дублі) — N контактів.
• Помилок — N рядків, можна скачати CSV з детальним розбором.

Помилки бувають: «firstName пустий», «email невалідний», «company_id не знайдено» тощо.

Що відбувається після імпорту

• Усі імпортовані контакти отримують clientType=LEAD, status=NEW, assignedTo = поточний користувач (той, хто запустив імпорт).
• Можна одразу запустити кампанію по імпортованим: створити сегмент за датою імпорту, надіслати email/SMS.
• Усі імпортовані потрапляють у ChangeLog як створені.

Поради

• Завжди тестуйте на 10-20 рядках перед великим імпортом.
• Якщо телефони у форматі «(097) 123 45 67» — звичайно нормалізується, але перевірте на тестовому імпорті.
• Колонка «Теги» — значення через кому, наприклад VIP, оптовик. Без лапок.
• Колонка «Джерело» — текст вільної форми. Кращ використовуйте однакові значення (наприклад завжди website, а не «Веб-сайт» і «сайт»), щоб потім фільтрувати.