Разработка Telegram Mini App в Атырау

Mini App — это веб-приложение, которое открывается прямо внутри Telegram: по кнопке в боте, по кнопке в меню чата или по прямой ссылке вида t.me/имя_бота/app. Для клиента это выглядит как обычное приложение — каталог, карточки, корзина, форма заказа, — но скачивать ничего не нужно: ни установки из App Store и Google Play, ни обновлений, ни места в памяти телефона.

Интерфейс собирается на Telegram Web Apps SDK. SDK отдаёт цветовую тему клиента (приложение автоматически выглядит светлым или тёмным, как у пользователя), главную кнопку внизу экрана, тактильный отклик, обработку кнопки «назад» и, главное, подписанные данные пользователя. Авторизация идёт по аккаунту Telegram: сервер получает строку initData, проверяет её подпись секретом бота и понимает, кто зашёл. Ни регистрации, ни паролей, ни SMS-кода с подтверждением — человек уже авторизован тем фактом, что открыл приложение внутри мессенджера.

Уведомления отправляет бот — обычным сообщением в чат. Это не push нативного приложения: разрешение спрашивать не нужно, сообщение приходит в общий список чатов и почти всегда прочитывается. Обратная сторона — рассылать без повода нельзя, за жалобы бота ограничивают. Подробнее о самой технологии и её возможностях мы собрали на странице разработки Telegram Mini App.

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

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

Из интеграций регулярно всплывают связка с 1С или другой учётной системой по сотрудникам и объектам, справочник структуры компании для маршрутов согласования, календарь вахт и заездов, а также выгрузка подписанных заявок в общий документооборот. Двуязычность русский и английский нужна почти всегда, потому что часть отчётности уходит оператору проекта. Оплаты в таких проектах обычно нет вовсе — вместо неё роли и права.

Живой сценарий. Сотрудник открывает мини-приложение и подаёт заявку на справку или на транспорт к объекту: выбирает тип, дату, объект из списка, добавляет комментарий. Руководитель получает от бота карточку с кнопками, согласовывает в один тап, заявка меняет статус, а кадровик видит очередь в общем списке с фильтром по подразделению. Бизнес получает журнал всех обращений с датами и авторами — то, чего в чатах никогда не было.

Техническая особенность, которую обсуждаем до старта: мини-приложение подтверждает личность через подписанный Telegram набор initData, то есть надёжно отвечает на вопрос, какой это аккаунт Telegram, но не на вопрос, какой это сотрудник. Связку с табельным номером делают отдельно — одноразовым кодом от кадровой службы или подтверждением руководителя. Без этого шага любой человек со ссылкой окажется внутри корпоративного контура.

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

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

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

Telegram Stars — третий, отдельный механизм. Это внутренняя валюта Telegram, и ею оплачивают только цифровые товары и услуги: доступ к платному разделу, подписку, снятие лимита, виртуальный товар. За физический товар, еду и доставку Stars принимать нельзя — правила площадки этого не допускают.

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

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

Срок для типового проекта — 3–8 недель. Нижняя граница реальна для записи на услугу или небольшого меню, верхняя — для каталога с фильтрами, интеграцией остатков и двумя способами оплаты. Стоимость начинается от 700 000 ₸ и зависит в основном от трёх вещей: размера каталога, количества интеграций с внешними системами и того, нужна ли собственная админка или данные тянутся из существующей учётной системы. В сравнении с полноценным нативным приложением затраты заметно ниже — нет двух отдельных платформ, нет ревью в сторах, нет цикла обновлений.

Честные ограничения формата стоит знать до старта. Mini App не получает часть системных возможностей телефона: нет фоновой работы, нет постоянного отслеживания геопозиции, ограничен доступ к Bluetooth и датчикам, нельзя рассчитывать на серьёзную работу без сети. Тяжёлая графика, 3D, обработка видео на устройстве — тоже территория нативного приложения.

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