Главная поправка: Mini App — не «бот с дизайном»

Telegram-бот — это программный аккаунт, который получает события, отправляет сообщения, показывает кнопки и запускает действия. Mini App — веб-интерфейс, который открывается внутри Telegram: каталог, календарь, карта, личный кабинет или сложная форма.

Пользователь может запускать Mini App из кнопки, меню или профиля бота, а также по прямой ссылке. После действия интерфейс отправляет данные на сервер, а бот может продолжить сценарий сообщением или уведомлением.

Telegram Web App и Mini App — названия одной линии технологии: в старых материалах и коде часто встречается Web App, а актуальная документация Telegram использует название Mini Apps.

Правильный вопрос не «бот или Mini App?»

Спросите: где пользователю удобнее выполнить каждую часть задачи — в диалоге, в интерфейсе или на открытом сайте.

Сравнение по задачам

Какой формат удобнее для разных сценариев
ЗадачаБотMini AppСвязка
Заявка из 3–5 шаговудобночасто лишнееобычно не нужно
Ответы и передача менеджеруудобноне основная рольудобно
Каталог, фото, фильтрыбыстро становится громоздкоудобноудобно
Корзина и оформлениевозможно, но тесноудобноподходит для связки
Календарь, карта, сложная форманеудобноудобноудобно
Статусы и напоминаниясильная сторонане нужен открытый экрансильная сторона
Публичные страницы из поискане заменяет сайтне заменяет сайтнужен сайт
На телефоне таблица прокручивается по горизонтали →

Как выбрать за пять вопросов

  1. Нужно ли что-то видеть и сравнивать? Фото, карточки, фильтры, расписание и карта — аргументы в пользу Mini App.
  2. Можно ли пройти сценарий последовательно? Если пользователю достаточно ответить на несколько вопросов, бот обычно проще.
  3. Нужны ли возвратные уведомления? Статусы, напоминания и поддержка удобнее остаются в боте, даже если заказ оформляется в Mini App.
  4. Откуда приходит аудитория? Telegram-канал, QR-код и база клиентов подходят для Telegram-сценария. Если нужны органический поиск и открытые индексируемые страницы, нужен сайт; рекламный трафик можно вести туда, где пользователь завершает нужное действие.
  5. Где хранятся данные? Определите, где хранится основная версия товаров, заказов и статусов — то есть источник истины. Бот, Mini App и сайт не должны вести независимые копии без правил синхронизации.

Когда достаточно обычного бота

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

Типовые задачи:

  • запись на услугу с несколькими последовательными вопросами;
  • приём заявки и сбор контакта;
  • FAQ с передачей сложного вопроса человеку;
  • проверка статуса заказа или заявки;
  • напоминания, служебные уведомления и отчёты.

Бот перестаёт быть удобным, когда кнопок и веток становится столько, что пользователь теряет контекст и не может быстро вернуться к выбранному товару или шагу.

Когда нужен Mini App

Mini App выбирают не ради «современного вида», а когда задача требует интерфейса. Например, пользователю нужно:

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

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

Как пользователь открывает Mini App

У Mini App несколько точек входа, и от них зависит сценарий. Документация Telegram перечисляет такие способы:

  • кнопка клавиатуры бота: такой Mini App может вернуть данные боту служебным сообщением;
  • кнопка под сообщением бота;
  • кнопка меню бота рядом с полем ввода;
  • инлайн-режим: Mini App открывается из любого чата через бота;
  • прямая ссылка на Mini App в любом чате;
  • меню вложений: сейчас оно доступно только крупным рекламодателям Telegram Ad Platform, остальным ботам — в тестовой среде;
  • кнопка запуска в профиле бота для его основного Mini App.

Начиная с Bot API 8.0 Mini App может открываться на весь экран, предлагать добавить ярлык на главный экран телефона и запрашивать геолокацию. В Bot API 9.0 появились постоянное локальное хранилище DeviceStorage и защищённое хранилище SecureStorage. Для каталога и повторных заказов это удобно, но сервер они не заменяют: заказы, цены и права всё равно хранятся и проверяются в серверной части.

Когда бот и Mini App работают вместе

Для магазина, сервиса бронирования или программы лояльности роли удобно разделить:

  • БотВход в сценарий, вопросы, поддержка, статусы и уведомления.
  • Mini AppКаталог, карточки, фильтры, корзина, календарь и личный кабинет.
  • Сервер / APIПроверка пользователя, цены, права, бизнес-правила и интеграции.
  • ДанныеОсновная версия товаров, заказов и статусов должна быть определена явно; конкретная схема хранения зависит от архитектуры.
Ботдиалог, статусы Mini Appинтерфейс Сервер / APIAPI и правила Базазаказы, клиенты CRM / 1Сучёт, статусы
Один из вариантов архитектуры. Интерфейсы могут быть разными, но правила заказа и синхронизации данных должны быть согласованы.

Что Mini App даёт — и чего не даёт

Mini App открывается внутри Telegram, получает тему интерфейса и данные запуска. Это упрощает вход в интерфейс, но не создаёт автоматически каталог, безопасность, поддержку или трафик.

Не появляется автоматически

Каталог. Нужны источник данных, поиск, категории, изображения и админский процесс обновления.

Безопасность. Цены, права и заказ проверяются на сервере; данным из браузерного интерфейса нельзя доверять.

Поддержка. Нужны понятные ошибки, связь с человеком и процесс разбора проблемного заказа.

Трафик. Сам факт запуска Mini App не приводит новых клиентов.

Авторизация и безопасность

Telegram передаёт Mini App данные запуска в поле initData. Сервер должен проверить их подлинность до авторизации пользователя. Объект initDataUnsafe и любые значения, присланные интерфейсом, нельзя использовать как доверенный источник.

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

Оплата внутри Telegram

Оплату можно встроить, но сначала нужно определить тип товара:

  • Физические товары и услуги. Используется Telegram Payments с поддерживаемым платёжным провайдером; доступность зависит от страны и условий провайдера.
  • Цифровые товары и услуги внутри Telegram. Оплата должна проходить в Telegram Stars.

Даже когда оплата технически возможна, она не всегда нужна в первом релизе. Иногда достаточно сформировать заказ, передать его менеджеру и подключить оплату после проверки основного сценария.

Технические правила сверены с официальной документацией Telegram: Mini Apps, оплата физических товаров и услуг и оплата цифровых товаров.

Telegram хорошо обслуживает аудиторию, которая уже пришла по ссылке, QR-коду, из канала или базы клиентов. Но внутренний каталог Mini App не стоит считать заменой открытым страницам сайта, когда бизнесу нужны поиск, SEO, рекламные посадочные страницы, публичные условия и ссылки, доступные без мессенджера.

Практичная связка выглядит так: сайт привлекает и объясняет, Mini App помогает выбрать и оформить, бот возвращает статусы и поддерживает клиента. Подробнее — в сравнении Telegram-решения с сайтом.

Что включать в первый релиз

BOT MVP

Короткий сценарий

Команды и кнопки, сбор заявки, уведомление владельцу, подтверждение клиенту, передача человеку и журнал ошибок.

MINI APP MVP

Один ключевой путь

Главный экран, каталог или форма, карточка, действие, серверная проверка, состояние загрузки и понятная ошибка.

СВЯЗКА MVP

Общие данные

Mini App и бот используют согласованные данные: один интерфейс оформляет действие, другой сообщает результат или статус. Где хранится заказ и как компоненты обмениваются им, зависит от архитектуры.

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

Пять ошибок при выборе формата

  • Каталог в бесконечной цепочке кнопок. Пользователь теряет выбранный товар и не видит варианты рядом.
  • Mini App ради формы из трёх полей. Интерфейс увеличивает стоимость, но не делает задачу удобнее.
  • Несогласованные данные у бота и Mini App. Если каждый интерфейс хранит свою версию заказа без правил синхронизации, состав и статус могут разойтись.
  • Доверие данным из интерфейса. Цена, пользователь и права должны проверяться на сервере.
  • Отсутствие человека в сложном сценарии. Клиенту нужен понятный выход из автоматизации, если вопрос не решён.
Пример

В GlowDecor, магазине внутри Telegram, Mini App отвечает за каталог, категории и корзину, а бот — за поддержку с анонимной переадресацией. Пользователь пишет боту. Сообщение получает владелец, при этом личный контакт владельца пользователю не показывается. Это пример разделения ролей интерфейса и бота.

Что подготовить для оценки

Короткий бриф без технического задания

  • Откуда пользователь приходит и какое одно действие должен завершить.
  • Нужен ли визуальный выбор: каталог, календарь, карта, характеристики.
  • Где сейчас хранятся товары, цены, клиенты и заказы.
  • Какие уведомления получает клиент, менеджер и владелец.
  • Нужны ли оплата, доставка, CRM, 1С или другая интеграция.
  • Кто редактирует каталог и обрабатывает исключения.

Частые вопросы

Можно ли начать с обычного бота и потом добавить Mini App?

Да. Это разумный путь, если сначала нужен короткий сценарий заявок или уведомлений, а каталог или личный кабинет появятся позже. Лучше заранее отделить бизнес-логику от сообщений бота и определить, где хранится основная версия данных.

Mini App может работать без установки отдельного приложения?

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

Mini App всегда дороже обычного бота?

Обычно интерфейс Mini App требует больше работы, чем линейный сценарий из сообщений и кнопок. Но стоимость определяет не название формата, а каталог, роли пользователей, интеграции, оплата, админка и правила обработки заказов.

Можно ли принимать оплату внутри Telegram?

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

Нужен ли сайт, если есть Mini App?

Зависит от источника клиентов. Mini App удобен для аудитории, которая уже пришла в Telegram. Если важны органический поиск, открытый каталог и ссылки, доступные без мессенджера, нужен сайт или другие публичные веб-страницы.

Могут ли сайт, бот и Mini App работать с одной базой?

Да. Общая база — один из вариантов, но не обязательное условие. Важно, чтобы товары, заказы и статусы имели согласованный источник и правила синхронизации; конкретная схема может использовать одну базу или несколько систем.

Как безопасно получать данные пользователя из Mini App?

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

Что лучше для интернет-магазина: бот или Mini App?

Для каталога с фотографиями, фильтрами, карточками и корзиной удобнее Mini App. Бот удобен для входа, поддержки, подтверждений, статусов и уведомлений. Связка нужна, если эти сценарии используются вместе; данные между ними должны синхронизироваться по согласованным правилам.

Telegram Web App и Mini App — это одно и то же?

В большинстве практических задач — да. Название Web App встречается в старых статьях, методах API и коде, а в актуальной документации Telegram продукт называется Mini Apps. Речь идёт о веб-интерфейсе, который открывается внутри Telegram.

Можно ли запустить Mini App без отдельного диалога с ботом?

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

Можно ли открыть Mini App на весь экран или добавить на главный экран телефона?

Да. Начиная с Bot API 8.0 Mini App поддерживает полноэкранный режим и может предложить добавить ярлык на главный экран устройства. Для каталога и повторных заказов это удобно, а для формы из трёх полей обычно лишнее.

Не уверены, что выбрать: Telegram-бот или Mini App?

Опишите путь клиента и источник данных. Скажу, где достаточно бота, где нужен Mini App, а где задачу лучше начать с сайта.

Обсудить Telegram-задачу →