Telegram Mini App для ресторана — мини-приложение для кафе внутри мессенджера

Чем Mini App отличается от обычного бота

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

Витрина, меню с фото и корзина

Разница с обычным ботом принципиальная. Бот — это диалог: сообщения, кнопки под ними, линейный сценарий. Он отлично работает там, где действий немного и они предсказуемы: узнать адрес, забронировать стол, повторить прошлый заказ. Как только нужно показать сорок позиций с фото, дать фильтры, модификаторы и корзину, диалог начинает мешать — гость тонет в ленте сообщений и теряет, что он уже выбрал. Mini App даёт нормальный интерфейс: категории сверху, карточки с фото, корзина, которая всегда на экране. Практическое правило простое. Если заведение с залом и сценарии короткие — хватает телеграм-бота для ресторана. Если это витрина и регулярные покупки — нужен Mini App, а бот остаётся каналом уведомлений рядом с ним.

Личный кабинет, бонусы и QR на кассе

Витрина — центральная часть. Карточка блюда содержит крупное фото, название, состав, вес, цену, при необходимости КБЖУ и отметки про аллергены. Модификаторы настраиваются под кухню: размер порции, степень прожарки, тип молока в кофе, дополнительный соус, убрать лук. Каждый модификатор может менять цену и должен корректно доезжать до кухни, поэтому мы согласовываем их структуру с вашей кассой, а не придумываем отдельно. Стоп-лист приходит из iiko или r_keeper: закончившиеся позиции гаснут сами, без ручной правки меню в пятницу вечером. Для сети точек витрина зависит от выбранного заведения — меню и цены могут отличаться по адресам. Всё содержимое, включая фото и порядок категорий, редактируется в админке вашими сотрудниками.

Ограничения Mini App и когда нужно приложение

Корзина и оформление. Гость набирает заказ, видит сумму, применяет бонусы или промокод и выбирает сценарий получения: доставка, самовывоз или заказ за столом по номеру стола. Для доставки подтягиваются сохранённые адреса и проверяется зона, для самовывоза — ближайшая точка и время готовности. Оплата: Kaspi Pay и банковские карты внутри того же экрана, без переходов в сторонние окна и без ручного перевода по номеру. Оплаченный заказ уходит на кассу как обычный документ и печатается на кухне. Если что-то пошло не так — позиция попала в стоп-лист, гость отменил, курьер не доехал — сценарии возврата описываются заранее и выполняются из админки, а не решаются каждый раз перепиской между администратором и бухгалтерией.

Личный кабинет — то, чего у простого бота по сути нет. Гость видит историю заказов, повторяет любой из них в два касания, хранит адреса и любимые позиции, следит за балансом бонусов. Программа лояльности живёт здесь же: кэшбэк с покупок, уровни, персональные предложения, QR-код для предъявления на кассе, если гость пришёл в зал. Так офлайн-визиты и онлайн-заказы собираются в один профиль, и вы видите гостя целиком, а не двумя несвязанными кусками. Похожую механику мы делали в приложении Damdala для сети готовой еды: кэшбэк, бонусы и QR на кассе. В Mini App она работает так же, только без установки из сторов — точка входа находится в мессенджере, которым человек и так пользуется каждый день.

Контентом Mini App нужно управлять, иначе он мертвеет за месяц. Админка закрывает это: меню, цены, фото, категории, баннеры на главной, сторис с акциями, правила начисления бонусов, тексты и условия доставки. Отдельный блок — коммуникации. Уведомления приходят сообщениями от бота: статус заказа, начисленные бонусы, напоминание о брошенной корзине, анонс сезонного меню. Здесь та же честная оговорка, что и в любом канале: массовые рассылки выгорают. Если раз в неделю всей базе уходит скидка, аудитория привыкает ждать скидку и перестаёт реагировать на всё остальное. Работают сегменты и триггеры по событию — заказ, пауза, день рождения, первая покупка. Мы закладываем сегментацию сразу, потому что достроить её потом дороже.

Ограничения Mini App называем прямо, чтобы решение было осознанным. Приложение живёт внутри Telegram: у него нет своей иконки на домашнем экране по умолчанию (ярлык добавляется вручную и делают это немногие), нет страницы в App Store и Google Play и нет системных push-уведомлений — вместо них сообщения бота, которые попадают в общий список чатов. Офлайн-режима нет, при плохой связи экран будет грузиться. Доступ к нативным возможностям устройства ограничен рамками платформы. Если ваш сценарий требует push, работы без интернета, глубокой интеграции с телефоном или присутствия в сторах как канала привлечения, нужно мобильное приложение для ресторана. Частая связка: Mini App как быстрый вход для всех и приложение для постоянных гостей.

Стек и порядок работы. Клиентская часть на Flutter, бэкенд на Node.js, данные в PostgreSQL, интеграции с iiko и r_keeper, оплата через Kaspi Pay и карты. Один бэкенд обслуживает Mini App, бота и мобильное приложение, поэтому меню, цены и бонусы не расходятся между каналами и не требуют тройного ведения. Для форматов с коротким чеком и частыми визитами логика отличается — там больше про скорость повтора и стакан кофе в одно касание, это ближе к мобильному приложению для кофейни. Если основной объём у вас курьерский, начинать имеет смысл с телеграм-бота для доставки еды. Стоимость и сроки рассчитываем после брифа, когда понятны сценарии, касса и объём админки.