Что такое Telegram Mini App
Telegram Mini App — веб-приложение, которое открывается внутри Telegram и взаимодействует с клиентом через JavaScript API. В документации встречаются и термины Web Apps, Telegram.WebApp, WebAppInfo и поле web_app. Это названия связанных API-механизмов; в этой статье используем название продукта Mini Apps.
Пользователь видит страницу с обычными элементами интерфейса: формами, карточками, фильтрами, календарём. Она загружается с вашего веб-сервера. Для её создания подходят HTML, CSS и JavaScript; серверную часть можно написать на PHP, Laravel или другом привычном стеке. Поддерживать собственный HTML-движок не нужно, но сайт и его серверная логика остаются вашей ответственностью.
Обычный бот получает события и отвечает сообщениями, кнопками, файлами и другими возможностями Bot API. Его сценарий разворачивается в переписке. Mini App добавляет визуальный интерфейс к этому взаимодействию. На практике один бот может открывать приложение и обслуживать сообщения поддержки.
Когда удобно остаться в чате
Чат хорошо подходит для коротких последовательных действий и событий, о которых нужно сообщить без открытия отдельного экрана: статус заявки, напоминание о визите, ответ оператора, выдача документа. Клиенту понятно, куда вернуться с вопросом, а история общения остаётся в диалоге.
Для нашего сервисного центра первые три шага — выбрать услугу, описать проблему и оставить контакт — можно реализовать через пошаговую анкету. Если клиент должен видеть только одну текущую задачу, отдельная веб-форма может пока не окупить затраты на поддержку.
При этом бот тоже требует разработки. Понадобится хранить шаг диалога, обрабатывать отмену и повторные события, не смешивать черновики разных пользователей. Нужно решить, что делать с сообщением, которое пришло не на текущем шаге. Отсутствие веб-страницы не отменяет серверную логику и базу заявок.
Сигнал к пересмотру интерфейса — пользователи часто возвращаются на несколько шагов назад, теряют выбранные значения или просят увидеть всё сразу. Сначала проверьте, нельзя ли сократить саму анкету. Большой интерфейс не исправит лишние вопросы.
Когда Mini App даёт заметную пользу
Приложение помогает, когда на экране нужно сопоставлять данные и свободно менять выбор. Например, клиент выбирает несколько услуг, проверяет стоимость, переключает филиал и дату, редактирует заявку перед отправкой. В чате такой сценарий быстро превращается в длинную цепочку сообщений.
Задача клиента | Удобная отправная точка | Почему |
|---|---|---|
Получить уведомление о готовности | Чат-бот | Достаточно сообщения и одной кнопки |
Задать вопрос менеджеру | Чат-бот | Важны переписка и контекст ответа |
Оставить простую заявку | Оба варианта | Решает длина формы и необходимость редактирования |
Сравнить много товаров по фильтрам | Mini App | На одном экране видны выбор и результат |
Собрать заказ из нескольких позиций | Mini App | Нужны корзина, количества и итог |
Просмотреть историю обращений | Mini App вместе с ботом | История удобна списком, новые статусы приходят сообщениями |
Это практические ориентиры, а не ограничение Telegram. Небольшой каталог с кнопками может хорошо работать в чате. Важнее проверить реальный путь клиента: сколько действий требуется до результата и где он ошибается.
Из чего состоит приложение и что придётся поддерживать
У простого Mini App обычно есть несколько частей:
Бот и точка запуска: кнопка в личном диалоге, кнопка меню или другой выбранный способ открытия.
Веб-интерфейс на HTTPS: страница, стили, код формы, состояния загрузки и ошибки.
Серверный API: проверка данных Telegram, прав пользователя и введённых значений.
Постоянное хранилище: заявки, товары, расписание и связи с учётной системой.
Доставка уведомлений, если она нужна: отправка через Bot API и обработка недоступного диалога.
Работы добавляются и после первого запуска. Интерфейс проверяют на телефоне и компьютере, в светлой и тёмной теме, с открытой клавиатурой и медленным соединением. Продумывают повторную отправку, закрытие окна до ответа, истечение авторизации и возвращение к черновику. База, HTTPS и сервер требуют того же сопровождения, что и обычное веб-приложение.
Если у компании уже есть адаптивный кабинет и API, часть логики можно использовать повторно. Но наличие сайта ещё не означает готовность к запуску внутри Telegram: нужно отдельно проверить вход, права, переходы, оплату при её наличии и поведение в webview. Не переносите автоматически всю структуру сайта в маленькое окно.
Как пользователь определяется и что защищает сервер
Mini App получает initData от Telegram. Сервер должен проверить подпись этих исходных данных, срок auth_date и только затем использовать Telegram ID. initDataUnsafe удобно для интерфейса, но доверять ему при сохранении заявки или выдаче чужих данных нельзя.
Подтверждённый Telegram ID показывает, кто открыл приложение, но не доказывает право на конкретный заказ, роль менеджера или оплату. Эти условия проверяются по вашей базе. Телефон и email также не следует считать автоматически полученными и подтверждёнными: для них нужен отдельный согласованный сценарий.
Действующая подпись не защищает от повторного сохранения одной и той же формы. Для этого серверу нужен идентификатор операции и ограничение уникальности. Закрытие Mini App или анимация успеха сами по себе не означают, что заявка дошла до БД. Сначала сервер подтверждает сохранение, затем интерфейс показывает результат.
Практический пример этой границы есть в руководстве «Первое Mini App на HTML и PHP».
Как совместить форму и диалог
Для нашего сервисного центра можно выбрать смешанный сценарий: бот принимает /start и открывает кнопку «Оставить заявку», Mini App показывает услугу и описание на одном экране, сервер сохраняет заявку, а дальнейшее общение идёт в чате. Менеджеру не приходится отвечать из отдельного приложения, а клиенту — редактировать анкету через десяток сообщений.
Заранее определите, откуда клиент возвращается к заявке и что увидит после повторного открытия формы. Бот не получает автоматически всю работу браузера: данные нужно отправить на свой сервер либо через механизм, соответствующий способу запуска. Например, sendData предназначен для приложений, открытых через кнопку обычной клавиатуры; это не универсальная отправка из любого Mini App.
Возможность уведомлять пользователя также зависит от доступа бота к личному диалогу. Открытие приложения по ссылке не стоит считать безусловным разрешением на любые сообщения. Для первого проекта проще начинать из уже открытого пользователем личного чата и отдельно проверять ошибки отправки.
Как принять решение до большой разработки
Опишите один целевой результат: например, клиент оставил заявку с выбранной услугой и получил её номер. Сделайте два простых прототипа — последовательность сообщений и одну форму. Дайте нескольким будущим пользователям пройти одинаковую задачу без подсказок. Сравните завершённые заявки, ошибки, возвраты и вопросы менеджеру, а не только впечатление от внешнего вида.
Для первой версии зафиксируйте обязательные действия и уберите редкие настройки. Если чат уже решает задачу, можно начать с него и собирать причины отказов. Если без общего экрана клиент не понимает выбор, Mini App имеет смысл включить в первую версию. Универсального порога по бюджету или числу пользователей нет: оценку делают по конкретным сценариям, интеграциям и составу команды.
Отдельно оцените дальнейшее сопровождение: кто меняет услуги, разбирает сбои, обновляет интерфейс и отвечает за доступ к данным. Стоимость решения определяется не только первым экраном.
Какую часть задачи может закрыть BotGate
BotGate используется для обмена вашего сервера с Telegram Bot API и приёма webhook. В смешанном сценарии через него можно отправлять сообщения и кнопки запуска. Саму страницу Mini App, HTTPS, проверку initData, сохранение формы и бизнес-логику нужно разместить и реализовать отдельно. Подключение API-шлюза не создаёт веб-приложение автоматически.
Путь браузер → ваш сервер и путь ваш сервер → Telegram — разные соединения. Если форма не загружается, начните с доступности её HTTPS-адреса. Если заявка сохраняется, но сообщение не приходит, отдельно разбирайте отправку через Bot API. Схема подключения описана в документации BotGate.
Официальная документация
Telegram Mini Apps — способы запуска и возможности JavaScript API.
Проверка данных Mini App — доверие к initData.
Возможности ботов — команды, кнопки и сообщения.