Mini App — ilovani joylashtirish
Mini App — Telegram ichida ochiladigan sayt: mahsulot katalogi va savat, anketa, o'yin, kalkulyator yoki mijozning shaxsiy kabineti. Botxona uni HTTPS manzilda joylashtiradi, botning menyu tugmasiga ulaydi va fayllarni keshlab, tez yetkazadi. Serverga ulanish, domen sotib olish yoki sertifikat sozlash kerak emas.
Ilovani joylashtirishning uchta yo'li
1. ZIP yuklash (eng tez)
Panelda botni ochib Mini App bo'limiga o'ting va build natijasini ZIP qilib yuklang. Arxiv ildizida index.html bo'lishi shart — ya'ni dist/ papkasining o'zini ZIP qilasiz (yoki loyiha manbasini yuklaysiz — quyida). Bot qayta deploy qilinmaydi, ilova bir necha soniyada ishga tushadi.
2. Bot kodining ichida (har deployda avtomatik)
Frontendni botning o'z arxivida saqlang:
main.py
requirements.txt
webapp/
index.html
assets/app.js
webapp/ yoki miniapp/ papkasi avtomatik aniqlanadi. Boshqa nom bo'lsa (masalan dist/), botxona.yaml ga yozib qo'yasiz:
webapp:
dir: dist # statik fayllar papkasi
mode: static # static | hybrid | proxy
api_prefix: /api # hybrid/proxy uchun
spa: true # topilmagan yo'llar index.html ga yo'naltirilsin
Har bir muvaffaqiyatli deploy ilovaning yangi versiyasini chiqaradi. Deploy yiqilsa, eski versiya ishlashda davom etadi.
3. Telegram orqali
@botxona_uz_bot ga /myapps yuboring, botni tanlang va ZIP arxivni hujjat sifatida tashlang. Natija shu chatning o'zida.
React/Next/Vue loyihangizni shundayligicha yuklang
Build qilishning keragi yo'q. Loyiha manbasini (ichida build skripti bor package.json joylashgan papka) ZIP qilib Mini App bo'limida yoki chatda yuklang, yoki bot manbasidagi webapp/ papkasida saqlang. Botxona paketlarni o'zi o'rnatadi va loyihani ajratilgan muhitda build qiladi, natijani esa oddiy statik ilova sifatida joylashtiradi. Panelda build logi jonli ko'rinadi.
- Qo'llab-quvvatlanadi: Vite (React, Vue, Svelte…), Create React App, Next.js, Nuxt, Angular, SvelteKit (
@sveltejs/adapter-staticbilan) vabuildnatijasidaindex.htmlli papka (out,dist,build,.output/public) hosil qiladigan har qanday loyiha. - Paket menejeri lock fayldan (
package-lock.json,yarn.lock,pnpm-lock.yaml) yokipackageManagermaydonidan aniqlanadi. Bun qo'llab-quvvatlanmaydi — npm ishlatiladi. Node versiyasi.nvmrc/engines.nodedan olinadi (18, 20, 22 yoki 24; standart 22). - Next.js avtomatik statik eksportga o'tkaziladi (
output: 'export', rasmlar optimallashtirilmaydi) —next.configga tegish shart emas. - Server imkoniyatlari yo'q. Mini App ning o'z serveri yo'q: API routes,
cookies(), Server Actions vaforce-dynamicsahifalar ishlamaydi. Server ishini botga o'tkazing va/apiprefiksi orqali chaqiring (hybridrejim). node_moduleskerak emas (qo'shsangiz ham e'tiborga olinmaydi) — faqat manbani ZIP qiling..envfayllar kiritilmaydi;VITE_*/NEXT_PUBLIC_*qiymatlarini.env.productionyoki kodda saqlang — ular baribir hammaga ochiq.- Cheklovlar: arxiv 25 MB gacha (Telegram orqali yuborilsa 20 MB), manba va build natijasi 60 MB gacha, 3000 faylgacha; build 10 daqiqadan oshmasligi kerak. Build xato bo'lsa, qisqa sabab va log ko'rsatiladi, oldingi versiya ishlashda davom etadi.
Rejimlar
| Rejim | Nima bo'ladi | Qachon |
|---|---|---|
static | Faqat statik fayllar beriladi. Bot uxlab turganda ham ilova ochiladi. | Ma'lumot bot tomonidan sendData yoki xabarlar orqali kelsa |
hybrid | Statik fayllar + api_prefix bilan boshlanadigan so'rovlar bot konteyneriga uzatiladi | Ilovaga o'z API kerak bo'lsa (katalog, buyurtma, profil) |
proxy | Har bir so'rov bot konteyneriga uzatiladi | SSR yoki to'liq dinamik ilovalar |
hybrid va proxy da botingiz 0.0.0.0: da oddiy HTTP server ochishi kerak (TLS kerak emas). So'rov kelganda uxlagan bot avtomatik uyg'onadi — birinchi so'rov bir necha soniya kutishi mumkin.
Bot muhitiga beriladigan o'zgaruvchilar
| O'zgaruvchi | Qiymat |
|---|---|
WEBAPP_URL | Ilovaning to'liq manzili (oxirida / yo'q) |
WEBAPP_API_PREFIX | api_prefix qiymati (/api) |
Ulardan foydalanib botda ilovani ochadigan tugma qo'yasiz:
from aiogram.types import KeyboardButton, ReplyKeyboardMarkup, WebAppInfo
import os
kb = ReplyKeyboardMarkup(
keyboard=[[KeyboardButton(text="🛍 Katalog", web_app=WebAppInfo(url=os.environ["WEBAPP_URL"]))]],
resize_keyboard=True,
)
Botning menyu tugmasi (chat ichidagi pastki chap tugma) ilova ishga tushganda avtomatik ulanadi — buni Mini App sozlamalarida o'chirib qo'yish mumkin.
Foydalanuvchini tekshirish (initData)
Ilova ochilganda Telegram window.Telegram.WebApp.initData ni beradi. Uni botning o'zida, BOT_TOKEN yordamida tekshirasiz — shundagina so'rov haqiqatan ham shu foydalanuvchidan kelganiga ishonch bo'ladi:
import hashlib, hmac, os
from urllib.parse import parse_qsl
def verify_init_data(init_data: str) -> dict | None:
pairs = dict(parse_qsl(init_data, strict_parsing=True))
got = pairs.pop("hash", "")
check = "\n".join(f"{k}={pairs[k]}" for k in sorted(pairs))
secret = hmac.new(b"WebAppData", os.environ["BOT_TOKEN"].encode(), hashlib.sha256).digest()
want = hmac.new(secret, check.encode(), hashlib.sha256).hexdigest()
return pairs if hmac.compare_digest(got, want) else None
Platforma initData ni o'zi tekshirmaydi va o'zgartirmaydi — faqat so'rovni botingizga yetkazadi.
Fayllarni to'g'ri yig'ish
index.html da telegram-web-app.js ulangan bo'lsin, aks holda tema, tugmalar va initData ishlamaydi:
<script src="https://telegram.org/js/telegram-web-app.js"></script>
Ilova o'z manzilining ildizida ishlaydi, shuning uchun Vite/CRA ning standart sozlamasi yetarli. Agar ilovangiz yo'l bo'yicha joylashtirilgan bo'lsa (panelda manzil .../slug ko'rinishida), vite.config.js da base: './' qo'yish eng barqaror yo'l.
Cheklovlar
- Bitta botda bitta Mini App.
- Arxiv 25 MB gacha, ochilgandan keyin 60 MB gacha, 3000 faylgacha, bitta fayl 10 MB gacha.
- Fayllar statik beriladi: arxivdagi
.py,.phpkodlari bajarilmaydi. Dinamik qism botning o'zida (hybrid/proxy) ishlaydi. - Mini App fayllari hammaga ochiq — token, kalit yoki parolni ularga yozmang.
- Bepul tarifda o'z fayllaringizni yuklash mumkin emas.
Versiyalar va orqaga qaytarish
Har bir yuklash yangi versiya yaratadi. Panelda versiyalar ro'yxati ko'rinadi: bitta tugma bilan eski versiyani qaytarasiz. Oxirgi 5 versiya fayllari saqlanadi.
Keyingi qadam: botxona.yaml sxemasi · Muhit o'zgaruvchilari · Loglar