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. Частые ошибки

Сопутствующие инструкции

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