Мини-приложение в Телеграм для бизнеса: что это и как его запустить

Что такое мини-приложение в Телеграм

Мини-приложение в Телеграм (Telegram Mini App) — это веб-интерфейс, который открывается внутри Telegram из бота. По сути это сайт на JavaScript, только живёт он в мессенджере: человек нажимает кнопку и видит каталог, форму записи или личный кабинет. В документации Telegram сказано, что такое приложение может заменить сайт. Но если клиенты приходят из поиска или у части из них нет Telegram, сайт всё равно нужен.

Для пользователя это выглядит так:

• ничего не нужно устанавливать, приложение открывается прямо в Telegram;
• отдельная регистрация не обязательна: в зависимости от способа запуска приложение получает базовые данные профиля, например идентификатор, имя и язык (условия Telegram для мини-приложений);
• телефон и геопозицию — только если человек сам их передаст.

В коде и в адресе документации мини-приложения до сих пор называются WebApp, поэтому в статьях встречается и название Telegram Web App. Это одно и то же.

Чем мини-приложение отличается от бота и от сайта

Бот ведёт диалог, мини-приложение показывает экраны, сайт встречает людей из поиска.

Простое правило: если задачу можно решить в 2⁠–⁠3 сообщениях, хватит бота. Если человеку нужно выбирать из многих вариантов, листать, фильтровать, видеть корзину или сетку свободного времени, нужно мини-приложение. Для клиентов из поиска и тех, у кого нет Telegram, остаётся сайт. Что умеют боты и как выбрать между Telegram и MAX, рассказано в статье про чат-ботов для бизнеса.

Что выбрать под задачу

• БотХватит 2⁠–⁠3 сообщений: заявка, вопрос, статус
• Мини-приложениеНужно выбирать и листать: каталог, запись, кабинет
• СайтНужен всё равно, если клиенты приходят из поиска или без Telegram

Какие задачи бизнеса закрывает мини-приложение

• Каталог и заказ. Товары с фильтрами и корзиной, оформление и оплата без перехода на сайт.
• Запись. Выбор услуги, специалиста и свободного времени в сетке. Подтверждение и напоминание приходят сообщением от бота.
• Личный кабинет. Заказы, статусы, документы, бонусы. Человек открывает его из чата с ботом и не вспоминает пароль.
• Программа лояльности. Карта клиента с бонусами и историей покупок. Скачивать для неё отдельное приложение не нужно.
• Платный доступ. Онлайн-курсы, подписки, закрытые материалы. Это цифровые услуги, и для них в Telegram свои правила оплаты, о них ниже.
• Инструменты для сотрудников. Заявки, отчёты с объектов, справочники, согласования. Сотрудники уже сидят в Telegram, поэтому внедрять такое проще. Какой процесс автоматизировать первым, разобрано в статье про автоматизацию бизнес-процессов.
• Акции и игры. Квизы, розыгрыши, персональные результаты. Приложение может открыть редактор историй Telegram, чтобы человек поделился результатом. Какими результатами делятся охотнее, разобрано в статье про вирусного ИИ-бота.

Как устроено мини-приложение

Мини-приложение состоит из четырёх частей.

1. Бот. Через него приложение открывают. Бота регистрируют в BotFather, там же к нему подключают приложение.
2. Экраны. Веб-приложение, которое видит пользователь. Оно лежит на вашем хостинге.
3. Сервер. Хранит данные, считает цены и остатки, проверяет, что запрос пришёл от настоящего пользователя Telegram.
4. Ваши системы. CRM, учёт, расписание, платёжный провайдер.

Про безопасность: данным о пользователе, которые приходят в браузер, доверять нельзя. По документации, сервер должен проверять подпись этих данных, например с помощью токена бота. Без такой проверки сервер не может быть уверен, что запрос прислал именно этот человек.

Как человек открывает приложение

Способов запуска несколько, их можно сочетать:

• кнопка запуска приложения в профиле бота (в английском интерфейсе — «Launch app»), если приложение настроено как главное (Main Mini App);
• кнопка меню в чате с ботом;
• кнопка в сообщении бота или на его клавиатуре;
• прямая ссылка на t.me с именем бота и приложения, её можно разместить где угодно;
• инлайн-режим, когда бота вызывают в любом чате.

Меню вложений, по документации, доступно только крупным рекламодателям рекламной платформы Telegram, поэтому рассчитывать на него не стоит.

Что приложению доступно

Через API Telegram мини-приложение может:

• попросить номер телефона, если пользователь согласится его передать;
• попросить разрешение на сообщения от бота;
• хранить небольшие данные пользователя в облаке Telegram, до 1024 записей на пользователя в одном боте;
• запросить геопозицию, открыться на весь экран и предложить ярлык на главный экран телефона;
• запросить подтверждение по биометрии устройства;
• подстраиваться под светлую или тёмную тему пользователя.

Как запустить мини-приложение: по шагам

Создание мини-приложения для Telegram обычно идёт в таком порядке.

Запуск по шагам

1. Одна задачаЧто человек должен сделать
2. Бот и экраныBotFather, тема и кнопки Telegram
3. СерверПроверка пользователя и подключения
4. ОплатаStars за цифровое, провайдер за физическое
5. Запуск с меткамиСвоя ссылка на каждый канал

1. Одна главная задача. Что человек должен сделать: заказать, записаться, оплатить. И по какому показателю вы поймёте, что приложение работает. Как проверить идею до разработки, рассказано в статье про запуск ИИ-продуктов.
2. Бот. Создайте его в BotFather и храните токен как пароль.
3. Экраны под телефон. Telegram в рекомендациях по дизайну советует брать цвета из темы пользователя и делать анимации плавными, в идеале 60 кадров в секунду. Кнопку «Назад» и главную кнопку внизу экрана лучше взять готовые из Telegram, тогда приложение выглядит своим.
4. Сервер и подключения. Проверка данных пользователя, база, связь с CRM, учётом и расписанием.
5. Оплата. Способ зависит от того, что вы продаёте, об этом следующий раздел.
6. Настройка в BotFather. Подключите приложение как главное, добавьте кнопку меню, настройте экран загрузки со своей иконкой и цветами.
7. Проверка. На разных телефонах, в светлой и тёмной теме, при слабом интернете.
8. Запуск с метками. В прямую ссылку можно добавить параметр startapp, и приложение получит его при открытии. Дайте каждой рекламе и каждому каналу свою ссылку, тогда будет видно, откуда пришли покупатели.

Оплата в мини-приложении

Способ оплаты зависит от того, что вы продаёте.

• Цифровые товары и услуги. Внутри Telegram бот и мини-приложение продают их только за Telegram Stars (правила оплаты в Stars). Возвраты делают через Bot API, а бот должен отвечать на команду /paysupport.
• Физические товары и услуги. Их можно продавать в обычной валюте через стороннего платёжного провайдера (документация по платежам). Данные карты обрабатывает и хранит провайдер, у Telegram и у владельца бота доступа к ним нет.
• Условия и поддержка. При оплате через провайдера бот должен показывать условия продажи, например по команде /terms, и поддерживать покупателей, например через команду /support. Споры и возвраты по картам Telegram не разбирает: ими занимаются продавец и платёжный провайдер.

Если продаёте онлайн-курсы или подписки, заранее посчитайте экономику в Stars.

Данные, правила и модерация

• Данные. По условиям Telegram для мини-приложений, приложение получает IP-адрес и, в зависимости от способа запуска, базовые данные профиля. За то, как владелец приложения обращается с этими данными, Telegram ответственности не несёт. Если вы собираете телефоны, адреса и заказы, это персональные данные: заранее решите, где они хранятся и как вы сообщаете о них пользователю. Подробнее в статье про нейросети и персональные данные.
• Модерация в Telegram. Бота и приложение подключают самостоятельно в BotFather. При этом по тем же условиям Telegram может ограничить доступ к приложениям отдельных разработчиков, а для оплаты действуют правила из раздела выше.
• MAX. Мини-приложения там работают только внутри чат-ботов и добавляются в настройках бота. Подключиться к платформе могут российские юрлица, ИП и самозанятые, а Цифровой ID и подписание документов «Госключом» — только юрлица и ИП (документация MAX). Сам бот создаётся только с верифицированным профилем и становится доступен пользователям после модерации (ответы MAX о чат-ботах).

В России Telegram работает с ограничениями: в феврале 2026 года Роскомнадзор подтвердил, что ограничивает его работу. Поэтому до разработки проверьте, насколько он доступен вашей аудитории. Об этом и о выборе между Telegram и MAX есть раздел в статье про чат-ботов.

Как удержать пользователей

Человек открыл приложение один раз и забыл про него. Вернуть его помогают возможности самого Telegram:

• Разрешение на сообщения. Просите его в момент, когда это выгодно человеку: чтобы прислать статус заказа или напомнить о записи.
• Ярлык на главном экране телефона. Приложение может предложить его добавить.
• Главное мини-приложение. Кнопка запуска приложения в профиле бота (в английском интерфейсе — «Launch app»). Ещё такой бот появляется во вкладке приложений в поиске у тех, кто его уже запускал.
• Сохранённое состояние. Корзину или незаконченную запись можно хранить в облаке Telegram, чтобы человек продолжил с того же места.
• Повод вернуться. Бонусы, статус заказа, новинка в любимой категории. Без повода инструменты не помогут.

После запуска смотрите, сколько людей открыли приложение, сколько дошли до заказа или записи, на каком экране уходят и сколько вернулись через неделю. По меткам в ссылках видно, какой канал приводит покупателей.

Типичные ошибки

• Приложение там, где хватило бы бота. Три экрана ради одной заявки только мешают.
• Весь сайт внутри Telegram. На телефоне человек решает одну задачу, все разделы сайта ему там не нужны.
• Нет проверки данных на сервере. Сервер верит всему, что прислал браузер.
• Цифровой товар с оплатой картой. По правилам Telegram цифровые товары внутри Telegram продают за Stars.
• Нет условий и поддержки. Покупателю некуда написать, если что-то пошло не так.
• Свой дизайн без оглядки на Telegram. Приложение не меняется вместе с тёмной темой, кнопка «Назад» ведёт не туда.
• Нет меток в ссылках. Деньги на рекламу уходят, а какой канал работает, непонятно.
• Нет плана, как вернуть человека. Разрешение на сообщения не попросили, и связи с клиентом нет.

Когда звать подрядчика

Для простой витрины или формы записи иногда хватает готовых конструкторов. Своя разработка обычно оправдана, когда приложение берёт данные из ваших систем, принимает оплату или хранит историю клиентов.

Подрядчик должен начать с разбора: что спрашивают клиенты, куда идут заявки, что считать результатом. Дальше он запускает основной сценарий и проверяет его на настоящих пользователях, подключает ваши системы, передаёт документацию и следит за качеством после запуска. Мы делаем мини-приложения для Telegram с личным кабинетом и оплатой и держим собственных ботов. Поэтому знаем, что происходит с ботом после запуска: нагрузка, оплаты, блокировки и поддержка.