Телеграм бот магазину Elbuz CMS сам пише покупцям про статус замовлення, пересилає їхні питання менеджерам і надсилає розсилки підписникам. Бот підключається одним токеном з @BotFather у налаштуваннях магазину в Elbuz.
Коли це знадобиться:
- Покупці дзвонять дізнатися, де замовлення — бот пише їм, щойно змінюється статус.
- Нове замовлення з Telegram треба побачити одразу — бот надсилає його в групу менеджерів.
- Треба розповісти про акцію — розсилка з картинкою й кнопкою приходить усім підписникам бота.
- Покупець просить видалити його дані — одна кнопка прибирає його запис у боті разом із листуванням.
З чого почати: «Налаштування магазину» → «Інтеграції» → картка «Telegram-магазин» і токен бота.
Що вміє Telegram-бот магазину
- Сповіщати покупця — повідомлення про кожен статус замовлення, своїм текстом для кожної мови.
- Надсилати нові замовлення менеджерам — у вашу групу Telegram, разом із товарами й контактом.
- Пересилати питання покупців — менеджер відповідає з групи, покупець отримує відповідь від бота.
- Приймати оплату в чаті — карткою через платіжного провайдера або зірками Telegram.
- Показувати, хто користується ботом — пошук, відбір і видалення даних на прохання людини.
- Робити розсилку — текст, картинка й кнопка всім підписникам, з тестом і журналом.
Що бачить покупець у самому боті — каталог, кошик, команди, магазин як Mini App — у статті «Магазин у Telegram».
Як підключити бота
Потрібні бот у Telegram і сайт на захищеній адресі https://: на інші адреси Telegram повідомлення боту не надсилає.
- Створіть бота. У Telegram відкрийте @BotFather, надішліть
/newbot, задайте назву й адресу бота латиницею із закінченнямbot, наприкладtechnodim_shop_bot. - Скопіюйте токен з відповіді BotFather. Він має вигляд
123456789:AAE…. - Відкрийте екран модуля: «Налаштування магазину» → розділ «Інтеграції» → картка «Telegram-магазин».
- У блоці «Бот» вставте «Токен бота», а в «Ім’я користувача бота (username)» — адресу бота без
@. - Увімкніть перемикач «Увімкнено» вгорі екрана і натисніть «Зберегти».
1
Картка «Telegram-магазин»2
Позначка стану- Відкриває налаштування бота магазину.
- Чи ввімкнено бота і чи дійшли останні зміни до магазину.
1
Ім’я користувача бота (username)2
Адреса міні-застосунку (Mini App)3
Стан у магазині- Адреса бота без @.
- Адреса сайту для налаштування Mini App у BotFather.
- Чи дійшли зміни до магазину, бот і оплата.
Протягом 5 хвилин після збереження магазин сам підключить бота в Telegram: адресу для повідомлень, кнопку меню і меню команд. Натискати нічого не треба. Перевірка — надішліть боту /start.
Токен — ключ до вашого бота: хто його знає, пише від імені магазину. Після збереження токен на екрані не показується, видно лише, що він заданий. Новий токен з BotFather просто вставте замість старого й збережіть.
Без токена ввімкнений модуль не збережеться. Як працюють «Зберегти», статуси й секретні поля — у статті «Налаштування магазину».
Інші поля блоку «Бот»
| Поле | Що робить | Типово |
|---|---|---|
| Текст кнопки меню | Напис на кнопці ліворуч від поля введення в чаті, окремо для кожної мови. Кнопка відкриває магазин усередині Telegram | «🛍 Магазин» |
| Відкривати категорії в міні-застосунку | Категорія без підкатегорій відкривається сторінкою сайту з фото. Вимкнено — товари йдуть списком прямо в чаті | увімкнено |
| Приховати товари не в наявності | У каталозі бота лише товари із залишком. На сайт це не діє | увімкнено |
| Адреса міні-застосунку (Mini App) | Адреса вашого сайту для BotFather, з кнопкою «Копіювати». Змінювати її не потрібно | адреса магазину |
Посилання на товар у Telegram
Щоб посилання відкривали товар, категорію чи кошик одразу в Telegram, один раз увімкніть Mini App у BotFather: /mybots → ваш бот → Bot Settings → Configure Mini App. Адресу візьміть з поля «Адреса міні-застосунку (Mini App)».
Посилання тоді мають вигляд https://t.me/technodim_shop_bot?startapp=product_42 — товар 42. Для категорії — category_7, для кошика — cart.
Як повідомляти покупця про статус замовлення
- У блоці «Сповіщення» увімкніть «Увімкнути сповіщення».
- Під перемикачем з'являться «Шаблони сповіщень»: відкрийте потрібний статус і впишіть текст для кожної мови магазину.
- Натисніть «Зберегти».
1
Увімкнути сповіщення2
Нові замовлення — менеджерам3
Текст для статусу «Відправлено»4
Статус без тексту- Покупці отримують повідомлення про зміну статусу замовлення.
- Нові замовлення з Telegram надходять у групу менеджерів.
- Текст повідомлення; змінні підставляються з замовлення.
- Порожній рядок: для цього статусу повідомлення не надсилається.
У «Шаблонах сповіщень» — рядок на кожен статус замовлення магазину. Для статусів «Очікує», «В обробці», «Відправлено», «Виконано» і «Скасовано» тексти вже вписано. Про статус без тексту бот не пише.
У текст підставляються дані замовлення: {order_id} — номер, {customer_name} — ім'я покупця, {order_total} — сума, {order_status} — назва статусу, {store_name} — назва магазину. Приклад: Замовлення #{order_id} відправлено! Сума: {order_total}.
Хто отримає повідомлення
- Покупець, чий кабінет у магазині пов'язаний з Telegram: замовляв через бота чи магазин у Telegram або прив'язав бота до кабінету.
- Лише якщо він не вимкнув сповіщення командою
/settingsу боті. - Мовою, обраною в боті, інакше мовою його Telegram, якщо така є в магазині; немає — мовою магазину. Для мови без тексту бот бере англійський текст, потім текст мови магазину.
Повідомлення йде, коли змінюється статус замовлення в магазині. Покупцям, які купували лише на сайті без Telegram, бот написати не може.
Як отримувати замовлення й питання в групу менеджерів
Бот пише в одну групу Telegram: нові замовлення і питання покупців.
- Створіть у Telegram групу менеджерів і додайте в неї бота.
- Дізнайтеся Chat ID групи — від'ємне число, що починається з
-100, наприклад-1001234567890. - У блоці «Підтримка» впишіть його в «Ідентифікатор групи менеджерів (Chat ID)» разом із мінусом і збережіть.
Нові замовлення
Перемикач «Нові замовлення — менеджерам» у блоці «Сповіщення» ввімкнено одразу. Бот один раз пише в групу номер замовлення, товари з кількістю, суму, доставку, оплату, ім'я, телефон, e-mail і Telegram покупця.
Так приходять лише замовлення з бота й магазину в Telegram. Текст іде мовою магазину, хай якою мовою користується покупець. Перемикач увімкнено, а Chat ID не задано — праворуч на екрані буде «Сповіщення менеджерам увімкнено, але не вказано Chat ID групи».
Питання покупців
Покупець натискає в боті «💬 Підтримка» або /support і пише питання — бот пересилає його в групу. Будь-який текст боту, що не є командою чи кнопкою, теж іде в групу.
Щоб відповісти, менеджер натискає «Відповісти» на пересланому повідомленні. Бот надішле відповідь покупцю. Просто повідомлення в групу покупець не отримає.
«Текст автовідповіді (по мовах)» — що бот пише на /support, наприклад «Напишіть модель телефона — підкажемо, що підійде». Порожнє поле — стандартний текст.
Як приймати оплату в чаті
Блок «Оплата в Telegram» додає в кошик бота кнопку «💳 Оплатити в Telegram»: покупець платить у вікні Telegram, не виходячи з чату. Без токена провайдера в кошику лише «🌐 Оплатити на сайті»; виняток — оплата зірками.
| Поле | Що робить | Типово |
|---|---|---|
| Токен платіжного провайдера | Видає @BotFather: /mybots → ваш бот → Payments. Для робочих і тестових платежів токени різні. Для зірок Telegram не потрібен | порожньо |
| Валюта оплати | UAH, USD, EUR або «Зірки Telegram». Сума перераховується з основної валюти магазину за курсом | UAH |
| Статус замовлення після оплати | Статус, який отримає оплачене замовлення | «В обробці» |
| Запитувати адресу доставки | Покупець вводить адресу й обирає доставку у вікні оплати; ціна доставки додається до рахунку. Лише коли в кошику є товар із доставкою | вимкнено |
| Запитувати номер телефону, Запитувати email | Telegram попросить заповнити ці поля у вікні оплати | вимкнено |
Обраної валюти немає серед валют магазину — бот не надсилає рахунок і пропонує оплатити на сайті. Валюти й курси задають у вікні «Валюти та курси». Для зірок там потрібна валюта XTR; сума рахунку в зірках — ціле число, а адресу, телефон і e-mail Telegram не запитує.
У вікні оплати Telegram є лише адреса, без відділень і поштоматів. Доставку у відділення покупець обирає через «Оплатити на сайті».
Як змінити тексти бота
Блок «Тексти бота» згорнутий: розгорніть його. Там 58 рядків — привітання, кнопки меню, каталог, кошик, замовлення. Сірим у полі видно стандартний текст.
- Впишіть свій текст для потрібної мови. Порожнє поле — бот пише стандартний текст.
- Службові позначки зі знаком % не видаляйте: туди бот підставляє назву товару, ціну, номер замовлення.
- У кнопках «Кошик», «Замовлення», «Підтримка» лишіть значок першим — 🛒, 📦, 💬. Бот розпізнає ці кнопки за значком.
Хто користується ботом
Блок «Користувачі бота» — усі, хто писав боту чи відкривав магазин у Telegram, нові зверху. Список читається з магазину щоразу, коли ви відкриваєте екран; кнопка «Оновити» — перечитати.
1
Пошук2
Фільтр сповіщень3
Фільтр кабінету4
Олена Коваль у колонці «Кабінет»5
Сповіщення вимкнені6
Видалити- Пошук за ім'ям, @username або Telegram ID.
- Хто отримує сповіщення й розсилки.
- Хто пов'язаний з кабінетом у магазині.
- Покупець магазину, з яким пов'язаний Telegram.
- Людина вимкнула сповіщення або заблокувала бота.
- Видалити запис людини, листування з підтримкою і кабінет, створений ботом; замовлення лишаються.
| Колонка | Що показує |
|---|---|
| Імʼя / @username | Ім'я з Telegram; під ним @username або Telegram ID |
| Кабінет | Покупець магазину, з яким пов'язаний Telegram. Якщо клієнт є в Elbuz, ім'я — посилання на його картку. «не повʼязаний» — кабінету немає |
| Сповіщення | «увімкнені» — людина отримує сповіщення й розсилки; «вимкнені» — вимкнула їх у /settings або заблокувала бота |
| З нами з | Дата першого звернення до бота |
Пошук — за ім'ям, @username або початком Telegram ID. Відбір: «Сповіщення увімкнені» чи «Вимкнені», «З кабінетом» чи «Без кабінету», період першого звернення. На екрані — по 100 людей, далі «Показати ще».
Вимкнути сповіщення за людину не можна: це її вибір у боті.
Видалити дані людини
Значок кошика в рядку → «Видалити».
Видаляються запис людини в боті, листування з підтримкою і кабінет, який створив бот. Замовлення лишаються, але без імені й контактів. Напише боту знову — отримає новий порожній кабінет.
Якщо людина сама прив'язала бота до свого кабінету на сайті, цей кабінет не видаляється. Його дані видаляють у картці клієнта кнопкою «Видалити дані на сайті».
Видалення не скасувати: листування з підтримкою зникне назавжди.
Як зробити розсилку в Telegram
Розсилка йде всім, у кого сповіщення ввімкнені. Скільки людей її отримає, видно вгорі блоку «Розсилки»: «Отримають: N».
- Текст. Можна
<b>жирний</b>,<i>курсив</i>і<a href="https://…">посилання</a>. До 4096 знаків, з картинкою — до 1024, теги не рахуються. - Картинка — адреса
https://…або кнопка бібліотеки поруч з полем. Необов'язково. - Кнопка під повідомленням — «Кнопка: текст» і «Кнопка: адреса». Необов'язково, але якщо кнопка є — потрібні обидва поля.
- Тест. У «Тест: Telegram ID чи ID групи» — ваш Telegram ID або Chat ID групи менеджерів. Натисніть «Надіслати тест» і подивіться повідомлення в Telegram.
- Надіслати всім (N) → підтвердьте.
1
Текст2
Надіслати тест3
Надіслати всім (6)4
Надіслано- Підтримуються жирний, курсив і посилання; з картинкою — до 1024 знаків.
- Спершу надішліть повідомлення собі чи в групу менеджерів.
- Почату розсилку зупинити не можна.
- Доставлено, помилки й скільки людей заблокували бота.
Тест не потрапляє в журнал. Щоб він дійшов, спершу самі напишіть боту /start, а для групи — додайте в неї бота. Якщо в профілі Elbuz вказано ваш Telegram ID для сповіщень, поле тесту заповниться ним саме.
Почату розсилку зупинити не можна. Спершу завжди надсилайте тест.
Ту саму розсилку — той самий текст, картинку й кнопку — вдруге протягом 10 хвилин магазин не прийме. Випадкове повторне натискання не напише всім двічі.
Як іде розсилка
Магазин надсилає розсилку сам, порціями щохвилини: 1000 людей отримають її за кілька хвилин. Elbuz можна закрити, а бот має лишатися ввімкненим: вимкнений бот розсилок не надсилає.
Хід видно в «Журнал розсилок»: скільки оброблено з усіх, доставлено, помилок і скільки людей заблокували бота. Поки стан «Надсилається», журнал оновлюється сам.
Хто заблокував бота, отримує позначку «вимкнені» і наступних розсилок не отримує. «Помилки» — повідомлення, які Telegram не прийняв з інших причин.
Сценарії
Побутова техніка: статус доставки без дзвінків
Увімкніть «Увімкнути сповіщення». Для статусу «Відправлено» впишіть: Замовлення #{order_id} передано в доставку. Перевізник зателефонує за годину до приїзду.
Покупець, який замовляв через бота, отримує повідомлення, щойно менеджер змінить статус.
Одяг: менеджер бачить замовлення й питання про розмір
Створіть групу «Менеджери», додайте бота, впишіть Chat ID у блок «Підтримка». В автовідповідь: «Напишіть зріст і звичний розмір — підкажемо».
Нові замовлення з Telegram і питання покупців приходять в одну групу. Менеджер відповідає через «Відповісти».
Розпродаж: розсилка з кнопкою
Текст <b>Мінус 25% на пральні машини 2025 року</b>, фото моделі з бібліотеки, кнопка «Дивитися моделі» з адресою категорії. Тест собі, потім «Надіслати всім».
Підписники бачать фото й кнопку в чаті з ботом. Підсумок — у журналі розсилок.
Покупець просить видалити його дані
У «Користувачі бота» знайдіть людину за @username і видаліть. Замовлення залишаться для обліку.
Що робити, коли бот не працює
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
Бот мовчить на /start |
Модуль вимкнено, немає токена, ще не минуло 5 хвилин після збереження або сайт не на https:// |
Перевірте «Увімкнено» і токен, збережіть, зачекайте кілька хвилин. Не допомогло — служба підтримки Elbuz перевірить зв'язок бота з сайтом |
| «Telegram не прийняв повідомлення: …» | Ви не писали боту /start, бота немає в групі або ID неправильний |
Напишіть боту /start або додайте його в групу, перевірте ID і надішліть тест ще раз |
| «У боті не задано токен — задайте його в блоці «Бот» і збережіть.» | Токен не збережено | Вставте токен з @BotFather у блок «Бот» і натисніть «Зберегти» |
| Кнопка «Надіслати всім (0)» не натискається | Боту ще ніхто не писав або всі вимкнули сповіщення | Дайте покупцям посилання на бота: розсилка запрацює, щойно хтось напише /start |
| «Таку саму розсилку щойно вже створено…» | Ту саму розсилку вже запущено менш ніж 10 хвилин тому | Перевірте журнал розсилок — вона вже йде |
| Покупець не отримав сповіщення про статус | Бот чи сповіщення вимкнені, для статусу немає тексту або покупець купував не через Telegram | Перевірте «Увімкнено», «Увімкнути сповіщення», текст статусу і колонку «Сповіщення» в «Користувачі бота» |
| «Модуль Telegram у магазині не встановлено або застарів.» | У магазині стара версія модуля | Напишіть службі підтримки Elbuz — модуль оновлять |
Часті запитання
Чи можна надіслати розсилку лише частині підписників?
Ні, розсилка йде всім, у кого ввімкнені сповіщення. Відбір у «Користувачі бота» лише показує людей, на розсилку він не впливає.
Чи можна підключити двох ботів до одного магазину?
Ні, токен один. Новий токен замінить старий, і магазин за кілька хвилин переключиться на новий бот.
Це той самий бот, що надсилає мені сповіщення Elbuz?
Ні. Бот магазину пише покупцям. Сповіщення співробітникам про події Elbuz надсилає інший бот — див. «Сповіщення про події».
Чи бачить покупець, хто з менеджерів йому відповів?
Ні. Відповідь приходить від імені бота магазину, особисті акаунти менеджерів покупець не бачить.
Де взяти свій Telegram ID для тесту?
Його показують боти на кшталт @userinfobot. Напишіть такому боту — він відповість вашим ID.
Де це і хто має доступ
- Меню
- Довідники → Операції → Налаштування магазину → «Інтеграції» → «Telegram-магазин»
- Право доступу
- вікно «Налаштування магазину» в «Правах груп»
- Підготувати
- бот і токен з @BotFather, сайт на
https://, група менеджерів у Telegram
Суміжні теми
- Якщо треба знати, що бачить покупець у боті — Магазин у Telegram.
- Якщо треба зрозуміти, як працює вікно налаштувань — Налаштування магазину.
- Якщо замовлення з Telegram уже прийшло — Обробка замовлень покупця.
- Якщо листування з клієнтами в Telegram треба вести у зверненнях Elbuz — Боти підтримки.
