Журнал
Telegram mini app

Как создать мини-приложение в Telegram: гайд

Как создать мини-приложение в Telegram (Mini App) по шагам: настройка в BotFather, путь с кодом и без кода, и как запустить магазин в Mini App без разработчика.

Чтобы создать мини-приложение в Telegram, нужны три вещи: Telegram-бот, веб-приложение по публичному адресу и связка между ними, которую настраивают в @BotFather. Когда всё связано, нажатие кнопки в боте открывает ваше приложение прямо внутри Telegram: пользователь уже узнан, скачивать ничего не нужно. В этом гайде оба пути: собрать веб-приложение самому, шаг за шагом, и создать магазин в Mini App на no-code конструкторе, где приложение, хостинг и оплата уже готовы.

Быстрые ответы (2026)#

  • С чего начать создание Telegram Mini App? Создайте бота в @BotFather командой /newbot, разместите веб-приложение по HTTPS-адресу и привяжите этот адрес к боту как кнопку меню или как основное мини-приложение (Main Mini App). Подключите на странице скрипт Telegram telegram-web-app.js, чтобы приложение получало пользователя, тему и главную кнопку.
  • Сколько стоит разработка Telegram Mini App? Telegram ничего не берёт за бота и за подключение мини-приложения. Своя разработка стоит столько, сколько стоят программирование, хостинг и поддержка под вашу задачу. No-code конструктор заменяет это тарифом: в Tiny Shops — от $0 в месяц и 7% с заказа после первых $100 продаж.
  • Какие требования к хостингу у Telegram Mini App? Публичный HTTPS-адрес, который Telegram загружает при каждом открытии, и сервер, который проверяет подпись initData (HMAC-SHA-256 с ключом, полученным из токена бота), прежде чем доверять пользователю. Фронтенд можно держать на любом статическом хостинге; проверка должна работать на вашем сервере.
  • Как подключить оплату в Telegram Mini App? Цифровые товары и услуги оплачиваются только в Telegram Stars (валюта XTR). Физические товары можно оплачивать через платёжных провайдеров по Payments API Telegram или через внешнюю оплату, например Stripe. По условиям Telegram для разработчиков продавец получает около $0,013 за Star в виде вознаграждения.
  • Где официальная документация Telegram Mini Apps? Mini Apps: core.telegram.org/bots/webapps. Оплата в Stars: core.telegram.org/bots/payments-stars. Bot API: core.telegram.org/bots/api.
  • Какие лучшие практики для Telegram Mini App? Проверяйте initData на сервере, повторяйте цвета темы Telegram у пользователя, выносите главное действие на главную кнопку Telegram, делайте первый экран быстрым на мобильном интернете и тестируйте внутри Telegram на телефоне, а не только в браузере на компьютере.
  • Какие есть примеры Telegram Mini App? Интернет-магазины с каталогом и корзиной (демо самого Telegram — @DurgerKingBot), запись в салоны и на занятия, игры вроде Hamster Kombat, криптокошелёк @wallet, курсы и подписки за Stars.

Если вы ещё решаете, нужно ли мини-приложение вашему бизнесу и сколько оно стоит, начните с Telegram Mini Apps для бизнеса. Здесь речь о создании.

Что такое Telegram Mini App#

Telegram Mini App — это веб-страница (HTML, CSS и JavaScript), которую Telegram открывает в своём окне внутри приложения, а не в браузере. Telegram передаёт странице данные пользователя, цветовую тему и язык и даёт нативные элементы: главную кнопку, виброотклик. Каждое мини-приложение привязано к боту, и через бота его находят.

В документации Telegram перечислены семь способов открыть Mini App:

  • кнопка меню рядом с полем ввода в чате с ботом;
  • кнопка клавиатуры или inline-кнопка под сообщением бота;
  • Main Mini App — открывается из профиля бота и по ссылке вида t.me/yourbot?startapp;
  • прямая ссылка вида t.me/yourbot/appname;
  • inline-режим и меню вложений.

Магазину обычно хватает двух: кнопки меню в боте и ссылок, которые открывают витрину прямо из поста в канале или из шапки профиля.

Два способа создать мини-приложение в Telegram#

Писать самомуNo-code конструктор
Что вы делаетеВсё приложение: экраны, корзину, админку, бэкендТолько содержимое: товары, цены, оформление
Какие навыки нужныФронтенд, бэкенд, Telegram Bot APIНикаких
ХостингВаш: сами держите и оплачиваетеВходит
Проверка пользователяВы проверяете данные Telegram на своём сервереУже сделана
ОплатаВы интегрируете каждого провайдераПодключается в панели
До первого заказаНедели, зависит от объёмаВ тот же день
Кому подходитТем, кто делает что-то новое: игру, свой сервисМагазину, каталогу, витрине

Если вам нужен магазин, конструктор избавит от того, чтобы заново писать каталог, корзину и оформление заказа, которые уже существуют. Если идея новая, ваш путь — код, ниже.

Как создать Telegram Mini App с кодом#

  1. Создайте бота. Откройте @BotFather, отправьте /newbot, задайте имя и юзернейм на bot и скопируйте токен. Держите токен в секрете: у кого токен, тот управляет ботом. Подробно — в гайде как создать бота в Telegram.
  2. Сделайте веб-приложение. Подойдёт любой фронтенд-стек: Mini App — это веб-страница. Подключите в <head> скрипт Telegram telegram-web-app.js, чтобы код видел window.Telegram.WebApp: пользователя, цвета темы, главную кнопку.
  3. Выложите его в сеть. Разверните приложение на сервере или статическом хостинге, чтобы у него был публичный адрес. Telegram загружает его оттуда при каждом открытии.
  4. Привяжите к боту. В @BotFather задайте кнопку меню (/setmenubutton или Bot Settings → Menu Button) с адресом приложения. Чтобы появились Main Mini App и ссылки t.me/yourbot?startapp, зайдите в /mybots → ваш бот → Bot Settings → Configure Mini App → Enable Mini App.
  5. Проверяйте пользователя на сервере. Telegram передаёт приложению initData с хешем. Прежде чем доверять данным, пересчитайте подпись HMAC-SHA-256 на сервере ключом, полученным из токена бота, как описано в документации. ID пользователя, пришедшему из браузера без такой проверки, верить нельзя.
  6. Добавьте оплату. Правила Telegram делят товары на два вида. Цифровые товары и услуги оплачиваются только в Telegram Stars (валюта XTR). Для физических товаров и услуг можно использовать другие валюты и платёжных провайдеров.
  7. Проверьте в Telegram. Откройте бота с телефона, нажмите кнопку меню и пройдите весь сценарий, включая оплату.

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

Как создать магазин в Telegram Mini App на Tiny Shops#

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

  1. Начните на tiny-shops.com. Первый вопрос — Как называется магазин? Это название видят покупатели, и с него начинается адрес магазина.
  2. Выберите формат. В шаге Где будете продавать? выберите Витрина мини-приложения: каталог, корзина и оплата картой внутри Telegram. Второй вариант, В чате Telegram, — для продаж в переписке без витрины.
  3. Выберите оплату. В шаге Как принимать оплату?: Вручную (вы сами отмечаете заказы оплаченными), Звёзды, Картой (Stripe подключается после запуска) или Локальные платежи (Индонезия, Филиппины, Малайзия). Потом это можно поменять.
  4. Подключите бота. Нажмите Создать за меня — Telegram создаст бота на вашем аккаунте, без BotFather и токена. Или У меня уже есть — и вставьте токен из @BotFather.
  5. Запустите. Нажмите Создать магазин и открыть панель. Tiny Shops подключит бота и поставит ему кнопку меню Открыть магазин, которая открывает витрину.
  6. Добавьте товары. Товары → Добавить товар: фото, название, описание и цена. Товары можно подтягивать и из Google Таблицы.
  7. Включите Main Mini App. Это единственный шаг, который делается только в BotFather. На странице Telegram-бот есть точные шаги и ссылка, которую нужно вставить: откройте @BotFather, отправьте /mybots, выберите бота, затем Bot Settings → Configure Mini App → Enable Mini App. После этого ссылки на товары в постах открывают магазин сразу, а не чат с ботом.
  8. Подключите онлайн-оплату. Stripe (карты, Apple Pay и Google Pay внутри Mini App), Telegram Stars, TON, Xendit и другие. Каждый способ и его настройка — в гайде Способы оплаты в Telegram.
  9. Поделитесь магазином. Опубликуйте ссылку в канале, закрепите её, поставьте в шапку профиля. Каждый, кто открыл бота, потом сможет получать ваши рассылки.

Вся витрина, от каталога до подтверждения заказа, собирается из этих настроек. Писать и хостить код не нужно.

Что проверить после запуска#

  • Сделайте тестовый заказ сами. Откройте бота с телефона, купите что-нибудь недорогое и убедитесь, что заказ появился в Заказах.
  • Откройте ссылку на товар из поста в канале. Если открылся чат с ботом, а не магазин, Main Mini App ещё не включено.
  • Посмотрите цифры первой недели. На главной панели видны посетители, новые покупатели, заказы и выручка — по ним понятно, где люди уходят.

Ограничения#

  • Цифровые товары оплачиваются в Stars. Это правило Telegram для любых мини-приложений, а не Tiny Shops.
  • Main Mini App включается только в BotFather. Никакая платформа не включит его за вас; Tiny Shops проверяет его и показывает шаги.
  • У конструктора готовая вёрстка. Тему, цвета и логотип вы выбираете в панели, но свой код в витрину не добавить. Если нужно полностью своё приложение, ваш путь — код.
  • Свой домен — на Pro и Scale. Любой магазин работает на своём адресе tiny-shops.com; подробнее — как подключить свой домен.

FAQ#

Создать мини-приложение в Telegram — бесплатно? Создать бота в @BotFather ничего не стоит. С кодом вы платите за разработку и хостинг. На Tiny Shops тариф Free стоит $0 в месяц: каждый заказ после первых $100 продаж платит 7%, а сами первые $100 — без комиссии, один раз (не каждый месяц). Все цены — на странице тарифов.

Нужно ли уметь программировать? Только если вы пишете приложение сами. В конструкторе вы заполняете товары и настройки, а Mini App собирается автоматически.

На каком языке пишут Telegram Mini Apps? Это веб-приложения: HTML, CSS и JavaScript, с любым фреймворком. Серверную часть можно писать на любом языке, который умеет проверять подпись initData.

Может ли мини-приложение принимать оплату? Да. Цифровые товары и услуги оплачиваются в Telegram Stars. Физические товары — через платёжных провайдеров, например Stripe. Магазин на Tiny Shops может принимать и наличные или перевод: заказ отмечается оплаченным вручную.

Как люди открывают моё мини-приложение? Через кнопку меню в боте, по ссылке вида t.me/yourbot?startapp, когда включено Main Mini App, или по кнопкам в ваших сообщениях и постах.

Создайте магазин в Telegram Mini App на tiny-shops.com →

Читайте дальше#

Читать дальше

Stripe

Stripe в Telegram: как подключить к магазину

Stripe и Telegram по шагам: токен Stripe в BotFather или Stripe Connect, подключение к Telegram-магазину, тестовая карта 4242 и запуск боевых платежей.

Канал

Новые статьи — сначала в Telegram.
Без спама и «лайфхаков роста».