Botxona

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-static bilan) va build natijasida index.html li papka (out, dist, build, .output/public) hosil qiladigan har qanday loyiha.
  • Paket menejeri lock fayldan (package-lock.json, yarn.lock, pnpm-lock.yaml) yoki packageManager maydonidan aniqlanadi. Bun qo'llab-quvvatlanmaydi — npm ishlatiladi. Node versiyasi .nvmrc / engines.node dan olinadi (18, 20, 22 yoki 24; standart 22).
  • Next.js avtomatik statik eksportga o'tkaziladi (output: 'export', rasmlar optimallashtirilmaydi) — next.config ga tegish shart emas.
  • Server imkoniyatlari yo'q. Mini App ning o'z serveri yo'q: API routes, cookies(), Server Actions va force-dynamic sahifalar ishlamaydi. Server ishini botga o'tkazing va /api prefiksi orqali chaqiring (hybrid rejim).
  • node_modules kerak emas (qo'shsangiz ham e'tiborga olinmaydi) — faqat manbani ZIP qiling. .env fayllar kiritilmaydi; VITE_* / NEXT_PUBLIC_* qiymatlarini .env.production yoki 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

RejimNima bo'ladiQachon
staticFaqat statik fayllar beriladi. Bot uxlab turganda ham ilova ochiladi.Ma'lumot bot tomonidan sendData yoki xabarlar orqali kelsa
hybridStatik fayllar + api_prefix bilan boshlanadigan so'rovlar bot konteyneriga uzatiladiIlovaga o'z API kerak bo'lsa (katalog, buyurtma, profil)
proxyHar bir so'rov bot konteyneriga uzatiladiSSR 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'zgaruvchiQiymat
WEBAPP_URLIlovaning to'liq manzili (oxirida / yo'q)
WEBAPP_API_PREFIXapi_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, .php kodlari 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