Что такое Telegram Mini App и как он работает
Короткий ответ
Mini App — это обычное веб-приложение, адаптированное для среды Telegram и связанное с ботом или другим способом запуска. Интерфейс работает на HTML, CSS и JavaScript, а важные операции выполняет backend. Telegram передаёт приложению контекст запуска и данные интерфейса, но сервер обязан самостоятельно проверить подписанные параметры, прежде чем считать пользователя авторизованным.
Из каких частей состоит решение
| Часть | Роль | Пример |
|---|---|---|
| Telegram | Открывает Mini App и передаёт контекст | Кнопка меню или ссылка |
| Frontend | Показывает экраны и собирает действия | Каталог, календарь, корзина |
| Backend | Проверяет пользователя и применяет правила | Создание заказа, расчёт, доступ |
| База данных | Хранит состояние, если оно необходимо | Заказы, роли, расписание |
| Интеграции | Обмениваются данными с системами бизнеса | CRM, склад, платёжный провайдер |
Как пользователь проходит путь
- Пользователь открывает бота, меню, прямую ссылку или другую поддерживаемую точку входа.
- Telegram показывает Mini App во встроенном окне и передаёт параметры запуска.
- Интерфейс загружает только необходимые данные и показывает первый полезный экран.
- Пользователь выбирает услугу, товар, дату или другое действие.
- Backend проверяет авторизацию и правила, затем создаёт заявку или заказ.
- Бот может прислать подтверждение, изменение статуса или напоминание.
Когда Mini App лучше простого диалога
Визуальный интерфейс оправдан, когда пользователю нужно сравнивать несколько объектов, видеть календарь, возвращаться к предыдущему шагу или управлять сущностью после заказа. Например, выбор одного из десятков товаров удобнее карточками и фильтрами, а запись — календарём со свободными слотами. Для короткой квалификации из трёх вопросов обычный бот часто быстрее и дешевле.
Какие способы запуска поддерживает Telegram
Официальная документация Telegram описывает несколько способов запуска Mini Apps: кнопки клавиатуры и меню, inline-режим, прямые ссылки, главный Mini App профиля бота и другие варианты. Способ выбирают не ради технической моды, а под контекст. Меню удобно для постоянного сервиса, прямая ссылка — для рекламы, а кнопка в сообщении — для продолжения конкретного сценария.
Безопасность: что нельзя доверять интерфейсу
Клиентский код выполняется на устройстве пользователя и может быть изменён. Поэтому цена, скидка, роль, право доступа и успешность оплаты не должны приниматься из браузера как истина. Telegram отдельно предупреждает: данные initDataUnsafe нельзя считать доказательством личности. Подписанную строку initData следует отправить на сервер и проверить по официальному алгоритму, включая допустимый возраст авторизации.
- Не хранить секретные ключи в frontend-коде.
- Повторно рассчитывать цену и доступ на сервере.
- Проверять webhook или ответ провайдера перед сменой статуса оплаты.
- Ограничивать частоту критических запросов и вести технический журнал.
- Собирать только данные, нужные для заявленного бизнес-процесса.
Что подготовить бизнесу до разработки
Полезнее принести не список экранов, а реальные примеры: как приходит заявка, кто её обрабатывает, откуда берётся наличие, когда заказ считается оплаченным и какие исключения случаются. Затем команда определяет одно главное действие первой версии и лишь после этого проектирует интерфейс. Так Mini App не превращается в красивую оболочку вокруг неработающего процесса.
Если вы выбираете формат, сначала сравнение бота и Mini App. Для оценки проекта используйте разбор факторов стоимости, а коммерческий сценарий можно обсудить на странице разработки Telegram Mini App.