Найдорожчий крок у будь-якій мобільній воронці — це встановлення. Людина має піти в стор, дочекатися завантаження, віддати місце в пам'яті й зареєструватися. Більшість не йде. Telegram Mini App прибирає цей крок цілком: клієнт тисне кнопку в чаті й одразу опиняється у вашому каталозі.
Про назву, бо тут плутанина. Telegram Mini App, Telegram Web App і «міні-додаток у телеграмі» — одне й те саме. В офіційній документації це Mini App, а Web App лишилося з ранніх версій API і досі гуляє старими статтями.
Що таке Telegram Mini App
Telegram Mini App — це веб-сторінка, яку Telegram відкриває у власному вікні поверх чату. Технічно нічого екзотичного: звичайний фронтенд на HTML, CSS і JavaScript, який лежить на вашому сервері. Telegram його просто показує й дає доступ до свого JavaScript API: хто зайшов, яка в нього тема оформлення, кнопки, оплата, камера, геолокація.
Для клієнта це виглядає так. Тиснеш кнопку в боті, і за секунду перед тобою застосунок: картинки, фільтри, кошик, кнопка оплати. Нічого не качається зі стора, не з'їдає пам'ять і не просить дозволів.
Для бізнесу тут два справжні виграші. Перший ми вже назвали: бар'єра встановлення немає. Другий важливіший, ніж здається, — клієнт уже авторизований. Ви знаєте, хто він, ще до того, як він щось натиснув, і не проганяєте його через реєстрацію, на якій відвалюється половина. Плюс масштаб: понад мільярд активних користувачів на місяць за заявою Павла Дурова від березня 2025 року, з них близько 500 мільйонів заходять щодня.
Mini App чи бот: у чому різниця
Бот говорить повідомленнями. Mini App показує екран. Бот веде діалог по черзі: питання, відповідь, наступне питання. Mini App викладає все одразу, як звичайна сторінка: двадцять товарів у списку, фільтри, повзунок ціни, кошик, що перераховується на льоту.
Правило вибору просте, і воно зводиться до довжини сценарію. Менше семи кроків, немає вибору з довгого списку — беріть бота. Заявка на дзвінок, запис на послугу, статус замовлення, розсилка: усе це бот робить краще, бо не треба вантажити окремий інтерфейс заради трьох питань.
Mini App починається там, де клієнту треба щось порівняти або налаштувати. Каталог на сотню позицій. Калькулятор, де на ціну впливає п'ять параметрів. Кабінет з історією замовлень. Бронювання, де людина має бачити календар цілком, а не тикати в десять кнопок із датами.
| Telegram-бот | Telegram Mini App | |
|---|---|---|
| Інтерфейс | повідомлення й кнопки | повноцінна сторінка |
| Каталог на 100+ позицій | болісно | природно |
| Фільтри, повзунки, карта | немає | є |
| Складний розрахунок ціни | по одному питанню | усе на одному екрані |
| Розсилки й нагадування | так | лише через бота |
| Строк розробки | 5–7 днів | 2–3 тижні |
Тільки на практиці це не «або-або». Майже кожен робочий Mini App живе в парі з ботом: Mini App приймає замовлення, бот шле підтвердження, нагадування й статуси. Причина проста. Mini App не вміє написати клієнту першим. Взагалі ніколи. Це вміє тільки бот.
Mini App, сайт і мобільний додаток
| Сайт | Мобільний додаток | Mini App | |
|---|---|---|---|
| Встановлення | не треба | App Store / Google Play | не треба |
| Хто клієнт | невідомо | після реєстрації | відомо одразу |
| Комісія сторів | — | 15–30% | — |
| Push-нагадування | слабкі | є | через бота |
| Строк запуску | від 2 тижнів | від 2–3 місяців | від 2 тижнів |
| Оновлення | миттєве | через модерацію стора | миттєве |
Сайт Mini App не замінює. Сайт ловить пошуковий трафік, Mini App не ловить нічого: Google його не індексує. Зате він робить те, чого сайт не вміє, — впізнає людину без жодної реєстрації й живе там, де вона вже сидить увесь день.
Що Telegram Mini App уміє у 2026 році
Ще у 2023-му це справді була «сторінка у віконці», і скепсис щодо Mini Apps був заслужений. Зламало його оновлення Bot API 8.0 від листопада 2024 року, яке Telegram сам назвав найбільшим в історії Mini Apps. Ось що є станом на Bot API 10.1 (червень 2026).
Mini App розгортається на весь екран через requestFullscreen(), вміє альбомну орієнтацію й уміє її заблокувати. Вміє покласти собі іконку на робочий стіл телефона: addToHomeScreen(), і далі клієнт запускає вас як звичайний застосунок, тільки без стора й без встановлення. Вміє пускати за відбитком чи обличчям, тримаючи токен в iOS Keychain та Android Keystore.
Дані можна складати на боці Telegram: CloudStorage бере до 1024 записів на користувача й синхронізує їх між його пристроями, DeviceStorage дає 5 МБ локально, SecureStorage — 10 зашифрованих значень. Оплата живе всередині: Telegram Stars для цифрових товарів і підписок, зовнішні провайдери з Google Pay та Apple Pay для звичайних покупок. З дрібніших, але корисних речей — геолокація з точністю, акселерометр, гіроскоп, орієнтація пристрою, сканер QR, читання буфера обміну й тактильний відгук.
Половина цього списку вам не знадобиться ніколи. По-справжньому на гроші впливають три штуки. Іконка на робочому столі перетворює разового клієнта на постійного. Оплата всередині не дає воронці порватися на переході до стороннього платіжного вікна. А CloudStorage рятує кошик, коли людина почала збирати замовлення в метро з телефона, а доклала з ноутбука ввечері.
Як це виглядає в бою: три наші проєкти
ЗУБР ТАКСІ — калькулятор переїзду на шість кроків
Вантажне таксі в Києві. Задача була не «зробити красиво», а прибрати диспетчера з першого дотику. Людина, яка переїжджає, хоче знати одне: скільки це коштуватиме. І хоче знати це до дзвінка, а не після десяти хвилин уточнень у слухавку.
Mini App веде її шістьма екранами: послуга, обсяг, авто й тариф, маршрут, контакти, підтвердження. Обсяг задається готовими пресетами на кшталт «2 кімнати — 14 м³», і під нього система сама підсвічує авто, у яке все влізе. Внизу весь час висить підсумок і перераховується миттєво, тож до кроку з контактами людина вже бачить свої 4 100 ₴ разом із поверхами, ліфтом, кілометрами за містом і кількістю вантажників.
Усередині PHP 8.3 і SQLite з нульовими залежностями. Жодного фреймворку, жодного npm. Це не аскеза заради аскези: усі ціни, авто й тарифи лежать в одному файлі catalog.json, тож підняти вартість кілометра можна без програміста й без деплою логіки. Бот на тому самому коді веде заявку від «нової» до «виконаної» й тримає диспетчерську для адміна.
Samokrutka — тютюновий магазин із доставкою Новою поштою
Інший тип задачі: не калькулятор, а магазин. Каталог, набори, фільтри за наявністю, повзунок ціни, пошук, темна й світла теми. Картка товару відкривається в тому ж вікні, без переходів, із кнопкою, що прилипла до низу екрана.
Найцікавіше тут — кошик. Промокод, прогрес до безкоштовної доставки, вибір оплати і, головне, вибір міста та відділення Нової пошти просто в Mini App. Замовлення оформлюється до кінця, жодного разу не покинувши Telegram, — а це саме той крок, на якому магазини зазвичай віддають клієнта сторонньому сайту й втрачають частину замовлень.
Wokbanda — доставка суші в двох містах
Третій випадок цікавий тим, чого в ньому робити не довелося. У клієнта вже був магазин, який віддавав товари через відкритий Store API: назви, описи, ціни, знижки, фото. Каталог не заводили руками взагалі, він тягнеться з магазину й оновлюється разом із ним. Це найдешевший зі сценаріїв, і саме про нього йдеться нижче в розділі про ціну.
Далі почалася конкретика ніші. Одеса й Миколаїв, у кожного міста свої зони доставки, і межі цих зон намальовані не в коді, а в Google My Maps: клієнту так зручно правити їх самому. Mini App тягне карти зон і рахує доставку за тим, у яку зону впала адреса.
Інші наші роботи — у кейсах.
Чотири пастки, на яких ламаються Mini App
Це те, чого не пишуть у рекламних статтях. Саме через ці чотири речі проєкти потім переробляють, і саме їх варто спитати в розробника до того, як платити.
initData перевіряє сервер, а не сторінка
Mini App отримує initData, рядок із даними користувача. Підробити його можна за хвилину, тому довіряти йому на фронтенді не можна взагалі. Сервер мусить перерахувати HMAC-SHA-256 підпис ключем, похідним від токена бота, і перевірити auth_date, щоб старий запит не переграли. Розробник, який цього не зробив, віддав вам магазин, де будь-хто оформить замовлення від чужого імені.
Telegram WebApp API бреше поза Telegram
Ось на цьому ми свого часу й напоролись. Об'єкт window.Telegram.WebApp існує в будь-якому браузері, і там чесно працюють і MainButton, і requestContact. Тобто перевірка «чи ми всередині Telegram» за наявністю цього об'єкта не перевіряє нічого: у звичайному Chrome вона так само скаже «так». Єдина надійна ознака справжнього клієнта — непорожній initData. Тепер дивимося тільки на нього.
Ціну рахує сервер
Якщо підсумок формується лише в JavaScript, його перепишуть у консолі за п'ять секунд. У ЗУБРі калькулятор живе у двох дзеркальних копіях: одна на фронті, щоб цифра мінялася миттєво, друга на сервері. Заявка приймається тільки за серверною, і якщо вони розійшлися, виграє сервер.
Тема й безпечні зони
Telegram віддає свою палітру й може перемкнутися на темну посеред сесії, а на iPhone частину екрана з'їдають вирізи. Mini App, який не читає themeParams і safeAreaInset, у половині випадків виглядає чужим у власному месенджері. Дрібниця, яку помічає кожен клієнт і не помічає жоден тестувальник на одному телефоні.
Як створити Telegram Mini App: три шляхи
Шляхів три, і різниця між ними не в ціні. Різниця в тому, кому належить результат.
Конструктор дасть готовий каталог за вечір і без рядка коду. Як спосіб перевірити гіпотезу, чи будуть замовлення взагалі, це чесний варіант. Проблеми починаються рівно тоді, коли замовлення пішли. Дані лежать у сервісу, логіка розрахунку його, дизайн упирається в шаблон, щомісячна плата йде завжди, а забрати свій магазин зі своїм кодом і перенести на власний сервер не вийде ніколи. Це оренда, не актив.
Писати самому теж реально. Mini App — звичайний фронтенд, тож підійде що завгодно: React і Next.js, Vue, Svelte або чистий JavaScript. Telegram чіпляється одним скриптом telegram-web-app.js, далі ви працюєте з об'єктом window.Telegram.WebApp. Бекенд теж будь-який, від Node.js до Go. Тільки складність не у фронтенді. Вона в перевірці initData, серверному перерахунку цін і оплаті — тобто рівно в тих трьох місцях, про які ми щойно писали вище. На них перші самостійні спроби й лягають.
Розробка під ключ виправдана тоді, коли Mini App для вас канал продажів, а не експеримент: свої правила розрахунку, інтеграція з обліковкою чи CRM, оплата й адмінка, з якою працюватиме менеджер, а не програміст.
Окремо про «без програмування». Зібрати Mini App без бекенду технічно можна, якщо він нічого не зберігає. Калькулятор, який порахував і віддав підсумок у чат, обійдеться без сервера. Але щойно з'являються замовлення, кошик або залишки, сервер потрібен: дані нема де тримати й нема кому перевіряти.
І порада, яку ми даємо майже кожному: не починайте з каталогу. Почніть з одного екрана, що закриває найдорожче питання клієнта — «скільки це коштує». У ЗУБРі цей екран так і лишився всім Mini App. Магазин там не знадобився взагалі.
Скільки коштує Telegram Mini App
Ціну визначає не кількість екранів, а те, скільки логіки й інтеграцій під ними. Наші орієнтири:
| Формат | Ціна | Строк |
|---|---|---|
| Telegram-бот під заявки | від $180 | 5–7 днів |
| Telegram Mini App | від $490 | 2–3 тижні |
| Магазин у Telegram (каталог, кошик, оплата, CRM) | від $720 | 3–4 тижні |
У Mini App за $490 входить кастомний інтерфейс усередині Telegram, каталог або форми, особистий кабінет, бекенд зі зберіганням даних, оплата всередині Telegram, адаптив і аналітика.
Дорожчає проєкт зазвичай від інтеграції з чужою обліковою системою чи CRM, від нестандартної оплати й від складного розрахунку на кшталт зон доставки чи погодинних тарифів. Дешевшає від однієї речі: коли каталог уже існує в машиночитному вигляді й його можна тягнути, а не заводити руками. У Wokbanda саме так і вийшло, бо магазин віддавав товари через відкритий Store API.
Точні цифри рахуємо після брифу й віддаємо за 24 години безкоштовно. Пакети й деталі — на сторінці розробки Telegram-ботів.
Коли Mini App вам не потрібен
Чесний список, щоб ви не витратили $490 дарма.
Сценарій на три кроки інтерфейсу не потребує. «Ім'я, телефон, заявка» чудово живе в боті: п'ять днів і втричі дешевше.
Вам потрібен пошуковий трафік. Mini App не індексується взагалі, тож коли мета — щоб вас знаходили в Google, починати треба з сайту. Mini App хіба що додатком до нього.
Ваша аудиторія не в Telegram. Якщо клієнти пишуть у Viber або просто дзвонять, перевіряйте гіпотезу лендінгом зі зв'язкою бот плюс таблиця, а не повноцінною розробкою.
Каталог замкнений в обліковці, і ніхто не готовий його віддавати. Магазин без живих залишків і цін зламається на другому тижні. Спершу доступ до даних, потім уже інтерфейс.
Кілька тисяч SKU з фасетним пошуком. Це вже повноцінна платформа, і Mini App тут буде милицею.
З чого почати
Порядок, який економить гроші:
- Випишіть сценарій клієнта по кроках, від «побачив кнопку» до «оплатив». Менше семи кроків — вам потрібен бот, не Mini App.
- Знайдіть у цьому сценарії місце, де клієнт порівнює або налаштовує. Саме воно й виправдовує окремий інтерфейс.
- Перевірте, звідки братимуться дані. Ціни, залишки, статуси мають лежати там, звідки їх можна прочитати автоматично.
- Розподіліть ролі. Усе, що треба надіслати клієнту першим, робить бот. Усе, що треба показати, робить Mini App.
- Плануйте пару, а не одну штуку. Mini App без бота — застосунок, який не вміє нагадати про себе.
Опишіть задачу в кількох реченнях, і ми скажемо, чи потрібен вам Mini App узагалі. Прорахунок готуємо за 24 години. Написати нам.