Мини-приложение в Telegram (его ещё называют мини апп в телеграм) - это веб-страница, которая открывается прямо внутри мессенджера из чата с ботом, из его профиля или по ссылке. Клиенту не нужно регистрироваться: Telegram сам сообщает приложению, кто его открыл. Внутри можно сделать то, что в переписке с ботом неудобно: каталог с фотографиями и фильтрами, выбор даты и времени, корзину, личный кабинет.
Если клиенту нужно оставить заявку или получить ответ на вопрос, хватит обычного бота. Мини-приложение нужно, когда в кнопках и сообщениях становится тесно. При заказе следите за тремя вещами: данные пользователя сверяются на сервере, цифровые товары оплачиваются в звёздах - внутренней валюте Telegram, а приложение тестируют на разных устройствах, потому что часть функций работает не везде.
В наших проектах есть бот в Telegram и ИИ-ассистент, который отвечает покупателям. Ниже разберём, по каким признакам решать, нужно ли мини-приложение, и что в нём проверить.
Чем мини-приложение отличается от бота и сайта?
Коротко: бот общается сообщениями и кнопками, сайт живёт отдельно и для заказа или кабинета просит войти, мини-приложение - это сайт внутри Telegram, который сразу знает пользователя. Выбор зависит от того, сколько действий делает клиент и нужен ли ему экран с каталогом, календарём или корзиной.
| Бот | Мини-приложение | Сайт | |
|---|---|---|---|
| Где открывается | В чате Telegram | Внутри Telegram, поверх чата | В браузере |
| Как клиент входит | Сразу, это его аккаунт | Сразу, Telegram передаёт, кто открыл | Для заказа или кабинета - регистрация или вход |
| Что удобно | Заявки, ответы на вопросы, уведомления | Каталог, фильтры, календарь, корзина, личный кабинет | Всё, включая поиск из Яндекса |
| Что неудобно | Выбор из десятков вариантов | Длинные тексты и поиск из поисковиков | Возврат клиента без рассылки |
Мини-приложение обычно работает вместе с ботом. Бот присылает уведомления и напоминания, а мини-приложение открывается, когда клиенту нужно что-то выбрать. Как устроен такой бот и что в нём проверять, мы разбирали в статье про бота для записи клиентов.
Когда мини-приложение нужно, а когда хватит бота?
Коротко: мини-приложение нужно, когда клиент выбирает из многих вариантов, смотрит фотографии, собирает корзину или возвращается в личный кабинет. Бота хватает для заявок, ответов на вопросы, статусов заказа и напоминаний. Если всё укладывается в пять-шесть кнопок, мини-приложение - лишние расходы.
Признаки, что пора делать мини-приложение:
- в каталоге десятки товаров или услуг с фотографиями и вариантами;
- клиент выбирает дату и время из календаря с учётом свободных окон;
- нужна корзина из нескольких позиций и оплата;
- клиент возвращается посмотреть свои заказы, баллы или абонемент;
- в боте уже больше пяти-шести шагов подряд, и клиенты бросают их на середине.
Признаки, что хватит бота: клиент оставляет заявку, задаёт вопрос, получает статус заказа или напоминание. Отвечать на вопросы в личной переписке от вашего имени умеет бот-секретарь. Это отдельный режим Telegram, мы разбирали его в статье про бота-секретаря.
Что умеет мини-приложение в Telegram?
Коротко: открываться из кнопки в чате, из профиля бота и по прямой ссылке, работать на весь экран, получать номер телефона с согласия клиента, хранить настройки, принимать оплату и ставить ярлык на главный экран телефона. Всё это описано в документации Telegram для разработчиков.
По документации Telegram мини-приложение открывается в том числе из кнопки в профиле бота, кнопки меню, кнопки под сообщением и по прямой ссылке. Для бизнеса это значит: ссылку можно поставить в рассылку, в описание канала или на визитку, и клиент попадёт сразу в приложение.
Что ещё умеет мини-приложение по той же документации:
- работать на весь экран и добавлять ярлык на главный экран телефона - эти возможности появились в версии конца 2024 года;
- попросить номер телефона: Telegram показывает клиенту своё окно, и клиент сам решает, делиться ли номером;
- хранить небольшие настройки пользователя в облаке Telegram, например выбранный город или язык. Заказы и личные данные клиентов лучше держать на своём сервере;
- спросить разрешение присылать сообщения от бота, чтобы потом напоминать о заказе;
- запросить геопозицию с согласия пользователя.
В каталог мини-приложений Telegram, по документации, могут отобрать успешных ботов, у которых включено основное мини-приложение и есть оплата в звёздах. Рассчитывать на каталог как на канал привлечения клиентов не стоит.
Какие ограничения у мини-приложения в Telegram?
Коротко: данные о пользователе, которые приходят в приложение, нельзя принимать на веру без проверки на сервере. Часть функций работает не на всех устройствах и версиях Telegram. Приложение можно свернуть или закрыть свайпом в любой момент, и незаконченный заказ пропадёт, если его не сохранять.
Проверка пользователя. Telegram прямо предупреждает, что данным о пользователе, которые видит само приложение, доверять нельзя: их нужно сверять по подписи на сервере бота. Вам достаточно спросить подрядчика: «Проверяет ли сервер подпись Telegram перед тем, как показать заказы клиента?» Если нет, злоумышленник может выдать себя за другого клиента и увидеть чужие заказы.
Разные устройства. У клиентов разные версии Telegram, и не все возможности есть везде. В документации есть способ узнать версию Telegram у клиента, а полноэкранный режим на части устройств и платформ не поддерживается. Проверяйте приложение на iPhone, Android и в Telegram на компьютере.
Закрытие. Мини-приложение можно свернуть или закрыть свайпом вниз. Для незаконченного заказа можно включить подтверждение закрытия, но лучше сохранять корзину на сервере, чтобы клиент вернулся к ней.
Как принимать оплату в мини-приложении?
Коротко: за физические товары и услуги - через платёжного провайдера, данные карт видит только он, Telegram комиссию не берёт. За цифровые товары и услуги Telegram требует оплату только в звёздах. Что относится к цифровым, решите до разработки.
Физические товары и услуги оплачиваются через сторонних провайдеров: данные карт хранит провайдер, ни Telegram, ни разработчик бота к ним доступа не имеют. Комиссию провайдера платите по его тарифу, Telegram за такие платежи ничего не берёт.
Цифровые товары и услуги, по правилам Telegram, оплачиваются только звёздами. Причина - правила магазинов приложений Apple и Google. Стрижка, доставка пиццы или абонемент в зал - это услуги в реальном мире. Доступ к записанному курсу или закрытому контенту - уже цифровое. Живые занятия по видео - спорный случай. Если ваш продукт на границе, определитесь до разработки: от этого зависит, как будет устроена оплата.
Нужно ли делать мини-приложение и в MAX?
Коротко: если часть клиентов в MAX, туда можно выпустить то же веб-приложение, но только как часть чат-бота и после проверки организации. Логику лучше сделать общей, а подключение к двум мессенджерам - отдельным.
В MAX мини-приложения работают только внутри чат-бота. Создать бота могут юрлица, ИП и самозанятые из России, а перед публикацией бот проходит модерацию до 48 часов по рабочим дням. Проверка данных пользователя в MAX устроена по той же схеме, что и в Telegram: подписью на сервере.
Для обоих мессенджеров попросите подрядчика сделать общее веб-приложение и серверную часть, а подключение к Telegram и MAX - двумя отдельными небольшими модулями, чтобы второй мессенджер не превратился во второй проект.
Сколько стоит и сколько делается мини-приложение?
Коротко: на конструкторе можно начать с подписки от 1 390 ₽ в месяц, если хватает его шаблонов. Простая версия на заказ, по заявленным ценам студии из поиска на 30 сентября 2026 года, стоит примерно от 500 тысяч рублей и делается 4-8 недель. Цена растёт с числом экранов, оплатой, интеграциями и личным кабинетом.
Чтобы было с чем сравнивать, мы посмотрели страницы из первой выдачи. Конструктор мини-приложений для магазина заявляет тариф от 1 390 ₽ в месяц: подходит, если товаров немного и хватает готового шаблона. Одна из студий оценивает заказную разработку в России от 500 000 ₽ за простую версию с 2-3 экранами до 2-4 млн ₽ за решение средней сложности, срок простой версии - 4-8 недель. Это заявленные цены продавцов, о средней цене по рынку они не говорят.
От чего зависит цена: сколько экранов и сценариев, нужна ли оплата, откуда берётся каталог и расписание, нужен ли личный кабинет и второй мессенджер. Точную сумму для вашей задачи даст смета по заданию из следующего раздела.
Что записать в задании на мини-приложение?
Коротко: какие задачи клиент решает в приложении, а какие остаются в боте, откуда брать каталог и расписание, как принимать оплату, как проверяется пользователь, на каких устройствах тестировать и нужен ли MAX.
- Сценарии клиента: что он делает в приложении от открытия до оплаты или записи.
- Что остаётся в боте: уведомления, напоминания, ответы на вопросы.
- Откуда данные: каталог, цены, остатки, расписание. Есть ли у вашей системы программный интерфейс для обмена.
- Оплата: провайдер, какие товары цифровые, возвраты, чеки по 54-ФЗ.
- Проверка пользователя на сервере по подписи Telegram и политика обработки персональных данных, которую требуют и Telegram, и MAX.
- Что сохраняется при закрытии приложения: корзина, незаконченная запись.
- Устройства для приёмки: iPhone, Android, компьютер, старые версии Telegram.
- Нужен ли MAX и кто в компании пройдёт проверку организации.
Мы начинаем с полного разбора требований: у каждого сценария есть критерий приёмки, а противоречия выносим на решение заказчика. Поэтому цену и срок называем до первой строки кода. Опишите задачу, пришлём состав работ и смету за 24 часа. Если окажется, что хватит бота, скажем и это. Как договориться о цене разработки, мы разбирали в статье про фиксированную цену и почасовую оплату.
Источники
- Telegram: мини-приложения, платежи, платежи в звёздах, полноэкранные мини-приложения
- MAX для разработчиков: мини-приложения, проверка данных, создание бота
Если клиентам тесно в кнопках бота, опишите задачу: пришлём состав работ и смету за 24 часа.