Простий Telegram Mini App - це вебсторінка, відкрита всередині месенджера. Таке можна зробити швидко. Але мені пишуть з іншими задачами: маркетплейс з продавцями і модерацією, сервіс бронювання з оплатою і календарем, гра з рейтингами і внутрішньою економікою, CRM для команди продажів, яка живе в Telegram, програма лояльності на десятки тисяч користувачів. Тут Mini App - лише інтерфейс, а основна робота відбувається на бекенді.
У статті розповідаю, з чого складається такий проєкт і де найчастіше помиляються. Про загальний підхід до Mini App я писав раніше: https://zavada.dev/ua/blog/how-i-build-telegram-mini-apps.
Авторизація, якій можна довіряти
Telegram передає застосунку initData - дані про користувача, підписані ключем бота. Найпоширеніша і найнебезпечніша помилка - довіряти цим даним на клієнті або брати user id з запиту без перевірки. Тоді будь-хто може видати себе за іншого користувача, отримати чужі бонуси чи доступ до адмінки.
Правильно так: кожен запит до API несе initData, сервер перевіряє підпис і строк дії, і лише після цього створює сесію. Ролі (клієнт, продавець, менеджер, адміністратор) зберігаються на сервері і перевіряються в кожному ендпоінті, а не приховуються кнопками в інтерфейсі.
Оплати всередині Telegram
| Спосіб | Коли підходить | На що зважати |
|---|---|---|
| Telegram Stars | Цифрові товари і послуги всередині застосунку | Для цифрових товарів це вимога правил платформ; повернення і бухгалтерія мають свої особливості |
| Платіжні провайдери через бота | Фізичні товари і послуги | Підтвердження оплати лише через серверний апдейт, не з клієнта |
| Зовнішній еквайринг | Складні сценарії: підписки, розщеплення платежів, B2B | Повернення користувача в застосунок і синхронізація статусу |
| Криптоплатежі | Ігри та міжнародна аудиторія | Підтвердження транзакцій, курси, вимоги комплаєнсу |
У будь-якому випадку статус оплати змінюється лише на сервері після підтвердження від провайдера, з ідемпотентністю і журналом. Детальніше про надійні платежі та інтеграції: https://zavada.dev/ua/blog/crm-erp-and-payment-integrations.
Бекенд, а не лише фронтенд
У складному Mini App більшість логіки живе на сервері: каталоги, замовлення, бронювання з перевіркою конфліктів, баланси і транзакції внутрішньої валюти, реферальні програми, антифрод. Зазвичай це Node.js або Python з PostgreSQL, Redis для кешу і черг, і окремий бот, який надсилає сповіщення, нагадування і статуси замовлень.
Бот і Mini App працюють разом: бот приводить користувача в потрібний екран через deep link, надсилає нагадування про неоплачене замовлення, повідомляє продавця про нову заявку. Розсилки на десятки тисяч користувачів ідуть через чергу з урахуванням лімітів Telegram, інакше бот отримає блокування.
Realtime і ігрова логіка
Чати між покупцем і продавцем, статуси замовлень у реальному часі, мультиплеєрні ігри і рейтинги потребують WebSocket або аналогічного каналу. В іграх критично, щоб результати рахував сервер, а не клієнт: інакше рейтинг і нагороди швидко зламають. Про ігри в Mini App окрема стаття: https://zavada.dev/ua/blog/online-games-in-telegram-mini-apps.
Адмінка, інтеграції і аналітика
Бізнесу потрібна не лише клієнтська частина. Адмін-панель для модерації, керування каталогом, замовленнями, користувачами і виплатами. Інтеграції з CRM, складом, обліком і доставкою. Аналітика воронки: скільки людей відкрили застосунок, дійшли до оплати, повернулися. Часто адмінка - це окремий вебзастосунок, а частина функцій для менеджерів доступна просто в Telegram.
Навантаження і піки
Mini App може отримати тисячі користувачів за годину після однієї розсилки або згадки у великому каналі. Тому з самого початку: статика через CDN, легкий перший екран, кешування, черги для важких операцій, обмеження частоти запитів, горизонтальне масштабування API і моніторинг помилок та затримок. Навантажувальне тестування перед великим запуском дешевше, ніж падіння в момент піку.
| Область | Що має бути |
|---|---|
| Безпека | Перевірка initData на сервері, ролі, rate limiting, захист від повторних запитів |
| Оплати | Серверне підтвердження, ідемпотентність, журнал транзакцій, повернення |
| Бекенд | PostgreSQL, черги, бот для сповіщень і deep links |
| UX | Тема Telegram, кнопки MainButton і BackButton, швидкий перший екран |
| Операції | Адмінка, логи, моніторинг, аналітика воронки |
| Масштаб | CDN, кеш, ліміти розсилок, навантажувальні тести |
Як проходить проєкт
1. Бриф і розбір сценаріїв: хто користувачі, які ролі, як заробляє продукт, з якими системами треба інтегруватися.
2. Архітектура і план етапів: що входить у першу версію, що далі.
3. Розробка з регулярними демо в тестовому боті.
4. Запуск, моніторинг під реальним трафіком і подальший розвиток.
Вартість залежить від кількості ролей, оплат, інтеграцій і вимог до навантаження, тому я називаю ціну після брифу, з письмовим обсягом робіт і етапами.
Висновок
Складний Telegram Mini App - це повноцінний продукт з бекендом, безпекою, платежами і операційною частиною, просто з інтерфейсом всередині месенджера. Якщо закласти це з першого дня, застосунок витримає і перші тисячі користувачів, і наступні сотні тисяч.
Якщо ви плануєте Mini App з оплатами, ролями, інтеграціями чи ігровою механікою, подивіться, як я працюю з такими проєктами: https://zavada.dev/ua/telegram-mini-apps. Опишіть ідею у формі заявки: https://zavada.dev/ua/contacts?service=telegram-mini-apps
Шукаєте розробника надовго?
Можу почати вже зараз і працювати з вами місяцями й роками, а не два тижні. Напишіть мені, обговоримо проєкт, вимоги й наступні кроки.