Як відкрити магазин у Telegram на каталозі Elbuz

Що вміє магазин у Telegram

• Сайт як Mini App — каталог, кошик і оформлення відкриваються в Telegram, у темі покупця.
• Вхід без пароля — покупця впізнають за його Telegram, обліковий запис у магазині створюється сам.
• Команди бота — /shop, /catalog, /cart, /orders, /support прямо в чаті.
• Сповіщення про статус — бот пише покупцеві, коли змінюється статус його замовлення.
• Нові замовлення — менеджерам — кожне замовлення з Telegram приходить у групу менеджерів.
• Розсилка — повідомлення з картинкою й кнопкою всім підписникам бота.
• Той самий каталог, що й на сайті — оновили каталог на сайті, оновилося й у Telegram.

Де це і хто має доступ

Вхід в адмінку магазину

Elbuz: Вивантаження даних → шаблон типу Elbuz CMSПрограма, на якій працює сайт інтернет-магазину: у ній ведуть сторінки, товари, меню й оформлення. Приклади — OpenCart, WordPress. → картка «Магазин» → «Увійти в адмінку магазину»

Модуль

в адмінці магазину: Доповнення → Доповнення → тип «Модулі» → «Elbuz - Telegram Store»

Право доступу

адміністратор магазину; в Elbuz — вікно «Вивантаження даних»

Підготувати

розгорнутий магазин на платформі Elbuz із сайтом на https

Що бачить покупець: Mini App і команди бота

Mini App. Кнопка «Магазин» біля поля введення чи «Відкрити магазин» у чаті відкриває ваш сайт усередині Telegram. Це не копія каталогу, а сам сайт: ті самі сторінки, кошик і оформлення замовлення. Дизайн той самий, що й у сайту, а кольори підлаштовуються під тему Telegram — світлу чи темну.

1

Ваш сайт усередині Telegram

2

Нижнє меню сайту

1. Той самий дизайн, каталог і ціни, що й на сайті.
2. Головна, каталог, обране, порівняння й кошик.

У кошику внизу екрана Telegram показує кнопку «Оформити замовлення», а після оформлення Mini App закривається сама за кілька секунд.

1

Товар з обраними опціями

2

Оформити замовлення

1. Кількість змінюється тут же, допродажі — блок «Вам також сподобається».
2. Оформлення йде на вашому сайті, у тій самій Mini App.

Вхід. Покупцеві не треба реєструватися: магазин перевіряє підпис Telegram і впускає людину під її обліковим записом Telegram. При першому відкритті для неї створюється покупець у магазині. Якщо в людини вже є обліковий запис на вашому сайті, вона може привʼязати до нього Telegram: у розділі облікового запису Mini App показує форму з email і паролем.

Команди бота

Крім Mini App, бот відповідає на команди в чаті:

Що має бути готово перед підключенням

Telegram не зберігає ваш каталог — він показує ваш сайт. Тому спершу має бути готовий сам інтернет-магазин на платформі Elbuz: каталог вивантажений, товари активні, сайт відкривається.

Сайт має працювати за захищеним протоколом. Telegram відкриває Mini App і надсилає повідомлення покупців боту тільки на адреси з https.

Модуль є лише в магазині на платформі Elbuz — тому, що розгортається з програми. Для чужого сайту на сторонній CMS, який ви оновлюєте тунелем, магазину в Telegram немає.

Крок 1. Створити бота й узяти токен

Бот створюється в самому Telegram, не в Elbuz:

1. Відкрийте в Telegram чат із @BotFather — це офіційний бот для створення ботів.
2. Надішліть команду /newbot.
3. Вкажіть назву — її покупці побачать у заголовку чату.
4. Вкажіть адресу бота: латиницею, обов'язково із закінченням bot, наприклад my_shop_bot. Якщо таку адресу вже зайнято, BotFather попросить іншу.
5. У відповідь прийде повідомлення з токеном — довгий рядок із цифр і літер через двокрапку. Скопіюйте його.

Крок 2. Увімкнути модуль з токеном

1. Увійдіть в адмінку магазину з Elbuz (шлях — у розділі «Де це»).
2. Відкрийте Доповнення → Доповнення, у списку типів виберіть «Модулі» й знайдіть «Elbuz - Telegram Store». Якщо модуль ще не встановлено, натисніть «Встановити», потім «Редагувати».
3. На вкладці «Основні налаштування» вставте токен у поле «Bot Token», увімкніть перемикач «Статус модуля» й збережіть.

1

Вкладки модуля

2

Статус модуля

3

Bot Token

4

Mini App URL

1. Оплата, сповіщення, тексти бота, підтримка, чат і користувачі Telegram.
2. Без токена модуль не ввімкнеться.
3. Токен від @BotFather; на кадрі замаскований.
4. Порожнє поле — Mini App відкриває поточний домен магазину.

Без токена модуль не ввімкнеться: збереження зупиниться з повідомленням «Bot Token обов'язковий при увімкненні модуля.». Поле «Mini App URL» можна лишити порожнім — тоді Mini App відкриває поточний домен магазину.

Крок 3. Webhook, команди й кнопка меню

Після збереження на тій самій сторінці натисніть по черзі три кнопки:

1. «Встановити Webhook» — Telegram запамʼятає адресу вашого сайту, куди надсилати повідомлення покупців. Без цього бот мовчить. Кнопка «Перевірити Webhook» показує, яку адресу Telegram знає зараз.
2. «Встановити команди бота» — у чаті зʼявиться меню команд /start, /shop, /catalog та інших мовами вашого магазину.
3. «Встановити кнопку меню» — біля поля введення зʼявиться кнопка, що відкриває магазин як Mini App. Її текст задається в полі «Текст кнопки меню» окремо для кожної мови; порожнє поле — «🛍 Магазин».

Відкрийте бота й надішліть /start: має прийти привітання з кнопкою «Відкрити магазин».

1

Привітання на /start

2

Кнопка меню

1. Текст привітання змінюється на вкладці «Тексти бота».
2. З'являється після «Встановити кнопку меню» і відкриває магазин як Mini App.

Інші налаштування вкладки «Основні налаштування»:

• «Відкривати категорії в Mini App» — у /catalog категорія без підкатегорій відкриває сторінку сайту з фото замість текстового списку товарів.
• «Приховати товари не в наявності» — у каталозі команд бота лишаються тільки товари з кількістю більше нуля. На сайт і Mini App це не діє.
• «Mini App Setup» — підказка для одноразового налаштування в @BotFather (Bot Settings → Configure Mini App). Після нього працюють посилання, що відкривають у Telegram одразу товар, категорію чи кошик.

Оплата, сповіщення й підтримка

Як змінити назву й картинку бота

Назва, опис, текст на стартовому екрані й картинка профілю — властивості самого бота, і змінюються вони в Telegram, у BotFather:

1. відкрийте чат із @BotFather і надішліть /mybots;
2. виберіть свого бота й натисніть Edit Bot;
3. Edit Name — назва, Edit About — короткий опис у профілі, Edit Description — текст, який видно до першого запуску, Edit Botpic — картинка профілю.

Зміни застосовуються одразу, вставляти токен заново не треба.

Сценарії

Перевірити магазин у Telegram до того, як дати посилання покупцям

Що зробити: пройдіть кроки 1–3, відкрийте бота зі свого Telegram, натисніть «Відкрити магазин», покладіть товар у кошик і оформіть тестове замовлення.

Що вийде: ви побачите те саме, що побачить покупець, а тестове замовлення прийде в магазин, як звичайне замовлення з сайту.

Чого не станеться: окремого прихованого режиму для перевірки немає. Бот доступний кожному, хто знає його адресу, тож не публікуйте посилання, доки не перевірите.

Покупець має дізнаватися про статус замовлення в Telegram

Що ввімкнути: на вкладці «Сповіщення» — «Увімкнути сповіщення» і шаблони для потрібних статусів, наприклад «Відправлено».

Що вийде: коли замовлення переходить у статус із шаблоном, бот надсилає покупцеві повідомлення його мовою.

Чого не станеться: повідомлення отримають лише покупці, які заходили в магазин через Telegram і не вимкнули сповіщення командою /settings. Для статусу з порожнім шаблоном повідомлення немає.

1

Сповіщення про статус

1. Текст — шаблон статусу «Відправлено» з вкладки «Сповіщення».

Менеджери мають одразу бачити нові замовлення з Telegram

Що ввімкнути: на вкладці «Підтримка» впишіть «Chat ID групи менеджерів» — як для /support. Перемикач «Нові замовлення — менеджерам» на вкладці «Сповіщення» за замовчуванням увімкнений.

Що вийде: на кожне нове замовлення з бота чи Mini App бот один раз пише в групу номер, суму, товари й контакт покупця. Текст іде мовою магазину за замовчуванням, хай якою мовою користується покупець.

Чого не станеться: замовлення, оформлені на сайті в звичайному браузері, у групу не приходять — лише ті, що прийшли з Telegram. Без Chat ID групи сповіщень немає.

Розіслати підписникам бота акцію

Що зробити: вкладка «Користувачі Telegram» → «Розсилка». Напишіть «Текст» — можна жирний, курсив і посилання; додайте «Картинку» з менеджера зображень або за адресою і, якщо треба, «Кнопку під повідомленням» з текстом і посиланням. У «Куди надіслати тест» впишіть свій Telegram ID і натисніть «Надіслати тест», потім — «Надіслати всім».

Що вийде: повідомлення отримають усі, хто запускав бота й не вимкнув сповіщення; їхню кількість вікно показує заздалегідь. Хід розсилки — у «Останні розсилки»: отримувачів, доставлено, помилки, скільки людей заблокували бота. Хто заблокував бота, наступних розсилок уже не отримує.

Чого не станеться: зупинити розсилку після початку не можна. Сторінку не закривайте до кінця: якщо закрили, розсилка лишиться «Не завершено», і її дошлють кнопкою «Продовжити». Текст обмежений: з картинкою — до 1024 символів, без неї — до 4096.

1

Скільки людей отримають

2

Текст розсилки

3

Тест собі

4

Надіслати всім

1. Підписники, які не вимкнули сповіщення.
2. Жирний, курсив і посилання; з картинкою — до 1024 символів.
3. Telegram ID для тесту; на кадрі замаскований.
4. Зупинити розсилку після початку не можна.

1

Тестове повідомлення

1. Так повідомлення побачать підписники.

Питання покупців мають бачити менеджери

Що ввімкнути: створіть групу в Telegram, додайте в неї бота адміністратором і впишіть її номер у «Chat ID групи менеджерів» на вкладці «Підтримка». Як дізнатися номер, підказує сама вкладка.

Що вийде: покупець натискає «Підтримка» чи надсилає /support, пише питання, і бот пересилає його в групу. Відповісти можна з вкладки «Чат» модуля.

Чого не станеться: ці діалоги не потрапляють у звернення Elbuz. Щоб листування з клієнтами велося в Elbuz, підключіть окремий бот підтримки.

Що робити, коли бот не працює

Часті запитання

Чи потрібен окремий домен для магазину в Telegram?

Ні. Mini App відкриває той самий сайт, який у вас уже є. Окремий домен потрібен тільки тоді, коли самого сайту ще немає.

Чи можна підключити двох ботів до одного магазину?

Ні, у модуля одне поле «Bot Token». Новий токен замінить попередній, і старий бот перестане отримувати повідомлення.

Як товари потрапляють у Telegram?

Через ваш сайт: Mini App — це сам сайт, а команди бота читають той самий каталог. Окремого вивантаження «в Telegram» немає — оновили каталог на сайті, оновилося й у Telegram.

Чи можна показати в Telegram лише частину товарів?

Ні, вітрина одна: у Telegram той самий каталог, що й на сайті. Можна лише прибрати товари не в наявності з каталогу команд бота перемикачем «Приховати товари не в наявності»; у Mini App вони лишаються такими, як на сайті.

Чи можна приймати оплату прямо в Telegram?

Так, якщо на вкладці «Оплата» вказано токен платіжного провайдера з @BotFather: під замовленням зʼявиться кнопка «Оплатити в Telegram». Без нього покупець платить на сайті тими способами, що підключені до магазину.

Я змінив токен у BotFather. Що робити?

Вставте новий токен у «Bot Token», збережіть і знову натисніть «Встановити Webhook», «Встановити команди бота» й «Встановити кнопку меню».

Як перевірити, що підключення справді працює?

Відкрийте свого бота й надішліть /start. Якщо прийшло привітання з кнопкою «Відкрити магазин» і магазин відкривається — усе на місці. Якщо бот мовчить, натисніть «Перевірити Webhook» у модулі.

Суміжні теми

• Якщо Mini App відкривається, а каталог порожній чи застарілий — як каталог потрапляє на сайт.
• Якщо замовлення з Telegram уже прийшло і його треба обробити — Обробка замовлень покупця.
• Якщо з клієнтами в Telegram треба листуватися у зверненнях Elbuz — Боти підтримки.
• Якщо потрібен чат на самому сайті — Розумний чат для сайту.