Telegram mini app
Пользователи проводят в Telegram большую часть дня, но каждый переход на внешний сайт для покупки добавляет лишний шаг, и часть из них на этом шаге уходит. Эту задачу решает Telegram Mini App. Это веб-приложение, которое открывается прямо внутри мессенджера, без установки отдельного приложения из магазина.
Telegram Mini App: устройство платформы и возможности
Ваши подписчики уже в Telegram. Каждый переход на внешний сайт добавляет лишние действия, и на каждом шаге часть людей уходит, так и не заплатив. Telegram Mini App закрывает этот разрыв: человек выбирает товар, оплачивает и получает подтверждение, не выходя из Telegram. Ниже разберём, как устроены такие платформы и чем они отличаются от бота. Во втором разделе пройдём запуск Mini App по шагам, в третьем поговорим о монетизации, ограничениях и выводах.
Telegram Mini App — это веб-приложение, встроенное в мессенджер и написанное на HTML, CSS и JavaScript (JS). Интерфейс можно собрать и на React, и на Vue. Такие Telegram Mini Apps открываются внутри Telegram через бота или его меню, и для большинства пользователей это выглядит как панель поверх чата. По сути, это обычное веб-приложение, у которого есть свои правила игры.
Обычный чат-бот в Telegram общается диалогом: присылает текст, показывает кнопки и принимает ответы через Telegram Bot API, программный интерфейс для связи кода с мессенджером. Mini App даёт полноценный экран с каталогом и формами. Отдельное приложение из App Store и Google Play нужно скачать и установить, и часть пользователей на этом шаге уходит. Mini App ставить не нужно: он работает на платформах iOS, Android и Windows, а поддержка полноэкранного режима позволяет занять всё окно.
Интерфейс строится на веб-технологиях, поэтому порог входа невысокий, если вы уже делаете веб-страницы. Вы знаете HTML и CSS, а бизнес-логику пишете на JavaScript, как для браузера. Для такой разработки не нужны новые языки программирования.
Как устроен Mini App изнутри
Когда пользователь открывает приложение, Telegram показывает ваш код во встроенном компоненте WebView, то есть в браузерном окне. Туда же подключается Telegram Web Apps SDK, набор JavaScript-методов для связи с мессенджером. Через него приложение читает тему оформления, показывает кнопку внизу экрана и закрывает окно.
Инициализация занимает пару строк:
const tg = window.Telegram.WebApp;
tg.ready();
Для проверки пользователей SDK передаёт initData, строку с id, именем и цифровой подписью. Подпись создаётся с помощью токена бота, поэтому подделать её без токена практически нельзя. Сервер пересчитывает подпись и сравнивает её с присланной. Антипример: если сервер доверяет объекту initDataUnsafe, любой желающий подставит чужой id и выдаст себя за другого человека.
Где живёт приложение: бот, меню и direct link
У Mini App нет собственной иконки на экране телефона, поэтому точку входа создаёт владелец бота. Первый вариант — кнопка меню слева от поля ввода. Её настраивают в @BotFather или методом setChatMenuButton из Bot API. Второй — inline-кнопка под сообщением бота. Третий — direct link, прямая ссылка вида t.me/имя_бота/название_приложения.
Direct link ведёт сразу в приложение, минуя диалог. Через параметр startapp приложение получает минимум данных, например код акции. Кофейня, например, ставит такую ссылку в пост канала Telegram, и по клику открывается программа лояльности. Антипример: ссылка на внешний сайт открывает браузер, где человека заново просят ввести данные.
На этапе разработки проще начать с кнопки меню.
Чем Mini App отличается от бота и сайта
Бот, который общается через Bot API, подходит для коротких сценариев, например для уведомлений. Когда нужно выбрать размер из двадцати вариантов или заполнить адрес, диалог начинает мешать. Сайт даёт полный интерфейс, но человек уходит в браузер, вводит логин и пароль и часто бросает форму. Mini Apps совмещают оба подхода: интерфейс как у сайта и вход без регистрации, потому что initData подтверждает личность через Telegram.
Пример: интернет-магазин кофе держит в боте статус заказа, а выбор зёрен, корзину и оплату переносит в Mini App. Компании, которые уже общаются с клиентами в Telegram, сокращают путь покупки. Мини-приложения подходят продукту с частыми покупками. Сервисы записи к мастеру и AI-помощник для подбора товаров строятся по тому же принципу. Антипример: та же витрина на shop.example.com с обязательной регистрацией перед первой покупкой.
Правила оплаты и ограничения WebView, о которых часто забывают, разберём в третьем разделе отдельно.
Создание и запуск Telegram Mini App по шагам
Шаг 1. Создайте бота через BotFather
Разработка начинается с BotFather, официального бота Telegram для управления другими ботами. Откройте его через поиск, введите команду /newbot и задайте два имени: отображаемое и системное. Системное имя должно заканчиваться на bot, например coffee_shop_demo_bot.
В ответ BotFather пришлёт токен, строку вида 123456:ABC-DEF. Это ключ доступа к Telegram Bot API. Храните токен в переменных окружения, а не в коде и не в публичном репозитории. Если он утёк, перевыпустите его командой /revoke, иначе посторонний человек получит управление ботом.
Затем задайте меню бота. Отправьте BotFather команду /setmenubutton, выберите бота, укажите адрес веб-приложения, например https://coffee-demo.web.app, и текст кнопки, например «Открыть магазин». После этого кнопка у поля ввода откроет Mini App прямо в чате.
Шаг 2. Настройте фронтенд на React или Vue
Фронтенд отвечает за то, что видит пользователь. Для каталога и корзины подойдёт React или Vue. Проект создаётся командой npm create vite@latest. Основные файлы такие:
- index.html — точка входа, здесь подключается SDK;
- src/App.jsx — витрина с карточками товаров;
- src/Cart.jsx — корзина и кнопка оформления;
- .env — адрес вашего сервера, токен сюда не кладите.
WebApp SDK подключается скриптом https://telegram.org/js/telegram-web-app.js в index.html. Он создаёт объект window.Telegram.WebApp, через который приложение общается с клиентом Telegram. Инициализацию удобно вынести в корневой компонент:
const tg = window.Telegram.WebApp;
tg.ready();
tg.expand();
const user = tg.initDataUnsafe.user;
console.log('Пользователь:', user?.first_name);
Метод ready() сообщает Telegram, что интерфейс загрузился и экран ожидания можно убрать. Метод expand() разворачивает окно на всю высоту. Поле initDataUnsafe.user подходит только для показа имени в интерфейсе, потому что эти данные клиент может подменить.
Шаг 3. Проверьте initData на сервере
Серверная часть хранит каталог, заказы и отвечает за авторизацию. Её можно написать на Node.js с Express или на Python с FastAPI. В примере это файл server.js.
Клиент отправляет строку initData на эндпоинт, например POST /api/auth. Сервер проверяет подпись HMAC, то есть код, который подтверждает, что данные не менялись. Алгоритм такой: уберите поле hash, отсортируйте остальные параметры по алфавиту и склейте их через перенос строки. Затем из токена бота с ключом WebAppData получите секретный ключ и сравните вычисленную подпись с полем hash.
Данным, пришедшим с клиента, доверять нельзя. Любой человек может открыть консоль браузера и подставить чужой user_id. Антипример выглядит так: сервер берёт идентификатор из тела запроса и сохраняет заказ на этого пользователя. Правильно другое: сервер принимает заказ только после успешной проверки подписи и берёт данные пользователя из проверенной строки. Поле auth_date тоже проверяйте, чтобы старую строку нельзя было использовать повторно.
Шаг 4. Отладьте через HTTPS-туннель
Telegram открывает Mini App только по HTTPS, поэтому localhost напрямую не подойдёт. Туннель вроде ngrok или cloudflared выдаёт публичный адрес с HTTPS и перенаправляет запросы на локальный порт. Этот адрес на время тестов укажите в настройках бота через /setmenubutton.
Проверяйте приложение на iOS, Android и Windows. Мобильные клиенты открывают Mini App во встроенном WebView: на iOS это WebKit, на Android — Chromium-based WebView. Десктопная версия на Windows ведёт себя иначе. Вёрстка тоже расходится. Высота 100vh на iOS может заходить под адресную строку, поэтому используйте единицы dvh и значение tg.viewportStableHeight. Отступы под вырез экрана задавайте через safe-area.
Анимации тестируйте на реальных телефонах, а не только в DevTools. Двигайте элементы через transform и opacity, а не через height и top. Иначе на слабых Android-устройствах появятся рывки.
Шаг 5. Опубликуйте на Firebase Hosting и подключите direct link
Firebase Hosting раздаёт статику по HTTPS без ручной настройки сертификата. Сначала выполните команды npm install -g firebase-tools, firebase login и firebase init hosting, укажите папку dist как публичную, затем запустите firebase deploy. Получите адрес вида проект.web.app.
Firebase Hosting отдаёт только статические файлы, поэтому сервер с проверкой initData разместите отдельно: на Cloud Run, в Cloud Functions или на VPS. Адрес сервера укажите в .env.
Чтобы подключить direct link, отправьте BotFather команду /newapp. Выберите бота, укажите название, описание, фото, короткое имя, например shop, и адрес веб-приложения. Ссылка получится вида https://t.me/coffee_shop_demo_bot/shop. По ней приложение открывается сразу, без перехода через чат, и её можно разместить в канале или на сайте. Кнопку запуска в сообщениях бота добавьте как inline-кнопку типа web_app с тем же адресом.
Проверка: убедитесь, что приложение открывается из бота, данные пользователя приходят и проходят проверку на сервере.
Монетизация Telegram Mini App: ограничения и выводы
Как Mini App меняет путь покупателя
Путь «бот, сайт, оплата» знаком многим: пользователь нажимает ссылку, попадает в браузер, входит или регистрируется, вводит адрес и только потом доходит до оплаты. Путь «бот, Mini App, оплата» короче. Приложение открывается прямо в переписке, а данные аккаунта Telegram передаются в него без дополнительного входа.
Сравним шаги:
- «Бот, сайт, оплата»: переход в браузер, вход или регистрация, повторный ввод контактов, отдельная страница оплаты. На каждом шаге часть людей закрывает вкладку.
- «Бот, Mini App, оплата»: каталог открывается в том же окне, товары попадают в корзину без перехода, контакты подтягиваются из Telegram, оплата проходит в одном сценарии.
Больше всего клиентов теряется на переходе в браузер и при повторном вводе данных. Чтобы увидеть эти потери, следите за метриками. DAU (количество активных пользователей за день) показывает, сколько людей открывают приложение. Удержание отвечает, сколько из них возвращаются через неделю или месяц. Конверсия показывает долю тех, кто оформил покупку, а средний чек говорит, сколько стоит один заказ. Сравнивайте свои цифры до и после запуска за одинаковые периоды, а не с чужими усреднёнными данными.
Оплата: Telegram Stars и внешние платёжные системы
Telegram Stars — внутренняя валюта мессенджера. Пользователь покупает звёзды внутри Telegram и тратит их в приложении, поэтому отдельный эквайринг не нужен. Способ подходит для цифровых товаров и услуг: доступа к контенту, подписок, виртуальных предметов.
Для физических товаров, например одежды, обычно подключают внешний платёжный провайдер. Такие системы берут комиссию за эквайринг, а Telegram удерживает собственную долю при конвертации звёзд в деньги. Разница заметна: при комиссии 3% с чека в 1 500 рублей вы теряете 45 рублей, при 10% — уже 150. Точные ставки и курс меняются, поэтому перед расчётом проверьте условия Telegram Stars и провайдера на 2026 год.
Стоимость и окупаемость
Стоимость разработки зависит от сложности: количества экранов, интеграций с 1С или CRM, оплаты, личного кабинета и бизнес-логики. Ориентиром можно считать от 100 000 рублей за простой прототип каталога с корзиной, но это отправная точка для разговора, а не расценка. Сравнивайте предложения подрядчиков по списку функций, а не по итоговой сумме. Если часть кода пишете с помощью AI-инструментов, прототип обойдётся дешевле, но тестирование и поддержку это не отменяет.
Окупаемость считается просто: прибыль за месяц делим на вложения. Пример с условными цифрами, которые нужны только для логики расчёта. Приложение открывают 2 000 активных пользователей в месяц. Конверсия в покупку — 2%, то есть 40 заказов. Средний чек — 1 500 рублей, выручка — 60 000 рублей. После себестоимости товара, комиссии и поддержки остаётся 35% выручки, то есть 21 000 рублей. Разработка обошлась в 210 000 рублей. Срок окупаемости: 210 000 ÷ 21 000 = 10 месяцев.
Ограничения, о которых часто забывают
Здесь есть одно ограничение, о котором часто забывают: Mini App работает внутри клиента Telegram, поэтому правила задаёт платформа. Telegram меняет API, и код, который работал в прошлом месяце, может сломаться. Закладывайте слой абстракции: вызовы WebApp SDK соберите в один модуль. Тогда при изменении Bot API переписывается один файл, а не весь проект.
WebView на iOS и Android ведёт себя по-разному. Отличаются высота экрана, прокрутка и поведение клавиатуры при вводе адреса. Вёрстку проверяйте на реальных устройствах, потому что эмулятор часто скрывает то, что видит покупатель.
Аналитику воронки (открыл каталог, добавил товар, начал оплату) отправляйте на свой сервер или в сервис аналитики. Авторизацию завязывайте на initData, а не на cookie: сторонние cookie во встроенном браузере могут не работать. Телефон, адрес и история заказов относятся к персональным данным, поэтому нужна политика конфиденциальности с описанием того, что собирается, где хранится и как удаляется. Требования к документу на 2026 год сверяйте с законодательством о персональных данных.
Выводы
Mini App подходит интернет-магазинам с понятным каталогом, например магазину одежды с размерной сеткой. Подходят и сервисы записи к мастеру, программы лояльности кофейни, реферальные механики, где человек приглашает друзей. В этих сценариях покупатель уже общается с вами в Telegram, и переход на внешний сайт становится лишним шагом.
Не подойдёт, если клиентов в Telegram мало. Приложение, которое открывают двадцать человек в месяц, не окупит разработку даже при хорошей реализации. Сначала посчитайте, сколько клиентов пишут в бот или читают канал, и только потом решайте, нужно ли вам отдельное приложение.
Mini App не заменяет сайт и не делает бизнес успешным сам по себе. Это ещё один канал, который работает там, где клиент уже находится.