Чтобы создать мини-приложение в Telegram, нужны три вещи: Telegram-бот, веб-приложение по публичному адресу и связка между ними, которую настраивают в @BotFather. Когда всё связано, нажатие кнопки в боте открывает ваше приложение прямо внутри Telegram: пользователь уже узнан, скачивать ничего не нужно. В этом гайде оба пути: собрать веб-приложение самому, шаг за шагом, и создать магазин в Mini App на no-code конструкторе, где приложение, хостинг и оплата уже готовы.
Быстрые ответы (2026)#
- С чего начать создание Telegram Mini App? Создайте бота в @BotFather командой
/newbot, разместите веб-приложение по HTTPS-адресу и привяжите этот адрес к боту как кнопку меню или как основное мини-приложение (Main Mini App). Подключите на странице скрипт Telegramtelegram-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 с кодом#
- Создайте бота. Откройте @BotFather, отправьте
/newbot, задайте имя и юзернейм наbotи скопируйте токен. Держите токен в секрете: у кого токен, тот управляет ботом. Подробно — в гайде как создать бота в Telegram. - Сделайте веб-приложение. Подойдёт любой фронтенд-стек: Mini App — это веб-страница. Подключите в
<head>скрипт Telegramtelegram-web-app.js, чтобы код виделwindow.Telegram.WebApp: пользователя, цвета темы, главную кнопку. - Выложите его в сеть. Разверните приложение на сервере или статическом хостинге, чтобы у него был публичный адрес. Telegram загружает его оттуда при каждом открытии.
- Привяжите к боту. В @BotFather задайте кнопку меню (
/setmenubuttonили Bot Settings → Menu Button) с адресом приложения. Чтобы появились Main Mini App и ссылкиt.me/yourbot?startapp, зайдите в /mybots → ваш бот → Bot Settings → Configure Mini App → Enable Mini App. - Проверяйте пользователя на сервере. Telegram передаёт приложению
initDataс хешем. Прежде чем доверять данным, пересчитайте подпись HMAC-SHA-256 на сервере ключом, полученным из токена бота, как описано в документации. ID пользователя, пришедшему из браузера без такой проверки, верить нельзя. - Добавьте оплату. Правила Telegram делят товары на два вида. Цифровые товары и услуги оплачиваются только в Telegram Stars (валюта
XTR). Для физических товаров и услуг можно использовать другие валюты и платёжных провайдеров. - Проверьте в Telegram. Откройте бота с телефона, нажмите кнопку меню и пройдите весь сценарий, включая оплату.
После запуска на вас остаются хостинг, обновления, админка для заказов и товаров и каждый новый способ оплаты.
Как создать магазин в Telegram Mini App на Tiny Shops#
Tiny Shops — no-code конструктор магазинов в Telegram Mini App: он держит витрину, корзину и оформление заказа и даёт панель, чтобы всем этим управлять. Настройка — короткий мастер.
- Начните на tiny-shops.com. Первый вопрос — Как называется магазин? Это название видят покупатели, и с него начинается адрес магазина.
- Выберите формат. В шаге Где будете продавать? выберите Витрина мини-приложения: каталог, корзина и оплата картой внутри Telegram. Второй вариант, В чате Telegram, — для продаж в переписке без витрины.
- Выберите оплату. В шаге Как принимать оплату?: Вручную (вы сами отмечаете заказы оплаченными), Звёзды, Картой (Stripe подключается после запуска) или Локальные платежи (Индонезия, Филиппины, Малайзия). Потом это можно поменять.
- Подключите бота. Нажмите Создать за меня — Telegram создаст бота на вашем аккаунте, без BotFather и токена. Или У меня уже есть — и вставьте токен из @BotFather.
- Запустите. Нажмите Создать магазин и открыть панель. Tiny Shops подключит бота и поставит ему кнопку меню Открыть магазин, которая открывает витрину.
- Добавьте товары. Товары → Добавить товар: фото, название, описание и цена. Товары можно подтягивать и из Google Таблицы.
- Включите Main Mini App. Это единственный шаг, который делается только в BotFather. На странице Telegram-бот есть точные шаги и ссылка, которую нужно вставить: откройте @BotFather, отправьте
/mybots, выберите бота, затем Bot Settings → Configure Mini App → Enable Mini App. После этого ссылки на товары в постах открывают магазин сразу, а не чат с ботом. - Подключите онлайн-оплату. Stripe (карты, Apple Pay и Google Pay внутри Mini App), Telegram Stars, TON, Xendit и другие. Каждый способ и его настройка — в гайде Способы оплаты в Telegram.
- Поделитесь магазином. Опубликуйте ссылку в канале, закрепите её, поставьте в шапку профиля. Каждый, кто открыл бота, потом сможет получать ваши рассылки.
Вся витрина, от каталога до подтверждения заказа, собирается из этих настроек. Писать и хостить код не нужно.
Что проверить после запуска#
- Сделайте тестовый заказ сами. Откройте бота с телефона, купите что-нибудь недорогое и убедитесь, что заказ появился в Заказах.
- Откройте ссылку на товар из поста в канале. Если открылся чат с ботом, а не магазин, 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 →
Читайте дальше#
- Telegram Mini Apps для бизнеса: зачем они бизнесу и сколько стоит мини-приложение — разработка или конструктор.
- Как создать бота в Telegram: полный разбор BotFather.
- Способы оплаты в Telegram: Stars, Stripe, TON и локальные платежи — и как подключить каждый.
- Как настроить магазин в Telegram: полный чек-лист запуска.
- Как вести несколько магазинов в Telegram: второй бренд в Mini App на одном аккаунте.
