Магазин у Telegram — це ваш каталог Elbuz, який покупець гортає прямо в месенджері: дивиться категорії, відкриває картки товарів із фотографіями, складає кошик і оформлює замовлення, не виходячи з Telegram. Окремого каталогу для цього не ведуть — товари, ціни й наявність ті самі, що на сайті.
Підключення зводиться до одного значення: ви створюєте бота в Telegram, копіюєте його токен і вставляєте в Elbuz. Решту — реєстрацію бота, отримання його імені й адреси — програма робить сама.
Не плутайте з ботом підтримки. Магазин у Telegram показує покупцеві вітрину; бот підтримки веде листування з клієнтом і живе в іншому місці програми. Це різні підключення з різними токенами, і один одному вони не заважають.
Перед початком: магазин має вже працювати
Telegram не зберігає ваш каталог — він показує те, що віддає ваш сайт. Тому спершу має бути готовий сам інтернет-магазин на платформі: каталог заповнений, товари активні, сайт відкривається.
Друга умова технічна, але про неї спотикаються найчастіше: сайт має працювати за захищеним протоколом. Telegram реєструє адресу для зворотних викликів тільки з https, і на звичайному http підключення просто не відбудеться.
Мова тут саме про магазин на платформі Elbuz — той, який розгортається з програми. Якщо ви оновлюєте тунелем чужий сайт на сторонній CMS, бот-магазин до нього не підключається: налаштувань Telegram у такого шаблона немає.
Крок 1. Створити бота й узяти токен
Бот створюється в самому Telegram, не в Elbuz. Порядок такий:
- Відкрийте в Telegram чат із @BotFather — це офіційний бот для створення ботів.
- Надішліть команду
/newbot. - Вкажіть назву — її покупці побачать у заголовку чату.
- Вкажіть адресу бота: латиницею, обов'язково із закінченням
bot, наприкладmy_shop_bot. Якщо таку адресу вже зайнято, BotFather попросить іншу. - У відповідь прийде повідомлення з токеном — довгий рядок із цифр і літер через двокрапку. Скопіюйте його.
Токен — це ключ до вашого бота, такий самий за значенням, як пароль. Хто його має, той може писати від імені вашого магазину. Не пересилайте його в загальні чати й не публікуйте на сайті.
Крок 2. Вставити токен у Elbuz
Вікно налаштувань відкривається з картки шаблону, яким каталог їде у ваш магазин на платформі.
- Меню
- Довідники → Вивантаження даних
- Далі
- відкрийте шаблон типу Elbuz CMS → кнопка «Магазин Telegram»
Кнопки не буде, поки магазин на платформі не створено. Вона з'являється тільки в шаблона типу Elbuz CMS і тільки після того, як магазин справді розгорнуто — у шаблона звичайного тунелю до чужого сайту цієї кнопки немає взагалі. Це й є технічне вираження умови з попереднього розділу: спершу магазин, потім бот.
Вставте токен у поле «Токен бота» й натисніть «Підключити». За цією кнопкою програма робить два звернення до Telegram поспіль.
Спершу вона реєструє адресу зворотного виклику: каже Telegram, куди надсилати дії покупців — на службову сторінку вашого сайту. Саме через неї бот дізнається, що людина натиснула кнопку в чаті, і саме тому сайт має бути на https.
Потім програма питає у Telegram, що це за бот, і заповнює два поля, які ви самі не редагуєте: «Ім'я бота» — назва, яку ви дали при створенні, і «Адреса бота» — посилання виду https://t.me/my_shop_bot. Поруч із адресою є значок, який відкриває бота одразу.
Якщо все пройшло, з'явиться повідомлення про успішне підключення разом із відповіддю Telegram. Тепер відкрийте бота за його адресою й натисніть Start — магазин має показати привітання й кнопки каталогу.
Крок 3. Налаштування магазину
У тому ж вікні є кілька налаштувань. Їх небагато — саме тому, що вітрина береться з вашого каталогу, а не будується заново.
| Налаштування | Що робить |
|---|---|
| Текст привітання | повідомлення, яке покупець бачить при першому запуску магазину. Задається окремо для кожної мови, які увімкнені у вашій програмі |
| Звук навігації | чи озвучувати повідомлення під час роботи з ботом |
| Режим обслуговування | ховає магазин від покупців: вони бачать повідомлення про обслуговування. Для менеджерів зі списку магазин продовжує працювати — зручно, коли треба щось перевірити на живому боті |
| Кількість фото | скільки зображень показувати в картці товару |
Привітання варто написати для кожної мови, якою ви торгуєте. Покупець із іншим інтерфейсом Telegram отримає текст своєю мовою, якщо він заданий; порожнє поле означає, що привітання цією мовою просто не буде.
Як бот виглядає в Telegram
Назва, опис, текст на стартовому екрані й картинка профілю — це властивості самого бота, і живуть вони в Telegram, а не в Elbuz. Змінюються там же, у BotFather:
- відкрийте чат із @BotFather і надішліть
/mybots; - виберіть свого бота й натисніть Edit Bot;
- Edit Name — назва, Edit About — короткий опис у профілі, Edit Description — текст, який видно до першого запуску, Edit Botpic — картинка профілю.
Зміни застосовуються одразу, перепідключати токен у Elbuz після них не треба.
Обмеження, про які краще знати заздалегідь
- Один бот на акаунт. Налаштування магазину Telegram зберігаються в одному екземплярі: підключити двох ботів до одного акаунта Elbuz не вийде. Новий токен замінює попередній.
- Магазин показує ваш каталог, а не окремий. Сховати товар від Telegram, лишивши його на сайті, окремим прапорцем не можна — вітрина одна.
- Змінили домен сайту — підключіть заново. Адреса зворотного виклику записується в Telegram один раз, за старою адресою вона й лишиться.
Розбір частих проблем
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Вкажіть токен для підключення до Telegram бота!» | натиснули «Підключити» з порожнім полем | вставте токен із BotFather |
| «Збій у підключенні веб хука до Telegram!» | Telegram не прийняв адресу зворотного виклику: найчастіше сайт не на https або недоступний ззовні | перевірте, що сайт відкривається за https з іншого пристрою, і натисніть «Підключити» ще раз |
| Підключення пройшло, але «Ім'я бота» й «Адреса бота» порожні | адресу зареєстровано, а другий запит до Telegram не відповів | натисніть «Підключити» ще раз: токен уже збережений, програма просто перепитає назву |
| Бот відповідає, а товарів немає | каталог на сайт ще не вивантажений або всі товари неактивні | запустіть вивантаження на сайт і перевірте, чи відкривається каталог у браузері |
| У картці шаблону немає кнопки «Магазин Telegram» | шаблон не того типу або магазин на платформі ще не створений | перевірте, що це шаблон типу «Elbuz CMS» і що магазин уже розгорнуто |
| Покупці бачать повідомлення про обслуговування | увімкнений «Режим обслуговування» | переключіть його в «Ні» |
| Бот перестав відповідати після переїзду сайту | адреса зворотного виклику лишилася стара | відкрийте налаштування й натисніть «Підключити» заново |
Часті питання
Чи потрібен окремий домен для магазину в Telegram?
Ні. Магазин показує той самий сайт, який у вас уже є; бот лише вітрина до нього. Окремий домен потрібен тільки тоді, коли самого сайту ще немає.
Чи можна підключити двох ботів — на різні магазини?
Ні, налаштування зберігаються в одному екземплярі на акаунт. Якщо вставити другий токен, він замінить перший, і попередній бот перестане працювати.
Як товари потрапляють у Telegram?
Через ваш сайт: бот читає той самий каталог. Окремого вивантаження «в Telegram» немає — оновили каталог на сайті, оновилося й у боті.
Чи можна приймати оплату прямо в боті?
Оплата й доставка працюють так само, як на сайті, — тими модулями, які до нього підключені. Окремих налаштувань оплати у вікні магазину Telegram немає.
Я змінив токен у BotFather. Що робити?
Вставте новий токен у поле й натисніть «Підключити» ще раз. Програма перереєструє адресу зворотного виклику й перечитає дані бота.
Як перевірити, що підключення справді працює?
Відкрийте бота за адресою з поля «Адреса бота» й натисніть Start. Якщо прийшло привітання й кнопки каталогу — усе на місці. Якщо нічого не сталося, перевірте, чи відкривається ваш сайт за https.
Суміжні теми
- Свій сайт через Elbuz Tunnel — як каталог потрапляє на сайт, який показує бот.
- Розумний чат для сайту — листування з покупцем, а не вітрина.
- Обробка замовлень покупця — що відбувається із замовленням після того, як його оформили в боті.