Как заполнить CSV и исправить ошибки импорта
Разберитесь с колонками, датами, ценами и предупреждениями проверки.
Обновлено
Содержание статьи
Требования к файлу
Откройте окно импорта и скачайте актуальный «Шаблон CSV».
Где: Мои клубы → выберите клуб → Участники → Импортировать
Показать кнопку «Импортировать» (в новой вкладке)
Импорт: шаблон CSV, файл и общая дата
Рамка показывает: ссылка «Шаблон CSV»
Откройте файл в табличном редакторе. Первая строка содержит восемь названий колонок; каждого участника записывайте в отдельную строку.
Задайте текстовый формат для email, даты, исходного ID и Telegram ID перед заполнением. Сохраните файл как CSV UTF-8 с разделителем запятая.
Скачайте актуальный «Шаблон CSV» в окне импорта. Сохраните файл в UTF-8, размером до 1 МБ, не более 1000 строк участников. Все восемь колонок шаблона должны присутствовать; лишние и повторяющиеся названия колонок не допускаются. Значения необязательных полей можно оставить пустыми.
Даты записываются как YYYY-MM-DD, например 2030-12-31. Это пример: используйте реальную будущую дату окончания доступа. Доступ действует до конца указанного дня по московскому времени. При экспорте из таблицы используйте CSV с разделителем запятая; значения с запятой заключаются в кавычки.
Как заполнить шаблон в Excel или Google Таблицах
Шаблон содержит только заголовки. Каждая следующая строка — один участник. Добавьте данные под заголовками, оставьте все восемь колонок на месте и удалите учебные строки перед настоящим импортом.
Откройте скачанный шаблон в Excel или Google Таблицах. При импорте укажите кодировку UTF-8 и разделитель «запятая», чтобы заголовки оказались в восьми отдельных колонках.
До заполнения задайте текстовый формат для
access_until,source_member_idиtelegram_id. Введите даты буквально какYYYY-MM-DD; не используйте формулы и не переносите email в числовые поля.Заполните
emailиaccess_typeу каждого человека. Дляpaidукажите дату уже оплаченного доступа; бесплатному участнику без срока оставьтеaccess_untilпустым и не задавайте общую дату при загрузке.В Excel выберите «Сохранить как» → «CSV UTF-8 (разделитель — запятая)». В Google Таблицах: «Файл» → «Скачать» → «CSV». Если получился разделитель точка с запятой, выберите экспорт с запятой или настройте его в редакторе.
Загрузите файл в окне импорта и нажмите «Проверить файл». Сверьте тип доступа, конечную дату и цену в каждой строке.
Показать кнопку «Импортировать» (в новой вкладке)
Импорт: предварительная проверка
Рамка показывает: тип доступа, дата и следующая цена
Что писать в колонках
| Поле | Как заполнить | Пример значения |
|---|---|---|
email | Обязательный email участника для приглашения и входа. Он не должен повторяться в файле или конфликтовать с существующим участником. | member@example.com |
access_type | Обязательное значение paid для оплаченного доступа или free для бесплатного. | paid или free |
access_until | Будущая дата YYYY-MM-DD. Для paid обязательна в строке или через общую дату при загрузке. Для free без даты и без общей даты доступ не ограничен сроком. | 2030-12-31 |
display_role | Отображаемая роль, до 100 символов. Пустое значение станет «Участник» и само по себе не выдаёт права модератора. | Гость |
next_price_rub | Цена следующего платного периода в рублях, больше нуля, до двух знаков после запятой. Если пусто, используется цена клуба на момент подтверждения импорта; в проверке будет «По цене клуба». Сверьте её в настройках цены клуба. Для free оставьте пустым. | 1500 или 1500.50 |
source_member_id | Необязательный уникальный ID участника на исходной платформе, до 200 символов. Помогает избежать повторного переноса. | old-001 |
telegram_id | Необязательный положительный числовой ID аккаунта Telegram. Это не ID группы. Сохраняйте как текст, чтобы таблица не округлила длинное число. | Оставьте пустым, если ID неизвестен |
telegram_username | Необязательный username, можно с @. Username может измениться и не заменяет Telegram ID. | @username — только реальный username |
Примеры строк
email | access_type | access_until | next_price_rub | Результат без общей даты |
|---|---|---|---|---|
paid-member@example.com | paid | 2030-12-31 | 1500.50 | Доступ до конца 31.12.2030 по Москве; следующая цена 1500,50 ₽ |
club-price@example.com | paid | 2030-11-30 | Пусто | Оплаченный срок до 30.11.2030; следующая цена из настроек клуба |
free-member@example.com | free | Пусто | Пусто | Бесплатный доступ без срока, если общая дата не задана |
guest@example.com | free | 2030-10-31 | Пусто | Бесплатный доступ до конца 31.10.2030 по Москве |
Скачать пример CSV: платный и бесплатный доступ
Скачать пример CSV для общей даты
| Поле | Оплаченный участник | Бесплатный участник |
|---|---|---|
email | paid-member@example.com | free-member@example.com |
access_type | paid | free |
access_until | 2030-12-31 | Пусто |
display_role | Участник | Гость |
next_price_rub | 1500 | Пусто |
source_member_id | old-001 | old-002 |
telegram_id | Пусто | Пусто |
telegram_username | Пусто | Пусто |
Как исправить ошибки
| Сообщение | Что проверить |
|---|---|
| Некорректный email или повтор email | Исправьте адрес и уберите повторяющиеся строки. |
| Не указана или уже прошла дата доступа | Для paid задайте будущую дату в строке либо общую дату при загрузке. |
| Некорректная цена | Используйте число в рублях без символа ₽; проверьте цену клуба, если поле пустое. |
| ID уже импортирован или Telegram ID уже привязан | Проверьте существующих участников; не переносите одного человека повторно. |
| Будет превышен лимит участников | Проверьте текущий тариф и размер базы после переноса. |
| Неверные колонки или формат | Скачайте шаблон заново и проверьте экспорт CSV в UTF-8. |
Что означают предупреждения
«Аккаунт не найден в Telegram-группе» сообщает о фактическом присутствии, а не об ошибке email. «Username указан без Telegram ID» означает, что имя не позволяет подтвердить конкретный аккаунт. При отсутствии ID участник привяжет Telegram сам.
Если участник — администратор группы, Telegram может не разрешить автоматическое удаление старого аккаунта. Если проверка Telegram не удалась, проверьте готовность группы и интеграции. Предупреждения изучайте до подтверждения; ошибки необходимо исправить.
После исправления загрузите файл и проверьте его заново. Убедитесь, что даты, цены и число строк в предварительном просмотре соответствуют вашему списку.