Гайд

Імпорт каталогу автомобілів у 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. Він заповнює те місце, що є, а не викидає решту мовчки, тож звіртеся з числом до завантаження сорока автомобілів на тариф із трьома.
Чи синхронізується він із моїм вихідним файлом?
Ні. Імпорт — разове завантаження, а не фід. Змінилася ціна — ви або правите оголошення, або імпортуєте знову: немає ні адреси, за якою він стежить, ні запланованого оновлення. Якщо склад обертається за тиждень, це варто врахувати.