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