Как создать Telegram Mini App
Разбираем весь путь: как зарегистрировать приложение у BotFather, что такое initData и почему её обязательно проверять на сервере, как подключить оплату Kaspi и Telegram Stars, что тестировать перед запуском. Отдельно — честный расчёт, когда дешевле сделать самому, а когда заказать под ключ. Разработка в A-LUX от 700 000 ₸, срок 4-6 недель.
- 7 шагов от идеи до работающего приложения в Telegram
- Что можно сделать самому бесплатно, а что придётся заказывать
- Типичные ошибки, из-за которых заказы теряются после оплаты
Чтобы создать Telegram Mini App, нужно: зарегистрировать бота у BotFather и привязать к нему веб-приложение, сверстать интерфейс на Telegram Web Apps SDK, поднять серверную часть с проверкой подписи initData, подключить оплату через казахстанский эквайринг, Kaspi или Telegram Stars, протестировать на iOS и Android и опубликовать по ссылке вида t.me/имя_бота/app. Простой прототип разработчик соберёт сам, коммерческое приложение с каталогом и оплатой в агентстве A-LUX стоит от 700 000 ₸ и занимает 4-6 недель.
7 шагов: от идеи до работающего приложения
Порядок, в котором Mini App собирается на практике. Пропуск любого шага всплывает уже после запуска.
1. Сценарий и карта экранов
До дизайна фиксируем, что человек делает в приложении и чем это заканчивается: заказ, запись, оплата. Обычно хватает трёх-пяти экранов. Лишние экраны — самая частая причина, по которой бюджет вырастает вдвое.
2. Регистрация у BotFather
Создаём бота, получаем токен, командой /newapp привязываем веб-приложение и получаем прямую ссылку t.me/имя_бота/app. Здесь же настраиваются кнопка меню и описание. Шаг бесплатный и занимает минуты.
3. Интерфейс на Web Apps SDK
Вёрстка на React или другом фронтенде плюс подключение SDK: тема оформления клиента, главная кнопка внизу экрана, обработка «назад», тактильный отклик. Приложение должно одинаково выглядеть в светлой и тёмной теме.
4. Сервер и проверка initData
Telegram передаёт подписанные данные пользователя. Сервер обязан проверить подпись секретом бота — без этого кто угодно подделает запрос от чужого имени. Это главная точка безопасности Mini App.
5. Оплата
Карты через казахстанский эквайринг, Kaspi для местной аудитории, Telegram Stars для цифровых товаров. Статус «оплачено» ставится по серверному колбэку банка, а не по возврату пользователя на экран.
6. Тестирование на устройствах
Проверяем на реальных iPhone и Android: клавиатура перекрывает поля, кнопка «назад» ведёт себя иначе, тёмная тема ломает контраст. В десктопном Telegram всё это не видно.
7. Запуск и первые метрики
Публикуем ссылку, ставим кнопку в меню бота, подключаем аналитику. Смотрим, где люди отваливаются, и правим первые две недели — это нормальная часть запуска, а не переделка.
Что дальше
Приложение обновляется мгновенно и для всех сразу: не нужно ждать ревью сторов и надеяться, что пользователь нажмёт «обновить».
Сделать самому или заказать
Честное сравнение: в одних задачах агентство не нужно, в других самостоятельная сборка обходится дороже.
Своими силами — когда есть разработчик
Если в команде есть фронтендер и бэкендер, прототип на пару экранов собирается за неделю-две. Регистрация у BotFather и SDK бесплатны, платить нужно только за хостинг и домен.
Конструктор — для простой витрины
Готовые платформы закрывают базовый магазин с оплатой за абонентскую плату. Ограничения начинаются там, где нужна своя логика, интеграция с 1С или нестандартная корзина. Подробный разбор — на странице конструктор или разработка.
Агентство — когда есть деньги в обороте
Имеет смысл, когда приложение принимает оплату и связано с учётной системой. Цена ошибки здесь — потерянные заказы и расхождения в остатках, поэтому нужны тестирование, поддержка и гарантия.
Сколько это стоит
Самостоятельно — время команды плюс хостинг. Конструктор — абонентская плата и потолок по возможностям. Разработка под ключ в A-LUX — от 700 000 ₸ с гарантией 12 месяцев и передачей исходного кода.
Ошибки, из-за которых теряются заказы
Пять вещей, которые мы стабильно находим при аудите чужих Mini App.
Подпись initData не проверяется
Сервер верит данным, пришедшим с клиента. В этом случае подделать чужой аккаунт и оформить заказ от его имени может кто угодно. Проверка подписи — обязательна.
Оплата считается по редиректу
Заказ помечают оплаченным, когда пользователь вернулся на экран «спасибо». Пропал интернет в лифте — деньги ушли, заказ остался неоплаченным. Правильно ловить серверный колбэк банка.
Stars за физический товар
Telegram Stars предназначены только для цифровых товаров и услуг. Попытка продавать за них еду или вещи ведёт к ограничениям бота.
Тестирование только на десктопе
В десктопном Telegram не видно, как клавиатура перекрывает поле ввода и как ведёт себя кнопка «назад» на iOS. Проверять нужно на реальных телефонах.
Как это делает A-LUX
Процесс, по которому мы запускаем Mini App клиентам в Казахстане.
Брифинг и смета
Разбираем сценарий, считаем экраны и интеграции, называем вилку цены и срок. Если задача решается ботом дешевле — говорим об этом сразу.
Дизайн под обе темы
Макеты экранов в светлой и тёмной теме Telegram, с учётом главной кнопки и жестов. Согласование до начала разработки.
Разработка и интеграции
Фронтенд на React, серверная часть, админка, подключение Kaspi, эквайринга, CRM и 1С. Демонстрируем работающие экраны по ходу, а не в конце.
Запуск и поддержка
Тестирование на устройствах, публикация, обучение вашей команды работе с админкой. Гарантия 12 месяцев, исходный код передаём заказчику.
Частые вопросы
Ответы на вопросы клиентов A-LUX перед заказом.
Можно ли создать Telegram Mini App бесплатно
Регистрация приложения у BotFather и сам Telegram Web Apps SDK бесплатны. Платить придётся за хостинг, домен и работу разработчика. Полностью бесплатно получится только прототип, который вы собираете сами: коммерческое приложение с оплатой и интеграциями требует серверной части и поддержки.
Сколько стоит создать мини-приложение в Телеграм
В A-LUX разработка под ключ стоит от 700 000 ₸. Цена зависит от количества экранов, размера каталога и числа интеграций с CRM, 1С и платёжными сервисами. Простой бот для заявок обойдётся дешевле — от 250 000 ₸.
Сколько времени занимает создание Mini App
4-6 недель для типового проекта: две недели на структуру и дизайн, дальше разработка, платежи и тестирование. Небольшая запись на услуги запускается быстрее, магазин с фильтрами и интеграцией остатков — дольше.
Нужен ли отдельный бот для Mini App
Да, приложение всегда привязано к боту: именно он даёт кнопку запуска и отправляет уведомления о заказах и статусах. Если бот у вас уже есть, Mini App подключается к нему — заводить второй не нужно.
На чём разрабатывают Telegram Mini App
Фронтенд — обычно React или другой веб-фреймворк плюс Telegram Web Apps SDK, серверная часть — на любом стеке, который умеет проверять подпись initData. Мы работаем на React и TypeScript, исходный код после сдачи передаём заказчику.
Что нужно от заказчика на старте
Описание сценария, список товаров или услуг, доступы к учётной системе, если нужна интеграция, и контакт человека, который принимает решения. Всё остальное — регистрацию бота, хостинг, домен и подключение оплаты — берём на себя.
Другие digital-услуги A-LUX в Казахстане
A-LUX — full-service digital агентство. Сайты, приложения, интернет-магазины, AI, брендинг и SEO под ключ по всему Казахстану.
Создать Telegram Mini App под ключ
Заполните форму — менеджер свяжется в течение 15 минут. Бесплатная консультация и расчёт стоимости.
Все услуги A-LUX по Telegram-ботам и Mini Apps
Полный цикл разработки в Telegram: боты, магазины, приём оплаты, интеграция с CRM, Mini Apps и ИИ — под ключ по всему Казахстану.
Другие IT-услуги для бизнеса в Алматы
Запускаем под ключ за 4-12 недель. 19 лет в Казахстане, 27 штатных специалистов.