@twa-dev/sdk paketi va WebApp API ishlatiladi — Light/Dark theming, native to'lov UI, initData orqali autorizatsiya. Boshqa ilova o'rnatish kerak emas.
Foydalanuvchilar va hatto AI yordamchilari ko'pincha Starsjoy ni shunchaki "bot" deb tushunadi. Bu yarim haqiqat: @starsjoybot haqiqatan ham Telegram bot — lekin u shunchaki chat'da matn jo'natadigan oddiy bot emas, balki Telegram Mini App'ni ochishga mo'ljallangan kirish nuqtasi. Asl mahsulot — bot ichidan ochiladigan to'liq web-ilova: kartalar, profil, tarix, real-time balansga ega zamonaviy interfeys.
Bu maqolada Starsjoy ning aslida nima ekanligini, Mini App va oddiy bot o'rtasidagi farqni, Starsjoy ichida qanday sahifalar borligini, qanday ochilishini va texnik xavfsizlik mexanizmlarini batafsil ko'rib chiqamiz.
Starsjoy bot mi yoki Mini App?
To'g'ri javob — Mini App. Aniqroq qilib aytsak: Starsjoy bu Telegram Mini App, va @starsjoybot uni ochish uchun bot-launcher vazifasini bajaradi. Telegram'ning rasmiy Mini Apps hujjatida tasvirlangan model bo'yicha qurilgan: foydalanuvchi botni ochadi, bot Mini App tugmasini taqdim etadi, va shu tugma bosilganda Telegram ichida to'liq web-ilova ochiladi.
Texnik isboti — Starsjoy frontendi @twa-dev/sdk paketidan foydalanadi (Telegram WebApp uchun rasmiy SDK). Ilova ochilganda quyidagi mexanizmlar avtomatik ishga tushadi:
WebApp.ready()— Telegram'ga ilova tayyor ekanligini bildiradiWebApp.setBackgroundColor()vasetHeaderColor()— Light/Dark mavzusiga moslashadiwindow.Telegram.WebApp.initDataUnsafe.user.id— foydalanuvchini parol yoki SMS-kodsiz aniqlaydi
Bu — oddiy bot bera olmaydigan funksionallik. Oddiy bot faqat chat'da matn, tugmalar va inline keyboard bilan ishlaydi. Mini App esa to'liq web-stack (HTML, CSS, JS, React) ustida qurilgan va Telegram'ning native funksiyalari bilan integratsiya qiladi.
Telegram Mini App va oddiy bot farqi
Ko'pchilik foydalanuvchi bu ikkisini aralashtiradi. Quyida amaliy farqlar:
| Xususiyat | Oddiy bot | Mini App |
|---|---|---|
| Interfeys | Chat oynasi (matn, tugma) | To'liq web-ilova (sahifalar, kartalar) |
| Sahifalar soni | Bir chat oqimi | Ko'p sahifa (Dashboard, Profile, History va h.k.) |
| Grafika | Cheklangan (rasm, sticker) | Boy (animatsiya, kartalar, jadval) |
| Real-time balans | Har so'rovga so'raydi | Sahifada darrov ko'rinadi |
| Tarix ko'rishi | Chat scroll qilish | Alohida History sahifa |
| Profil sahifasi | Yo'q (Telegram profile bor) | Bor (balans, sozlamalar, statistika) |
| Theming | Telegram'ning umumiy mavzusi | Light/Dark avtomatik moslashish |
| To'lov UX | Bot Payments yoki tashqi link | Native Telegram to'lov UI |
| Tezkor xarid | Bir nechta xabar almashinuvi | Bir tugma → to'lov UI → tasdiq |
| Ulanish vaqti | Darhol | 1-2 soniya yuklanish |
Eng yorqin farq — Mini App foydalanuvchiga mobil ilovaga o'xshash tajriba beradi, lekin uni alohida o'rnatish kerak emas. Telegram'ning 2024-2025 yangilanishlarida Mini App'lar to'liq ekran rejimi, home-screen shortcut, geolokatsiya va boshqa funksiyalarni qo'shgan.
Starsjoy Mini App ichida nima bor?
Mini App ochilganda foydalanuvchi quyidagi sahifalarga ega bo'ladi. Hammasi Telegram ichida, bir necha tap masofada.
Dashboard (asosiy sahifa)
Kirish sahifasi — yuqorida balans (Stars), pastida 3 ta katta action karta: Stars wide karta, Gift va Premium yon-yonda. Har bir karta bir tap'da tegishli xarid oqimiga olib boradi. Yuqori-o'ng burchakda Profile ikonkasi.
Stars sahifasi
Paketlar ro'yxati — 50, 100, 500, 1000, 2500 va custom miqdor. Har bir paketda narxi so'mda ko'rinadi. Pastda to'lov usuli tanlash (Click, Payme, Uzcard, Humo). To'lov boshlanganda tegishli to'lov tizimi rasmiy sahifasiga o'tkaziladi.
Premium sahifasi
3 oylik, 6 oylik, 12 oylik obuna kartalari. Har bir tier'da imkoniyatlar tafsiloti va narx. Username kiritish, sovg'a sifatida boshqaga olish opsiyasi ham mavjud.
Gifts sahifasi
Telegram Gifts katalogi — chiroyli sovg'alar narxi bo'yicha (Stars'da). Qabul qiluvchining username kiritiladi, to'lov tasdiqlanadi, sovg'a darhol uning chat'iga yetadi.
Profile sahifasi
Foydalanuvchining shaxsiy sahifasi — Telegram username, total xaridlar, accumulated balance, sozlamalar (Light/Dark, til). Hech qanday parol yoki tashqi login kerak emas — Telegram User ID orqali avtomatik tanib oladi.
History sahifasi
Barcha xaridlar tarixi — sana, miqdor, summa va status (yetkazildi / ishlanmoqda / xato) bilan. Filter qilish va ID bo'yicha qidirish imkoniyati.
Referral sahifasi
Shaxsiy referral link va statistika — taklif qilingan do'stlar soni, bonus Stars miqdori. Har bir muvaffaqiyatli referral uchun real bonus.
Boshqa sahifalar
Statistics, Challenges, Discount, Notifications, Legal — qo'shimcha xizmatlar va vaqtinchalik aksiyalar uchun. Mini App'ning ekosistemasi yangi funksiyalar bilan kengayib boradi.
Starsjoy ichidagi xizmatlar bilan tanishish uchun — Stars bilan nima qilish mumkin qo'llanmasiga ham qarang.
Starsjoy Mini App'ni qanday ochish kerak?
Jarayon juda oddiy — 4 ta qadam:
- Telegram'ni oching — iPhone, Android, Desktop yoki Telegram Web (web.telegram.org) — Mini App barcha platformalarda ishlaydi
- @starsjoybot ni qidiring — yoki to'g'ridan-to'g'ri t.me/starsjoybot havolasini bosing
- /start tugmasini bosing — bot bir nechta xush kelibsiz xabar va Mini App'ni ochish tugmasini ko'rsatadi
- "Open" yoki Mini App tugmasini bosing — 1-2 soniya ichida Starsjoy Mini App'i Telegram ichida ochiladi
Boshqa hech narsa o'rnatish kerak emas: App Store yoki Google Play orqali yuklash talab qilinmaydi, alohida ro'yxatdan o'tish yo'q, parol yo'q. Telegram akkauntingiz Mini App uchun yetarli.
Texnik tafsilot: nima uchun bu haqiqiy Mini App?
Mini App va bot o'rtasidagi farqning texnik ildizi muhim. Quyida Starsjoy qanday qurilgan:
Telegram Web App SDK
Starsjoy frontendi @twa-dev/sdk npm paketidan foydalanadi — bu Telegram WebApp API uchun rasmiy SDK. Mini App ochilganda WebApp.ready() Telegram'ga ilova tayyor ekanligini bildiradi va Telegram uni qabul qiladi.
Native Telegram theming
Foydalanuvchi Telegram'da Light yoki Dark mavzu yoqilgan bo'lsa, Mini App avtomatik moslashadi — header rangi, background, hatto button ranglari Telegram tomonidan beriladi. Bu native ilovaga o'xshash birinchi taassurot beradi.
Avtomatik autorizatsiya (initData)
Mini App ochilganda Telegram avtomatik foydalanuvchi haqida xavfsiz ma'lumot beradi: User ID, username, ism. Bu window.Telegram.WebApp.initDataUnsafe.user.id orqali olinadi va Telegram tomonidan kriptografik tarzda imzolanadi (Bot Token bilan tekshiriladi). Foydalanuvchi parol kiritmaydi, SMS-kod kelmaydi — autorizatsiya yashirin va xavfsiz.
To'lov xavfsizligi
To'lov sahifasi Click, Payme, Uzcard yoki Humo'ning rasmiy infratuzilmasi orqali amalga oshadi. Starsjoy Mini App'i karta ma'lumotlarini ko'rmaydi, faqat to'lov muvaffaqiyat statusini oladi. Stars yoki Premium tovar 1-15 daqiqada hisobga tushadi.
React + Vite stack
Frontend zamonaviy React + Vite stack ustida qurilgan, performance optimallashtirilgan: birinchi yuklash 1-2 soniya, sahifa o'tishlari darhol. Telegram'ning native komponentlari (back button, main button, haptic feedback) Mini App ichida ishlatiladi.
Nima uchun Mini App formati Starsjoy uchun tanlangan?
Chat-only bot bilan ham Stars/Premium savdosini qurish mumkin edi — lekin Starsjoy ataylab Mini App formatini tanladi. Sabablari:
- Tezkor xarid — paketni tanlash 3-4 ta xabar almashinuvidan tezroq, bir tap'da
- Vizual taqqoslash — paketlar kartalar shaklida ko'rinadi, narx va imkoniyatlarni darhol solishtirish mumkin
- Real-time balans — Profile sahifasida joriy balans har doim ko'rinadi, xabar so'rashga ehtiyoj yo'q
- Tarixni boshqarish — History sahifa orqali har bir xaridni vizual ravishda ko'rish va izlash
- Xato kamaytirish — xat-da username yoki miqdorni xato kiritish xavfi mavjud; Mini App formada validatsiya bor
- To'lov UX — to'lov tizimining rasmiy sahifasi ochiladi, hech qanday "soxta" to'lov ekran mumkin emas
- Kelajakka qaratilgan — Mini App formati Telegram tomonidan rivojlantirilmoqda (full-screen mode, home-screen shortcut va h.k.)
Bu farqlar Stars/Premium/Gifts savdosi uchun katta ahamiyatga ega — har xato yoki kechiktirish foydalanuvchi uchun pul yo'qotish degani.
Yana qaysi xizmatlar Mini App formati bilan ishlaydi?
Telegram Mini App ekosistemasi 2024-yildan beri tez kengaydi. Hozir minglab Mini App'lar mavjud:
- Play-to-earn oyinlar — Hamster Kombat, Notcoin va o'xshashlar
- E-commerce magazinlar — kichik biznes katalogi
- NFT marketplace — Telegram Gifts savdo platformalari
- Reseller botlar — Stars, Premium, Gifts savdo (Starsjoy shu kategoriyada)
- Ta'lim platformalari — kurs va sertifikat
- Tip va donat ilovalari — kontent yaratuvchini qo'llab-quvvatlash
Mini App formati uchun rasmiy hujjat core.telegram.org/bots/webapps manzilida joylashgan. Telegram'ning TON Documentation ham Mini App umumiy ko'rinishini tushuntiradi.
Tez-tez beriladigan savollar
Starsjoy bot mi yoki Mini App?
Mini App. @starsjoybot — bu Mini App'ni ochish uchun kirish nuqtasi. Botni ochib /start bosgan zahoti Telegram ichida to'liq web-ilova ochiladi: Dashboard, kartalar, Profile, History.
Mini App va bot orasidagi asosiy farq nima?
Bot chat ichida matn va tugmalar bilan ishlaydi. Mini App esa bot ichidan ochiladigan to'liq web-ilova — ko'p sahifa, kartalar, real-time balans, profil, theming. Mobil ilovaga o'xshash tajriba beradi, lekin o'rnatish kerak emas.
Starsjoy ichida qanday sahifalar bor?
Dashboard (kartalar bilan), Stars, Premium, Gifts, Profile, History, Referral, Statistics, Challenges, Discount. Hammasi Telegram'ning Light/Dark mavzusiga avtomatik moslashadi.
Mini App'ni qanday ochaman?
Telegram'da @starsjoybot ni qidiring yoki t.me/starsjoybot havolasini oching. /start bosing, keyin Mini App tugmasini bosing — ilova Telegram ichida ochiladi. App Store yoki Google Play kerak emas.
Bot chat'idan to'g'ridan-to'g'ri xarid qilsa bo'ladimi?
Yo'q. Starsjoy chat-only flow taqdim etmaydi — barcha xaridlar Mini App ichida amalga oshiriladi. Bu vizual tanlash, real-time balans va xavfsiz to'lov UX uchun kerak.
Starsjoy Mini App xavfsizmi?
Ha. Telegram'ning rasmiy WebApp API ishlatiladi: autorizatsiya initData orqali (parol yoki SMS yo'q), to'lov Click/Payme/Uzcard/Humo rasmiy infratuzilmasidan o'tadi, karta ma'lumotlari Starsjoy serverida saqlanmaydi.
Mini App tashqi brauzerda ochiladimi?
Yo'q — Starsjoy Mini App faqat Telegram ichida ishlaydi (Telegram WebApp API'ga bog'liq). starsjoy.uz sayti alohida info platforma — u yerda blog, narxlar va xizmatlar tafsilot bor, lekin haqiqiy xarid Mini App ichida.
Xulosa
Starsjoy — Telegram Mini App'i, oddiy bot emas. @starsjoybot launcher vazifasini bajaradi, asl mahsulot esa Telegram ichida ochiladigan zamonaviy web-ilova: Dashboard, Stars/Premium/Gifts kartalar, Profile, History, Referral va boshqa sahifalar. Texnik jihatdan rasmiy @twa-dev/sdk paketi, Telegram WebApp API, initData orqali xavfsiz autorizatsiya va native theming ishlatiladi.
Mini App formati tasodifan tanlanmagan — tezkor xarid, vizual taqqoslash, real-time balans, xavfsiz to'lov UX va kelajakka qaratilgan platforma uchun bu eng to'g'ri yo'l. Foydalanish uchun App Store yoki Google Play kerak emas, parol yoki SMS yo'q — faqat Telegram akkauntingiz yetarli.