Architektura TMA v roce 2026: trychtýř bez instalace a WebApp SDK
Telegram Mini Apps (TMA) běží jako plnohodnotné webové aplikace uvnitř multiplatformního WebView Telegramu na iOS, Androidu, macOS, Windows i Webu. Spuštění jediným klepnutím z menu bota nebo reklamy Telegram Ads odstraňuje bariéru stahování 150 MB z obchodu i registrační formuláře.
V roce 2026 Bot API a SDK Telegram.WebApp zpřístupňují biometrii, cloudové úložiště, celoobrazovkový režim, zástupce na plochu telefonu i nativní platební dialogy. Produkční architektura odděluje React/Vue frontend, bezstavové API ověřující kryptografické podpisy a worker bota pro pre_checkout_query a notifikace.
Platební metody: Telegram Stars vs. externí PSP a TON Connect
Volba platební brány určuje čistou marži i soulad s pravidly mobilních obchodů. Požadavky Apple a Google pro digitální obsah prosadily Telegram Stars (XTR) jako standard uvnitř aplikace, zatímco fyzický prodej a externí webový SaaS využívají běžné PSP.
| Platební metoda | Povolené scénáře | Efektivní poplatek a FX | Doba vypořádání | Chargebacky a compliance |
|---|---|---|---|---|
| Telegram Stars (XTR) | Digitální zboží, AI kredity, předplatné bota, virtuální předměty | 30% poplatek Apple/Google IAP + 2%–5% spread výběru Fragment → TON | 21denní blokace před výběrem na TON peněženku | Nulové karetní chargebacky; vratky přes zůstatek Stars |
| Externí PSP (Stripe, Adyen, Paddle) | Fyzický e-commerce, lokální služby, externí webový SaaS | 2,9% + $0,30 (Stripe) nebo 5% + $0,50 (MoR); +1,5% FX | T+2 až T+7 pracovních dnů na firemní účet | Standardní spory Visa/MC; vyžaduje 3DS2 a PCI-DSS |
| TON Connect / Jettons (USDT) | Web3 nástroje, P2P tržiště, spropitné, high-risk | 0,01–0,05 TON poplatek sítě (~$0,05–$0,20) + 0,3%–0,8% spread | Okamžitá on-chain finalita (5 sekund) | Nevratné transakce; vyžaduje AML/MiCA screening při úschově |
Týmy prodávající multiplatformní SaaS předplatné mimo mobilní IAP mohou ušetřit přes 20 procentních bodů marže díky webové fakturaci nebo stablecoinům. Podívejte se na naši analýzu fakturace SaaS a MoR a přehled kryptoměnových platebních bran USDT.
Benchmarky retence a monetizace podle kategorií TMA
Snadný vstup nafukuje horní část trychtýře, proto je klíčové sledovat kohorty D1–D30. Data z roku 2026 ukazují výrazný rozdíl mezi užitkovými nástroji a klikacími hrami.
| Kategorie TMA | Start → Aktivace | Retence D1 | Retence D7 | Retence D30 | Placená konverze / ARPPU |
|---|---|---|---|---|---|
| AI nástroje a produktivita | 72%–84% | 36%–44% | 21%–28% | 14%–22% | 4,5%–7,2% / $14,00 |
| SaaS a FinTech aplikace | 65%–76% | 32%–40% | 19%–26% | 13%–19% | 5,0%–8,5% / $24,50 |
| E-Commerce a vstupenky | 58%–70% | 24%–31% | 12%–18% | 9%–14% | 3,2%–5,8% / $42,00 |
| Kazuální a Web3 Tap hry | 80%–92% | 28%–38% | 10%–16% | 5%–11% | 1,2%–2,8% / $6,50 |
Tři prvky zvyšují retenci D30 o 35%–50%: připnutí aplikace na plochu pomocí addToHomeScreen(), kontextové zprávy bota do 24 hodin a oboustranně odměňované zvací odkazy t.me/bot/app?startapp=ref_id.
Unit economics a modelování ROI pro rozpočet $10 000 UA
Telegram Ads vyžaduje platbu předem, zatímco Stars strhávají 30%–35% na poplatcích a drží prostředky 21 dnů. Zde je 30denní simulace pro AI Mini App s rozpočtem $10 000 na akvizici:
- Objem akvizice: Rozpočet $10 000 při CPA $0,40 za aktivovaný start přinese 25 000 aktivních uživatelů.
- Hrubé tržby: Při 4,5% konverzi nakoupí 1 125 uživatelů při průměrném ARPPU $14,00, což tvoří $15 750 hrubých tržeb.
- Scénář A — 100% Telegram Stars: Po odečtení 30% poplatku obchodu a 3% spreadu na Fragmentu (33% = $5 197,50) zůstává $10 552,50 čistých tržeb. Po zaplacení $10 000 za reklamu a $450 za servery/LLM činí zisk v 1. měsíci +$102,50 (1,0% ROI) a návratnost závisí na obnovách ve 2. měsíci.
- Scénář B — Hybridní webový billing přes Stripe: Přesměrování webových předplatných na Stripe s poplatkem 3,2% ($504) přináší $15 246 čistých tržeb. Po odečtení $10 000 UA a $450 COGS dosahuje čistá marže 30. den +$4 796 (+48,0% ROI) s výplatou T+2.
Zadejte vlastní hodnoty CPA, ARPPU a odchodu zákazníků do naší kalkulačky unit economics. Další výpočty najdete v článku Unit economics v nákupu médií.
Bezpečnostní checklist: ověření HMAC-SHA256 initData a webhooků
Každý požadavek z klientského WebView musí být ověřen na serveru:
- Ověření
initDatapomocí HMAC-SHA256: Seřaďte páry zwindow.Telegram.WebApp.initData(bezhash) a ověřte podpis klíčemHMAC("WebAppData", bot_token). - Kontrola stáří
auth_date: Odmítejte payloady starší 300 sekund a vystavte krátkodobý JWT token. - Validace v
pre_checkout_query: Odpovězteok=Truedo 10 sekund až po kontrole ceny v XTR a dostupnosti. - Idempotence
successful_payment: Ukládejtetelegram_payment_charge_ids unikátním indexem proti dvojitému připsání. - Synchronizace vratek: Automaticky odeberte přístup při zavolání
refundStarPayment.
Časté architektonické chyby a rizika compliance
- Podcenění 21denní blokace Stars: Reinvestice tržeb do reklamy se zastaví bez provozního kapitálu na pokrytí třítýdenního čekání ve Fragmentu.
- Nasazení Stripe pro digitální zboží v iOS WebView: Obcházení Apple IAP pro interní kredity vystavuje bota zablokování.
- Synchronní volání AI ve WebView: Požadavky nad 20 sekund při minimalizaci Telegramu vyprší; zpracujte je na pozadí a výsledek pošlete přes Bot API.
- Necílené hromadné rozesílky: Míra blokací nad 12% snižuje doručitelnost důležitých transakčních zpráv.