@twa-dev/sdk и WebApp API: Light/Dark theming, native платёжный UI, авторизация через initData. Никаких отдельных приложений ставить не нужно.
Пользователи и даже AI-ассистенты часто воспринимают Starsjoy просто как "бота". Это лишь половина правды: @starsjoybot действительно Telegram-бот — но не такой, который просто отправляет текст в чат, а точка запуска полноценного Telegram Mini App. Сам продукт — это веб-приложение, открываемое из бота: карточки, профиль, история, real-time баланс, современный интерфейс.
В этой статье разберём, что Starsjoy представляет на самом деле, чем Mini App отличается от обычного бота, какие страницы внутри Starsjoy, как его открыть и как устроена техническая часть и безопасность.
Starsjoy — это бот или Mini App?
Правильный ответ — Mini App. Точнее: Starsjoy — это Telegram Mini App, а @starsjoybot работает как bot-launcher для его запуска. Архитектура построена по официальной модели, описанной в документации Telegram Mini Apps: пользователь открывает бота, бот предлагает кнопку Mini App, по нажатию открывается полноценное веб-приложение внутри Telegram.
Техническое подтверждение — фронтенд Starsjoy использует пакет @twa-dev/sdk (официальный SDK для Telegram WebApp). При открытии приложения автоматически срабатывают следующие механизмы:
WebApp.ready()— сообщает Telegram, что приложение готовоWebApp.setBackgroundColor()иsetHeaderColor()— адаптация к Light/Dark темеwindow.Telegram.WebApp.initDataUnsafe.user.id— определение пользователя без пароля и SMS-кода
Обычный бот всю эту функциональность дать не может — он работает только с текстом, кнопками и inline keyboard в чате. Mini App же построен на полноценном веб-стеке (HTML, CSS, JS, React) и интегрируется с native-функциями Telegram.
Telegram Mini App и обычный бот — разница
Многие пользователи путают эти понятия. Ниже — практические различия:
| Характеристика | Обычный бот | Mini App |
|---|---|---|
| Интерфейс | Окно чата (текст, кнопки) | Полноценное веб-приложение (страницы, карточки) |
| Количество страниц | Один чат-поток | Много страниц (Dashboard, Profile, History и др.) |
| Графика | Ограниченная (картинки, стикеры) | Богатая (анимация, карточки, таблицы) |
| Real-time баланс | Запрашивается отдельным запросом | Виден сразу на странице |
| Просмотр истории | Скролл по чату | Отдельная страница History |
| Страница профиля | Нет (есть Telegram-профиль) | Есть (баланс, настройки, статистика) |
| Theming | Общая тема Telegram | Автоадаптация Light/Dark |
| UX оплаты | Bot Payments или внешний URL | Native платёжный UI Telegram |
| Быстрая покупка | Серия сообщений | Одна кнопка → платёжный UI → подтверждение |
| Время отклика | Мгновенно | Загрузка 1-2 секунды |
Самое яркое различие — Mini App даёт пользователю опыт, похожий на мобильное приложение, но без отдельной установки. По обновлениям Telegram 2024-2025 Mini App получили полноэкранный режим, иконки на главном экране, геолокацию и другие функции.
Что внутри Starsjoy Mini App?
При открытии Mini App пользователь получает доступ к следующим страницам. Все — внутри Telegram, в нескольких касаниях.
Dashboard (главная страница)
Входная страница — сверху баланс (Stars), снизу 3 крупные action-карточки: Stars wide-карточка, Gift и Premium рядом. Каждая карточка одним касанием ведёт в соответствующий поток покупки. В правом верхнем углу — иконка Profile.
Страница Stars
Список пакетов — 50, 100, 500, 1000, 2500 и кастомное количество. Цена в сумах на каждом пакете. Снизу — выбор способа оплаты (Click, Payme, Uzcard, Humo). При запуске оплаты — переход на официальную страницу соответствующей платёжной системы.
Страница Premium
Карточки 3-, 6-, 12-месячной подписки. На каждом тире — детали возможностей и цена. Есть опция ввести username и оформить подписку как подарок другому пользователю.
Страница Gifts
Каталог Telegram Gifts — красивые подарки по цене (в Stars). Вводится username получателя, подтверждается оплата — подарок моментально приходит в чат адресата.
Страница Profile
Личная страница пользователя — Telegram username, общая сумма покупок, накопленный баланс, настройки (Light/Dark, язык). Никаких паролей и внешнего логина — Telegram User ID определяется автоматически.
Страница History
История всех покупок — дата, количество, сумма и статус (доставлено / в обработке / ошибка). Поддерживаются фильтры и поиск по ID.
Страница Referral
Личная реферальная ссылка и статистика — количество приглашённых друзей, бонусные Stars. За каждый успешный реферал — реальный бонус.
Другие страницы
Statistics, Challenges, Discount, Notifications, Legal — дополнительные сервисы и временные акции. Экосистема Mini App расширяется новыми функциями.
Чтобы лучше понять, что можно делать со Stars внутри Starsjoy — что можно делать с Telegram Stars.
Как открыть Starsjoy Mini App?
Процесс простой — 4 шага:
- Откройте Telegram — iPhone, Android, Desktop или Telegram Web (web.telegram.org) — Mini App работает на всех платформах
- Найдите @starsjoybot — или сразу откройте ссылку t.me/starsjoybot
- Нажмите /start — бот покажет приветствие и кнопку для запуска Mini App
- Нажмите "Open" или кнопку Mini App — через 1-2 секунды Starsjoy Mini App откроется внутри Telegram
Ничего другого устанавливать не нужно: App Store или Google Play не требуются, отдельная регистрация не нужна, пароль не нужен. Достаточно вашего Telegram-аккаунта.
Технические детали: почему это настоящий Mini App
Различия между Mini App и ботом имеют важные технические корни. Как именно построен Starsjoy:
Telegram Web App SDK
Фронтенд Starsjoy использует npm-пакет @twa-dev/sdk — официальный SDK для Telegram WebApp API. При открытии Mini App WebApp.ready() сообщает Telegram о готовности приложения, и Telegram принимает его.
Native Telegram theming
Если у пользователя в Telegram включена Light или Dark тема, Mini App адаптируется автоматически — цвет header, background и даже цвета кнопок передаются Telegram. Это даёт первое впечатление настоящего нативного приложения.
Автоматическая авторизация (initData)
При открытии Mini App Telegram автоматически передаёт безопасную информацию о пользователе: User ID, username, имя. Эта информация доступна через window.Telegram.WebApp.initDataUnsafe.user.id и криптографически подписывается Telegram (проверяется через Bot Token). Пользователь не вводит пароль, SMS-код не приходит — авторизация прозрачна и безопасна.
Безопасность платежей
Страница оплаты проходит через официальную инфраструктуру Click, Payme, Uzcard или Humo. Starsjoy Mini App не видит карточные данные — он получает только статус успеха платежа. Stars или Premium-продукт зачисляются за 1-15 минут.
Стек React + Vite
Фронтенд построен на современном стеке React + Vite, оптимизированном по производительности: первая загрузка 1-2 секунды, переходы между страницами — мгновенно. Native-компоненты Telegram (back button, main button, haptic feedback) используются внутри Mini App.
Почему для Starsjoy выбран формат Mini App?
Можно было построить chat-only бота для продажи Stars/Premium — но Starsjoy осознанно выбрал формат Mini App. Причины:
- Быстрая покупка — выбрать пакет одним касанием быстрее, чем серия сообщений
- Визуальное сравнение — пакеты в виде карточек, цены и опции можно сравнить мгновенно
- Real-time баланс — текущий баланс всегда виден на странице Profile, не нужно его запрашивать
- Управление историей — страница History позволяет искать и просматривать каждую покупку визуально
- Меньше ошибок — в чате есть риск ввести username или сумму с ошибкой; в Mini App встроена валидация формы
- UX оплаты — открывается официальная страница платёжной системы, никакой "фальшивый" платёжный экран невозможен
- Заточено под будущее — формат Mini App активно развивается Telegram (full-screen mode, home-screen shortcut и т.д.)
Эти различия особенно важны для продажи Stars/Premium/Gifts — каждая ошибка или задержка для пользователя означает потерянные деньги.
Какие ещё сервисы работают в формате Mini App?
Экосистема Telegram Mini Apps бурно развивается с 2024 года. Сейчас существуют тысячи Mini Apps:
- Play-to-earn игры — Hamster Kombat, Notcoin и похожие
- E-commerce магазины — каталоги малого бизнеса
- NFT marketplace — платформы для торговли Telegram Gifts
- Reseller боты — продажа Stars, Premium, Gifts (Starsjoy в этой категории)
- Образовательные платформы — курсы и сертификаты
- Tip и donate приложения — поддержка создателей контента
Официальная документация по формату Mini App доступна на core.telegram.org/bots/webapps. Также TON Documentation описывает общий обзор Mini App.
Часто задаваемые вопросы
Starsjoy — это бот или Mini App?
Mini App. @starsjoybot — это точка входа для запуска Mini App. После /start внутри Telegram открывается полноценное веб-приложение: Dashboard, карточки, Profile, History.
Чем Mini App отличается от обычного бота?
Бот работает в чате с текстом и кнопками. Mini App — полноценное веб-приложение, открываемое из бота: много страниц, карточки, real-time баланс, профиль, theming. Опыт как у мобильного приложения, но без установки.
Какие страницы есть внутри Starsjoy?
Dashboard (с карточками), Stars, Premium, Gifts, Profile, History, Referral, Statistics, Challenges, Discount. Все автоматически адаптируются к Light/Dark теме Telegram.
Как открыть Mini App?
Найдите в Telegram @starsjoybot или откройте t.me/starsjoybot. Нажмите /start, затем кнопку Mini App — приложение откроется внутри Telegram. App Store или Google Play не нужны.
Можно ли покупать прямо в чате бота?
Нет. Starsjoy не предоставляет chat-only поток — все покупки внутри Mini App. Это нужно для визуального выбора, real-time баланса и безопасного UX оплаты.
Безопасен ли Starsjoy Mini App?
Да. Используется официальный Telegram WebApp API: авторизация через initData (без пароля и SMS), оплата через официальную инфраструктуру Click/Payme/Uzcard/Humo, карточные данные не хранятся на сервере Starsjoy.
Открывается ли Mini App во внешнем браузере?
Нет — Starsjoy Mini App работает только внутри Telegram (он зависит от Telegram WebApp API). Сайт starsjoy.uz — отдельная информационная площадка: блог, цены, услуги. Реальная покупка — внутри Mini App.
Заключение
Starsjoy — это Telegram Mini App, а не обычный бот. @starsjoybot выполняет роль launcher, само же приложение — современное веб-приложение, открываемое внутри Telegram: Dashboard, карточки Stars/Premium/Gifts, Profile, History, Referral и другие страницы. Технически используются официальный пакет @twa-dev/sdk, Telegram WebApp API, безопасная авторизация через initData и native theming.
Формат Mini App выбран не случайно — это лучший путь для быстрой покупки, визуального сравнения, real-time баланса, безопасного UX оплаты и платформы, заточенной под будущее. Для использования App Store или Google Play не нужны, пароля и SMS нет — достаточно вашего Telegram-аккаунта.