↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Інтернет-магазин Elbuz CMS
    4. Модулі магазину
    5. Інтеграції

    Як налаштувати Telegram-бот магазину

    10 хв читанняОновлено

    Телеграм бот магазину Elbuz CMS сам пише покупцям про статус замовлення, пересилає їхні питання менеджерам і надсилає розсилки підписникам. Бот підключається одним токеном з @BotFather у налаштуваннях магазину в Elbuz.

    Коли це знадобиться:

    • Покупці дзвонять дізнатися, де замовлення — бот пише їм, щойно змінюється статус.
    • Нове замовлення з Telegram треба побачити одразу — бот надсилає його в групу менеджерів.
    • Треба розповісти про акцію — розсилка з картинкою й кнопкою приходить усім підписникам бота.
    • Покупець просить видалити його дані — одна кнопка прибирає його запис у боті разом із листуванням.

    З чого почати: «Налаштування магазину» → «Інтеграції» → картка «Telegram-магазин» і токен бота.

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

    Що бачить покупець у самому боті — каталог, кошик, команди, магазин як Mini App — у статті «Магазин у Telegram».

    Як підключити бота

    Потрібні бот у Telegram і сайт на захищеній адресі https://: на інші адреси Telegram повідомлення боту не надсилає.

    1. Створіть бота. У Telegram відкрийте @BotFather, надішліть /newbot, задайте назву й адресу бота латиницею із закінченням bot, наприклад technodim_shop_bot.
    2. Скопіюйте токен з відповіді BotFather. Він має вигляд 123456789:AAE….
    3. Відкрийте екран модуля: «Налаштування магазину» → розділ «Інтеграції» → картка «Telegram-магазин».
    4. У блоці «Бот» вставте «Токен бота», а в «Ім’я користувача бота (username)» — адресу бота без @.
    5. Увімкніть перемикач «Увімкнено» вгорі екрана і натисніть «Зберегти».
    Розділ «Інтеграції» у налаштуваннях магазину з карточкою «Telegram-магазин»
    1Картка «Telegram-магазин»
    2Позначка стану
    1. Відкриває налаштування бота магазину.
    2. Чи ввімкнено бота і чи дійшли останні зміни до магазину.
    Блок «Бот» у вікні «Telegram-магазин»: токен, імʼя бота, адреса міні-застосунку та картка «Стан у магазині»
    1Ім’я користувача бота (username)
    2Адреса міні-застосунку (Mini App)
    3Стан у магазині
    1. Адреса бота без @.
    2. Адреса сайту для налаштування Mini App у BotFather.
    3. Чи дійшли зміни до магазину, бот і оплата.

    Протягом 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. Натисніть «Зберегти».
    Блок «Сповіщення» з шаблонами повідомлень за статусами замовлення
    1Увімкнути сповіщення
    2Нові замовлення — менеджерам
    3Текст для статусу «Відправлено»
    4Статус без тексту
    1. Покупці отримують повідомлення про зміну статусу замовлення.
    2. Нові замовлення з Telegram надходять у групу менеджерів.
    3. Текст повідомлення; змінні підставляються з замовлення.
    4. Порожній рядок: для цього статусу повідомлення не надсилається.

    У «Шаблонах сповіщень» — рядок на кожен статус замовлення магазину. Для статусів «Очікує», «В обробці», «Відправлено», «Виконано» і «Скасовано» тексти вже вписано. Про статус без тексту бот не пише.

    У текст підставляються дані замовлення: {order_id} — номер, {customer_name} — ім'я покупця, {order_total} — сума, {order_status} — назва статусу, {store_name} — назва магазину. Приклад: Замовлення #{order_id} відправлено! Сума: {order_total}.

    Хто отримає повідомлення

    • Покупець, чий кабінет у магазині пов'язаний з Telegram: замовляв через бота чи магазин у Telegram або прив'язав бота до кабінету.
    • Лише якщо він не вимкнув сповіщення командою /settings у боті.
    • Мовою, обраною в боті, інакше мовою його Telegram, якщо така є в магазині; немає — мовою магазину. Для мови без тексту бот бере англійський текст, потім текст мови магазину.

    Повідомлення йде, коли змінюється статус замовлення в магазині. Покупцям, які купували лише на сайті без Telegram, бот написати не може.

    Як отримувати замовлення й питання в групу менеджерів

    Бот пише в одну групу Telegram: нові замовлення і питання покупців.

    1. Створіть у Telegram групу менеджерів і додайте в неї бота.
    2. Дізнайтеся Chat ID групи — від'ємне число, що починається з -100, наприклад -1001234567890.
    3. У блоці «Підтримка» впишіть його в «Ідентифікатор групи менеджерів (Chat ID)» разом із мінусом і збережіть.

    Нові замовлення

    Перемикач «Нові замовлення — менеджерам» у блоці «Сповіщення» ввімкнено одразу. Бот один раз пише в групу номер замовлення, товари з кількістю, суму, доставку, оплату, ім'я, телефон, e-mail і Telegram покупця.

    Так приходять лише замовлення з бота й магазину в Telegram. Текст іде мовою магазину, хай якою мовою користується покупець. Перемикач увімкнено, а Chat ID не задано — праворуч на екрані буде «Сповіщення менеджерам увімкнено, але не вказано Chat ID групи».

    Питання покупців

    Покупець натискає в боті «💬 Підтримка» або /support і пише питання — бот пересилає його в групу. Будь-який текст боту, що не є командою чи кнопкою, теж іде в групу.

    Щоб відповісти, менеджер натискає «Відповісти» на пересланому повідомленні. Бот надішле відповідь покупцю. Просто повідомлення в групу покупець не отримає.

    «Текст автовідповіді (по мовах)» — що бот пише на /support, наприклад «Напишіть модель телефона — підкажемо, що підійде». Порожнє поле — стандартний текст.

    Як приймати оплату в чаті

    Блок «Оплата в Telegram» додає в кошик бота кнопку «💳 Оплатити в Telegram»: покупець платить у вікні Telegram, не виходячи з чату. Без токена провайдера в кошику лише «🌐 Оплатити на сайті»; виняток — оплата зірками.

    ПолеЩо робитьТипово
    Токен платіжного провайдераВидає @BotFather: /mybots → ваш бот → Payments. Для робочих і тестових платежів токени різні. Для зірок Telegram не потрібенпорожньо
    Валюта оплатиUAH, USD, EUR або «Зірки Telegram». Сума перераховується з основної валюти магазину за курсомUAH
    Статус замовлення після оплатиСтатус, який отримає оплачене замовлення«В обробці»
    Запитувати адресу доставкиПокупець вводить адресу й обирає доставку у вікні оплати; ціна доставки додається до рахунку. Лише коли в кошику є товар із доставкоювимкнено
    Запитувати номер телефону, Запитувати emailTelegram попросить заповнити ці поля у вікні оплативимкнено

    Обраної валюти немає серед валют магазину — бот не надсилає рахунок і пропонує оплатити на сайті. Валюти й курси задають у вікні «Валюти та курси». Для зірок там потрібна валюта XTR; сума рахунку в зірках — ціле число, а адресу, телефон і e-mail Telegram не запитує.

    У вікні оплати Telegram є лише адреса, без відділень і поштоматів. Доставку у відділення покупець обирає через «Оплатити на сайті».

    Як змінити тексти бота

    Блок «Тексти бота» згорнутий: розгорніть його. Там 58 рядків — привітання, кнопки меню, каталог, кошик, замовлення. Сірим у полі видно стандартний текст.

    • Впишіть свій текст для потрібної мови. Порожнє поле — бот пише стандартний текст.
    • Службові позначки зі знаком % не видаляйте: туди бот підставляє назву товару, ціну, номер замовлення.
    • У кнопках «Кошик», «Замовлення», «Підтримка» лишіть значок першим — 🛒, 📦, 💬. Бот розпізнає ці кнопки за значком.

    Хто користується ботом

    Блок «Користувачі бота» — усі, хто писав боту чи відкривав магазин у Telegram, нові зверху. Список читається з магазину щоразу, коли ви відкриваєте екран; кнопка «Оновити» — перечитати.

    Блок «Користувачі бота» зі списком, пошуком і фільтрами
    1Пошук
    2Фільтр сповіщень
    3Фільтр кабінету
    4Олена Коваль у колонці «Кабінет»
    5Сповіщення вимкнені
    6Видалити
    1. Пошук за ім'ям, @username або Telegram ID.
    2. Хто отримує сповіщення й розсилки.
    3. Хто пов'язаний з кабінетом у магазині.
    4. Покупець магазину, з яким пов'язаний Telegram.
    5. Людина вимкнула сповіщення або заблокувала бота.
    6. Видалити запис людини, листування з підтримкою і кабінет, створений ботом; замовлення лишаються.
    КолонкаЩо показує
    Імʼя / @usernameІм'я з Telegram; під ним @username або Telegram ID
    КабінетПокупець магазину, з яким пов'язаний Telegram. Якщо клієнт є в Elbuz, ім'я — посилання на його картку. «не повʼязаний» — кабінету немає
    Сповіщення«увімкнені» — людина отримує сповіщення й розсилки; «вимкнені» — вимкнула їх у /settings або заблокувала бота
    З нами зДата першого звернення до бота

    Пошук — за ім'ям, @username або початком Telegram ID. Відбір: «Сповіщення увімкнені» чи «Вимкнені», «З кабінетом» чи «Без кабінету», період першого звернення. На екрані — по 100 людей, далі «Показати ще».

    Вимкнути сповіщення за людину не можна: це її вибір у боті.

    Видалити дані людини

    Значок кошика в рядку → «Видалити».

    Видаляються запис людини в боті, листування з підтримкою і кабінет, який створив бот. Замовлення лишаються, але без імені й контактів. Напише боту знову — отримає новий порожній кабінет.

    Якщо людина сама прив'язала бота до свого кабінету на сайті, цей кабінет не видаляється. Його дані видаляють у картці клієнта кнопкою «Видалити дані на сайті».

    Видалення не скасувати: листування з підтримкою зникне назавжди.

    Як зробити розсилку в Telegram

    Розсилка йде всім, у кого сповіщення ввімкнені. Скільки людей її отримає, видно вгорі блоку «Розсилки»: «Отримають: N».

    1. Текст. Можна <b>жирний</b>, <i>курсив</i> і <a href="https://…">посилання</a>. До 4096 знаків, з картинкою — до 1024, теги не рахуються.
    2. Картинка — адреса https://… або кнопка бібліотеки поруч з полем. Необов'язково.
    3. Кнопка під повідомленням — «Кнопка: текст» і «Кнопка: адреса». Необов'язково, але якщо кнопка є — потрібні обидва поля.
    4. Тест. У «Тест: Telegram ID чи ID групи» — ваш Telegram ID або Chat ID групи менеджерів. Натисніть «Надіслати тест» і подивіться повідомлення в Telegram.
    5. Надіслати всім (N) → підтвердьте.
    Блок «Розсилки» з формою нової розсилки та журналом
    1Текст
    2Надіслати тест
    3Надіслати всім (6)
    4Надіслано
    1. Підтримуються жирний, курсив і посилання; з картинкою — до 1024 знаків.
    2. Спершу надішліть повідомлення собі чи в групу менеджерів.
    3. Почату розсилку зупинити не можна.
    4. Доставлено, помилки й скільки людей заблокували бота.

    Тест не потрапляє в журнал. Щоб він дійшов, спершу самі напишіть боту /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

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно