Імпорт потрібен для одного: щоб новий сервіс знав, хто ваші підписники. Самі підписники нікуди не переносяться — вони належать боту, а не платформі. Але щоб бот міг звертатися до людини на імʼя, сегментувати її за тегами й показувати правильні гілки воронки, у сервісі має бути її картка.
Що можна імпортувати
- ID людини в каналі бота — обовʼязково, без нього рядок не імпортується. Для Telegram це Telegram ID
- імʼя та прізвище
- username
- теги — однією колонкою, значення через кому
- будь-які ваші поля — окремою колонкою на кожне поле
- бали — окремою колонкою на кожен тип балів
Вимоги до файлу
- формат CSV, розділювач — кома (крапка з комою не підтримується)
- перший рядок — заголовки колонок
- значення з комами всередині беруться в подвійні лапки; лапка всередині значення подвоюється
- ID — лише цифри, від 5 до 18. Рядки з порожнім або некоректним ID пропускаються
- дублі за ID у межах файлу пропускаються — залишиться перший
- кодування має коректно відображати кирилицю (UTF-8)
Порядок імпорту
1. Підготуйте файл. Переконайтеся, що є колонка з ID. Решта колонок — на ваш розсуд.
2. Створіть поля й типи балів заздалегідь, якщо хочете, щоб дані лягли в конкретні поля чи бали. Теги з колонки створяться за назвою самі, а поля й типи балів треба обрати зі списку наявних.
3. Відкрийте «Контакти» і натисніть «Імпорт CSV». У вікні «Імпорт контактів» оберіть бота («У який бот») і завантажте файл («Файл CSV») або вставте його вміст.
4. Зіставте колонки — розділ «Мапінг: колонка файлу → куди в сервісі». Для кожної колонки файлу вкажіть, що це:
| Призначення | Що робить |
|---|---|
| Telegram ID (обовʼязково) | ключ, за яким контакт створюється або оновлюється |
| Імʼя / Прізвище | заповнює відповідні поля картки |
| Username | зберігається без символу @ |
| Теги (через кому) | значення розділяються комою й перетворюються на теги |
| Поле ‹назва› | значення лягає у вибране поле |
| Бали ‹тип› | встановлює баланс балів вибраного типу (ціле число, не відʼємне) |
| — пропустити — | колонка ігнорується |
5. Оберіть параметри:
- «повісити всім тег:» — тег партії, який отримають усі імпортовані;
- «якщо контакт уже є — оновити поля» — увімкнено за замовчуванням; без галочки наявні контакти пропускаються;
- «запустити автоматизації (тригери «Тег додано/знято»)» — вимкнено за замовчуванням: імпорт тихий і воронки не запускає.
6. Натисніть «Імпортувати» і подивіться результат: «Готово: додано N, оновлено M, пропущено K».
7. Перевірте вибірково. Відкрийте кілька карток: чи на місці теги, чи правильно розпізналися поля. Потім створіть сегмент за ключовим тегом і подивіться, чи потрапляє в нього очікувана кількість людей.
Звідки взяти Telegram ID
Це головне питання при переїзді з іншого сервісу, і відповідь залежить від донора.
Сервіс віддає Telegram ID. Тоді його експорт містить колонку з ID разом з потрібними полями — збережіть її у CSV.
Сервіс не віддає Telegram ID. Тоді перенести базу файлом неможливо — її доводиться збирати заново, переводячи людей на нового бота розсилкою з кнопкою.
Уточніть це заздалегідь: від відповіді залежить увесь план переїзду.
Часті проблеми
«Пропущено N рядків». Найчастіші причини: порожній ID, ID не складається з 5–18 цифр, дубль у межах файлу, а також наявний контакт, якщо вимкнено «оновити поля».
Теги не створилися. Перевірте, що колонка позначена саме як «Теги (через кому)», а значення розділені комою, а не крапкою з комою.
Поля порожні. Кожне поле — окрема колонка з окремим призначенням. Одна колонка не може заповнити два поля. Порожні клітинки пропускаються.
Кирилиця «крякозябрами». Проблема кодування файлу — перезбережіть його у UTF-8.
Бали не імпортувалися. Перевірте, що значення — ціле невідʼємне число і що обрано правильний тип балів цього бота.
Імпорт не запускається. На паузі акаунта імпорт недоступний — спершу зніміть акаунт з паузи.
Імпортував, але бот не пише цим людям. Імпорт створює картки, а не право писати. Писати можна лише тим, хто сам натиснув Start у цього бота. Якщо ви імпортували базу чужого бота, повідомлення не дійдуть.
Важливе про повторний імпорт
Імпорт за тим самим ID оновлює наявний контакт, а не створює дубль (якщо ввімкнено «оновити поля»). Тому файл можна довантажити повторно, якщо ви забули колонку з тегами або помилилися в зіставленні.
Але зверніть увагу: бали при імпорті встановлюються, а не додаються. Повторний імпорт того самого файлу перезапише баланс тим самим значенням, а не подвоїть його.
Експорт
Зворотна операція теж доступна: кнопка «Експорт CSV» у «Контактах» вивантажує контакти рівно тими стовпчиками, які ви бачите на екрані. Це і резервна копія, і спосіб забрати свої дані будь-коли. Експорт доступний власнику й адміну.
Раз на місяць зберігати таке вивантаження — хороша звичка незалежно від того, чи плануєте ви кудись переїжджати.
Повʼязані сторінки
- Ретрансляція вебхука — як працювати у двох сервісах одночасно під час переїзду (налаштовується в картці бота, «Інтеграції»)
- Сегменти й умови — що робити з тегами й полями після імпорту
- Як забрати свої дані — повний експорт