1. Вступ

Визначення

Імпорт — це масова дія платформи Leeloo.AI, яка дозволяє завантажити базу клієнтів із зовнішнього Excel-файлу (розширення .xlsx) у розділ «Аудиторія». Імпорт належить до стадії Управління (Manage) життєвого циклу клієнта: оператор масово вносить підписників у платформу для подальшої комунікації, сегментації та руху воронками продажів.

Імпорт працює у звʼязці з іншими модулями платформи: він записує дані в Карту клієнта (Client's Card), підписує клієнтів на обраний тунель і LGT, присвоює їм теги для подальшої фільтрації у Filter Panel. Джерело даних — зовнішній файл (CSV/Excel), експортований із сторонньої CRM (AmoCRM, Zoho, Salesforce та ін.) або з самої Leeloo.AI.

B2B оператор (власник кабінету, маркетолог, менеджер аудиторії) запускає імпорт через «Масові дії» у розділі «Аудиторія». Він обирає файл, вказує бота-відправника (канал звʼязку), цільовий тунель, LGT для підписки та опціональні теги — після натискання «Import clients» платформа створює або оновлює картки клієнтів і прикріплює їх до обраного маршруту.

B2C клієнт напряму з імпортом не взаємодіє — він не бачить інтерфейсу завантаження. Опосередковано імпорт зачіпає клієнта так: після успішного імпорту його картка зʼявляється в платформі із зазначеним каналом звʼязку (Telegram, WhatsApp, Email тощо), і він починає отримувати повідомлення тунелю або розсилки від оператора, ніби підписався через LGT.

У Карту клієнта (Client's Card) при імпорті записуються: social_id (ідентифікатор у месенджері або email), name (імʼя), привʼязка до обраного бота/каналу звʼязку, поточний тунель, LGT-підписка і теги. При повторному імпорті вже існуючого клієнта (збіг social_id + тип каналу) дані в картці оновлюються — це ключовий інваріант: один клієнт = одна картка на один канал.

Після ознайомлення ви зрозумієте:

• Що таке імпорт у Leeloo.AI і в яких сценаріях він застосовується (міграція зі сторонньої CRM, зворотне завантаження раніше експортованої бази, масове підключення клієнтів до тунелю).

• Як покроково виконати імпорт через розділ «Аудиторія» → «Масові дії» → «Імпорт».

• Які поля файлу обовʼязкові (social_id), які рекомендовані (name) і які опціональні.

• Як працює логіка оновлення вже існуючих карток клієнтів при повторному імпорті.

• Як уникнути типових помилок: невідповідність бота і каналу, відсутність social_id, дублікати, невірний формат email/телефону.

• Як перепідписати імпортовану базу без реальних social_id через email/SMS-розсилку та LGT.

Призначення

Ключова роль імпорту — швидкий і контрольований вхід зовнішньої клієнтської бази у платформу Leeloo.AI з автоматичним привʼязуванням до каналу звʼязку, тунелю та LGT. Без імпорту оператор був би змушений заводити кожного клієнта вручну — для бази у 1 000+ підписників це години роботи. Імпорт стискає це завдання в одну операцію: завантаження файлу + вибір маршруту = сотні/тисячі готових карток клієнтів у Карті клієнта, підписаних на потрібний тунель.

На стадії Залучення (Engage) життєвого циклу імпорт — це інструмент швидкого наповнення бази підписників для подальшого прогріву через тунелі та розсилки. Імпортовані клієнти одразу стають доступними для комунікації через обраний канал, потрапляють у тунель і отримують перші повідомлення як повноцінні підписники.

На стадії Управління (Manage) імпорт — це інструмент масового внесення підписників у кероване поле платформи. Після імпорту клієнти стають доступні для сегментації в Аудиторії, фільтрації через Filter Panel, розсилок через Smart Sender, постановки задач у CRM і руху воронками продажів. Завдання — за одну операцію перенести базу зі сторонньої системи (AmoCRM, Zoho, Salesforce) або повернути в Leeloo раніше експортованих клієнтів, зберігши структуру каналів звʼязку і сегментацію за тегами.

2. Як виконати імпорт

Імпорт запускається з розділу «Аудиторія» через меню масових дій. Перед запуском підготуйте Excel-файл (.xlsx) із заповненими полями social_id та name — зразок доступний за посиланням exported 03.12 13.28.27.xlsx.

2.1. Відкрийте розділ «Аудиторія» і натисніть «Масові дії»

Перейдіть у розділ «Аудиторія». У верхньому правому куті екрана натисніть кнопку «Масові дії» — справа відкриється панель доступних операцій над базою клієнтів.

2.2. Виберіть пункт «Імпорт»

У меню, що розкрилося справа, виберіть пункт «Імпорт» — відкриється форма завантаження файлу з полями маршрутизації (бот, тунель, LGT, теги).

2.3. Заповніть поля форми імпорту

Форма імпорту містить декілька обовʼязкових і опціональних полів:

1. Виберіть файл у форматі Excel з розширенням .xlsx з обовʼязково заповненими полями social_id та name. Інші параметри опціональні.

2. Виберіть бота, від імені якого буде здійснюватися розсилка імпортованим клієнтам. Тип бота (канал звʼязку) повинен співпадати з типом social_id у файлі: Telegram-бот для Telegram-ID, WhatsApp-бот для номерів WhatsApp, Email-провайдер для email-адрес тощо.

3. Виберіть тунель — Sales Tunnel, у який потраплять імпортовані клієнти. Якщо не вказати, буде призначено Default tunnel.

4. Підпишіть на LGT — вкажіть посадкову сторінку/lead-gen-tool, на яку клієнти вважатимуться підписаними.

5. Виберіть теги (опціонально) — теги для подальшої сегментації у Filter Panel.

6. Натисніть «Import clients» — кнопка активується після вибору файлу і бота. Платформа виконає імпорт.

3. Структура файлу імпорту

Файл імпорту — це таблиця у форматі Excel .xlsx. Детальний опис полів і форматування за кожним каналом звʼязку (Telegram, WhatsApp, Email, Facebook, Instagram, Viber) — в інструкції «Як підготувати Excel файл для імпорту».

Обовʼязкові та рекомендовані поля:

• social_id — ідентифікатор клієнта у месенджері (Telegram ID, FB ID), номер телефону для WhatsApp/SMS або email-адреса для email-каналів. Обовʼязково.

• name — імʼя клієнта. Рекомендовано.

• Інші поля (phone, custom fields) — опціональні і залежать від каналу.

4. Імпорт бази без реальних social_id

Якщо у вас є база клієнтів зі стороннього сервісу, але реальних social_id (Telegram ID, FB ID тощо) — немає, імпорт все одно можливий, але потребуватиме перепідписки клієнтів на реальний канал звʼязку через email/SMS-розсилку та LGT.

1. Підготуйте файл .xlsx з обовʼязковим полем social_id — заповніть його тимчасовими числовими значеннями (наприклад, 111, 222, 333) або email-адресами/номерами телефонів залежно від каналу перепідписки.

2. Імпортуйте файл за кроками з розділу «Як виконати імпорт».

3. Виконайте розсилку повідомлень із посиланням на ваш LGT (посадкову сторінку з кнопкою месенджера для входу) через email/SMS-канал.

4. Клієнти, які перейшли за LGT, підпишуться на реальний канал звʼязку — їхні картки оновляться валідними social_id.

5. Подальша комунікація ведеться в рамках платформи через обраний канал і тунель.

Зразок файлу для імпорту: exported 03.12 13.28.27.xlsx. Перейдіть за посиланням і натисніть значок «Завантажити» — відкрийте файл і внесіть правки за описаними вище правилами.

5. Часті помилки

Супутні інструкції

Основні терміни