Mini Apps в Telegram
Экран внутри переписки
Telegram Mini App — это веб-страница, которую Telegram открывает внутри себя по запуску из бота и которой передаёт подписанную строку `initData` с личностью пользователя. Вся ценность в этой подписи: она целиком убирает шаг входа из оформления заказа, потому что приложение знает, кто перед ним, ещё до того, как отрисует первый пиксель.
Разработка Telegram Mini Apps: что входит в этот раздел
- Личность пользователя
- Подписанная initData, HMAC-SHA256 на ключе из токена бота
- Проверка подписи
- Только на сервере. Проверка на клиенте не доказывает ничего
- Viewport
- Сообщает свою высоту сам; разворачивается по жесту, а не по умолчанию
- Хранилище
- Поведение хранилища и cookie в webview различается на iOS и Android
- Охват
- Только пользователи Telegram. В поиске не появится никогда
- Оплата
- Telegram Stars для цифровых товаров; провайдер или TON для всего остального
As of 2025-10-01, Telegram Bot API 13.4
Почему Mini App, а не сценарий в чате
Диалог с ботом — хороший интерфейс для пяти решений и плохой для двадцати. Как только покупателю нужно сравнить четыре позиции, отфильтровать каталог или увидеть, как пересчитывается сумма при смене количества, формат «сообщение и кнопки» перестаёт помогать и начинает мешать. Mini App — это ответ Telegram на такую задачу: настоящий webview, открытый из той же переписки, который закрывается и возвращает результат боту.
От обычной ссылки на сайт его отличает личность пользователя. Telegram передаёт приложению подписанные данные о том, кто его открыл, и сервер, проверивший подпись, точно знает собеседника без пароля, письма со ссылкой и похода в OAuth. На веб-оформлении этот шаг каждый раз стоит части заказов; здесь его просто нет.
Плата за это — охват и обнаружимость, и обе потери абсолютны. Mini App доступен тем, кто уже в Telegram, и больше никому, и он никогда не появится в поисковой выдаче. Именно этот размен и должен помочь взвесить раздел, а страницы сравнений ниже спорят в обе стороны, а не только в лестную для нас.
Продажи прямо в переписке
Проекты, где Mini App и есть сам продукт, а не удобство: каталог, корзина и оплата внутри той переписки, в которой покупатель уже находится.
Вся торговая поверхность целиком — каталог, корзина, оформление и расчёт в сети — это
Про меню с модификаторами, где довод о плотности интерфейса сильнее всего, читайте
Интерфейсы, которые не помещаются в диалог
Случаи, когда причина брать Mini App — только плотность интерфейса: меню с модификаторами, сетка слотов, баланс кошелька, который должен обновляться прямо на глазах.
Баланс, который меняется, пока пользователь на него смотрит, живёт в webview — поэтому отдельно вынесены
Рабочий пример того же приёма, который на этом сайте работает и как веб-страница, и как Mini App, —
Чем в итоге платят
Чем реально двигаются деньги и какие правила по категориям товаров решают, что из этого вам вообще разрешено. Именно эта часть чаще всего меняет план.
Для цифровых товаров способ оплаты, где нет вообще никакого подключения мерчанта, — это
Чтобы покупатель платил из кошелька, которым уже владеет сам, нужен протокол
Таймаут перед подтверждением платежа и окно возврата разобраны в
Нужен ли Mini App вообще
Аргументы против, изложенные честно. Два материала из трёх приходят к выводу, что заметной доле читателей Mini App не подходит.
Если вопрос в том, идти ли в магазины приложений вообще, читайте
Когда органический поиск важнее трения при оплате, смотрите
Раскладка по трудозатратам, включая оболочку и проверку подписи, — это
О чём спрашивают, прежде чем заказать Mini App
Mini App — это просто сайт в рамке?
Технически почти так, практически нет. Разница в подписанной initData: платформа передаёт странице уже проверенную личность пользователя до того, как та отрисуется. Это убирает весь шаг аутентификации, на котором в обычном оформлении заказа теряется измеримая доля покупателей.
Можно ли проверять init data прямо в браузере?
Нет, и отношение к этой проверке как к формальности — самая частая ошибка безопасности в этой области. Подпись считается ключом, выведенным из токена бота; положить токен в клиентский код значит выдать любому возможность подделать личность. Проверка идёт на сервере, по исходной строке, до того как чему-либо начинают доверять.
Можно ли продавать через Mini App физические товары?
Да, но не через Telegram Stars — они разрешены только для цифровых товаров и услуг. Физическим товарам нужен платёжный провайдер, с которым у вас есть договор эквайринга, либо расчёт в сети. Это правило меняет планы чаще любого другого в разделе.
Будет ли Mini App находиться в поиске Google?
Нет. У него нет индексируемого адреса и не будет. Если бизнесу важен приход из поиска, Mini App — неверная основная поверхность, и правильнее делать веб-витрину, а бота держать рядом с ней.
Одинаково ли он работает на iPhone и на Android?
В целом да, с двумя практическими различиями, которые стоит заложить в дизайн: доступный объём хранилища и поведение cookie внутри webview различаются, а окно открывается меньше экрана и разворачивается только по жесту пользователя. Оба случая дёшево учесть заранее и неприятно обнаружить после запуска.
Нужен ли бот, или хватит одного Mini App?
Нужны оба, всегда. Mini App запускается из бота и ему же возвращает результат; отдельной формы существования у него нет. На практике в боте живут ещё и уведомления, чеки и поддержка, так что обузой он оказывается редко.
Что почитать дальше
Каждая перечисленная здесь сборка, с точной суммой и сроком сдачи, попадает в полный каталог.
Про вторую поверхность, которая живёт внутри Telegram, а не рядом с ним, рассказывают AI-ассистенты внутри чата.
Точные лимиты, упомянутые выше, — проверка подписи, размеры окна, потолки данных — описаны в справочник по Bot API.
На что именно уходят трудозатраты, показывают разборы стоимости.