Гайд

Импорт каталога автомобилей в Telegram

Три колонки обязательны, ещё пятнадцать формируют карточку, фотографии — ссылками. Что импорт проверяет, что отклоняет и чего он делать не будет.

AdminHub

Коротко. Импорт принимает CSV или XLSX, проверяет построчно, ничего при этом не создавая, показывает, что не прошло, и записывает объявления только когда вы нажмёте «зафиксировать». Обязательных колонок три — марка, модель, год, — а ещё пятнадцать решают, насколько карточка вообще что-то говорит. Фотографии приходят ссылками через вертикальную черту, не больше тридцати на объявление. Лимит проверяется в момент фиксации: три активных объявления на бесплатном тарифе, пятьдесят на Pro. И главное, что стоит знать заранее: это разовая загрузка, а не синхронизируемый фид.

Автомобили у вас уже в таблице. Кто-то выгрузил их из системы, которой вы пользуетесь, или вы набрали их руками, и теперь есть сорок строк и папка фотографий. Эта страница про то, как перенести всё это в каталог Telegram, не выясняя проблемы по одному объявлению за раз.

Начните с шаблона

Скачайте шаблон — CSV или XLSX, смотря что ваш инструмент открывает без возражений. Это строка заголовков и одно объявление для примера, и именно эти имена колонок ищет разборщик.

Пользоваться им необязательно. Обязательно совпасть по именам колонок, а шаблон — просто самый короткий способ в этом убедиться.

Три колонки, без которых нельзя

марка, модель, год. Строка, где не хватает любой из них, не проходит проверку и объявлением не становится.

Порог намеренно низкий, и стоит понимать, насколько. Строка только с этими тремя валидна: она импортируется и даст карточку, где написаны марка, модель и год — и больше ничего. «Прошло проверку» и «хорошо» — разные вещи.

Пятнадцать, которые решают, что скажет карточка

Всё остальное необязательно, и каждая оставленная пустой колонка — это строка, которой покупатель не увидит:

mileage_km · transmission · drivetrain · body_type · fuel_type · engine_volume_l · condition · vin · city · price_amount · price_original_amount · price_currency · price_negotiable · description · photo_urls

Две стоит назвать отдельно. price_original_amount — старая цена: заполните её, и карточка сможет показать снижение, а не просто число. price_negotiable — флаг, который отвечает на первый вопрос любого покупателя до того, как он его задаст.

Если чем-то жертвовать, жертвуйте vin и drivetrain. Не жертвуйте city и price_amount: именно они решают, напишет вам кто-нибудь вообще или нет.

Фотографии приходят ссылками

Адреса изображений кладите в photo_urls, разделяя вертикальной чертой:

https://example.com/photo-1.jpg | https://example.com/photo-2.jpg

Берётся до 30 на объявление, лишние игнорируются, а не роняют импорт. Адреса должны быть доступны в момент импорта: ссылка на файл за логином или та, что протухает, даст объявление без фотографий — и по таблице этого не увидеть.

Если фотографии существуют только на диске, загрузите их к объявлению после импорта. Для этого есть отдельный экран с перетаскиванием для порядка, и первая фотография — та, что поедет на карточке при пересылке.

Ничего не создаётся, пока вы не скажете

Импорт состоит из двух шагов, и разделение здесь важно.

Разбор читает файл и возвращает каждую строку с её собственными ошибками. Не создаёт вообще ничего. Вы получаете экран проверки, где видно, какие строки в порядке и что именно не так с остальными, — и чините файл один раз, вместо того чтобы потом удалять плохие объявления.

Фиксация — то, что записывает. Пока вы её не нажали, каталог не тронут.

Этим стоит пользоваться как задумано: загрузили, прочитали ошибки, починили таблицу, загрузили снова. Две минуты там дешевле, чем вечер ручной правки сорока объявлений.

Лимит срабатывает при фиксации, а не при загрузке

Активные объявления ограничены тарифом: 3 на бесплатном, 50 на Pro. Фиксация проверяет, сколько места осталось, и останавливается с явной ошибкой и числами, если места нет.

Так что загрузка сорока автомобилей на бесплатном тарифе — не та ошибка, которую система от вас прячет, но и не то, что сработает. Решите, какие три должны быть живыми, или перейдите на Pro до импорта, а не после.

Чего он не делает

Он не следит за вашим источником. Это разовая загрузка, а не фид. Нет адреса, за которым он наблюдает, нет запланированного обновления, ничто не замечает, что ваша главная таблица изменилась. Продали автомобиль — сами убираете объявление в архив; снизили цену — правите или импортируете заново.

Для каталога, который обновляется раз в месяц, это нормально. Для склада, который оборачивается за неделю, это настоящая нагрузка, и её стоит посчитать до того, как переносить годовой запас.

Если… то…

Если…То…
Автомобилей больше горсткиБерите файл — руками перестаёт быть разумно примерно на десяти
Фотографии уже лежат на сайтеphoto_urls быстрее, чем загружать их заново
Фотографии только на телефоне или дискеСначала импортируйте строки, фотографии добавьте после
Вы на бесплатном тарифеВыберите свои три до загрузки, а не после ошибки
Склад оборачивается каждую неделюЗдесь ничего не синхронизируется — заложите это обслуживание заранее
Вы продаёте два-три автомобиля в годФайл не нужен вовсе, заведите их руками

С чего начать

Возьмите десять строк, а не сорок. Заполните три обязательные колонки плюс city, price_amount и photo_urls и запустите разбор. Прочитайте, что он скажет об этих десяти: ошибки на маленьком файле те же самые, что были бы на большом, и читать их несравнимо дешевле.

Потом почините таблицу, зафиксируйте эти десять и посмотрите на карточки. Если карточка говорит достаточно, чтобы вам написали, — добавляйте остальные колонки и остальные строки. Если нет — недостающие строки это ровно те колонки, которые вы пропустили.


Чем каталог автомобилей в Telegram является как продукт и когда площадка всё же выигрывает — в статье про продажу автомобилей в Telegram. Чтобы настроить, начните со страницы объявлений.

Что обычно спрашивают

Какой файл принимает импорт?
CSV или XLSX. Шаблон можно скачать в любом из двух форматов — строка заголовков плюс один пример объявления, — и совпасть с его колонками это кратчайший путь к чистому импорту.
Какие колонки обязательны на самом деле?
Три: марка, модель и год. Всё остальное необязательно, и каждая пропущенная колонка — это строка, которой в карточке не будет. Объявление с одними обязательными полями пройдёт проверку и будет выглядеть ровно так, как звучит.
Как попадают фотографии?
Ссылками, в колонке photo_urls, несколько через вертикальную черту. Берётся до 30 на объявление, лишние просто игнорируются. Изображения должны быть доступны по этим адресам в момент импорта.
Можно проверить файл до того, как что-то создастся?
Да, ради этого разбор и отделён от фиксации. Шаг разбора не создаёт ничего: он возвращает каждую строку с её собственными ошибками, чтобы вы починили файл и загрузили заново. Записывает только шаг фиксации.
Что будет, если строк больше, чем позволяет тариф?
Фиксация останавливается с ошибкой 402 и называет числа: бесплатный воркспейс держит 3 активных объявления, Pro — 50. Он заполняет то место, которое есть, а не выбрасывает остаток молча, так что сверьтесь с числом до загрузки сорока автомобилей на тариф с тремя.
Он синхронизируется с моим исходным файлом?
Нет. Импорт — разовая загрузка, а не фид. Изменилась цена — вы либо правите объявление, либо импортируете снова: нет ни адреса, за которым он следит, ни запланированного обновления. Если склад оборачивается за неделю, это стоит учесть.