ШАГ 1: Подготовка CSV-файла
Подготовьте CSV-файл с Telegram User ID ваших подписчиков.
Что такое Telegram User ID?
Telegram User ID — это постоянный числовой идентификатор пользователя в Telegram.
Он не меняется и уникален для каждого пользователя.
Платформа использует только Telegram User ID для сопоставления пользователей при импорте.
Если Telegram User ID отсутствует — импорт невозможен.
По имени, номеру телефона или username привязка не выполняется, дубликаты не предотвращаются.
Где взять Telegram User ID подписчиков?
Вариант A: Экспорт из старого сервиса
- Откройте администраторскую панель старого конструктора
- Найдите раздел "Экспорт" или "Подписчики"
- Выберите "Скачать как CSV" или "Выгрузить"
- Убедитесь, что в файле есть столбец с Telegram ID (а не @username)
Вариант B: Если экспорта нет
- Свяжитесь с поддержкой старого сервиса
- Попросите выгрузку пользователей бота в формате таблицы с Telegram User ID и дополнительными данными при необходимости (категории, переменные)
- Если необходим перенос категорий и переменных - дополнительно запросите в техподдержке сервиса
Форматирование файла
Сохраните файл в формате CSV:
- Используйте программы: Excel, Google Sheets, Numbers
- Сохраняйте как: "Файл.csv"
Правила CSV:
- Первая строка = названия столбцов
- Один пользователь = одна строка
- Только числа в столбце telegram_user_id (без букв, кавычек, пробелов)
- Если переносите категории пользователей — перечислите через запятую: "VIP, Активный" (необязательно)
- Если переносите переменные — названия переменных укажите в заголовках соответствующих столбцов (необязательно)
- Пустое поле = ничего не пишите
Столбцы first_name, last_name, username можно добавить, но это необязательно.
Импорт регулярно выполняется и без этих столбцов — в этом случае бот будет подтягивать актуальные данные из Telegram по мере того, как пользователи начнут с ним взаимодействовать.
То есть:
- нет этих полей — происходит импорт только ID
- есть — запишутся как стартовые значения
ШАГ 2: Проверка тарифа
Перед импортом убедитесь, что хватит места:
Ваш тарифПользователей ботаЧто делать
Бесплатный
150
Если > 150 — обновите тариф до креативного
Креативный
1000
Если > 1 000 — выберите расширенный
Расширенный
10000
Если > 10 000 — выберите профессиональный
Профессиональный
20000
Если > 20 000 — напишите в поддержку
Если количество пользователей в файле превышает лимит тарифа — импорт не произойдёт.
Дополнительные возможности:
Вместе с подписчиками можно сразу импортировать и дополнительные данные: имя, фамилию, юзернейм, город, теги и т.п.
Это помогает сразу сегментировать базу, но не является обязательным условием для импорта.
- Переменные (имя, город и т.д.)
Можно импортировать до 10 пользовательских переменных.
Если переменные заранее созданы в боте, данные из столбцов CSV будут сразу записаны в эти поля. Если нет — мы импортируем только Telegram ID, а остальное можно будет собирать уже в процессе работы бота. - Категории
Если хотите сразу разложить пользователей по категориям, добавьте отдельный столбец categories и перечисляйте категории через запятую.
Если категория не задана или столбца нет — это нормально, импорт всё равно выполняется.
ШАГ 3: Отправьте файл в поддержку
- Откройте чат поддержки PuzzleBot в Telegram @helpmepuzzlebot
- В сообщении напишите:
- Количество контактов в файле
- Какие дополнительные данные импортируете (имена, категории и т.д.)
- Прикрепите CSV-файл
Пример:
Привет! Хочу импортировать 5000 подписчиков из [название старого сервиса].
В файле есть: ID, имя, город (переменная), категория.
Файл прикреплён: subscribers.csv
ШАГ 4: Ожидание и проверка
Импорт занимает до 2 рабочих дней (пн-пт, кроме праздников).
По завершению вы получите сообщение от техподдержки: "Импорт завершён! Добавлено 5000 контактов"
❓ Частые вопросы
Q: Можно ли изменить файл после отправки?
A: Нет. Если заметили ошибку — сообщите в поддержку, они заново загрузят исправленный файл.
Q: Что если пользователь уже есть в PuzzleBot?
A: Он не будет добавлен дважды. Система проверит по Telegram ID и обновит его данные.
Q: Мне нужно импортировать 50 000 контактов, это возможно?
A: Да, обратитесь в нашу техподдержку в Telegram @helpmepuzzlebot