Casino Telegram WebApp inteqrasiya necə

Niyə Telegram WebApp Casino

Aşağı sürtünmə: «sayt axtarışı» olmadan botla dialoqdan 1-2 tapa daxil olun.

Anında çatdırılma fich: frontend domeninizdə yaşayır, CDN vasitəsilə buraxılışlar.

Telegram profilinə qoşulma: istifadəçinin başa düşülən identifikatoru və hazır kommunikasiya kanalları (top əvəzinə bot mesajları).

Marketinq əhatə: linklər 't. me/... 'və kanallarda/söhbətlərdə düymələr.

💡 Vacibdir: Telegram-da ödənişlər və məzmun üçün öz qaydaları var. Gambling üçün yurisdiksiyalara, geo kilidlərinə və saytın şərtlərinə riayət edin. Ödəniş ssenarilərinin bir hissəsini xarici brauzerə daxil etmək daha yaxşıdır («Kassa və məhdudiyyətlər» bölməsinə baxın).

Memarlıq: inteqrasiya nədən ibarətdir

Komponentlər:

1. Bot API təbəqəsi (webhook/long-polling): komandaları qəbul edir, menyu göndərir, WebApp-ı işə salır.

2. Domeninizdə WebApp (SPA/PWA): lobbi, profil, promo, yüngül oyun səhnələri, kassa marşrutlaşdırıcısı.

3. Platform Casino API: autentifikasiya, balans/dərəcələr, bonuslar, kassa, hekayələr.

4. Sessiyaların/linklərin saxlanması: 'telegram _ user _ id account_id'.

5. CDN + anti-bot/frod: mini applications assets qorunması və paylanması.

Başlanğıc axını:

İstifadəçi botu yazır → «Aç» düyməsini basır (web_app).
Telegram WebApp-ı müştəriyə daxil edir və sizə 'initData' (istifadəçi/söhbət üçün imzalanmış parametrlər) verir.
WebApp arxa planda imzanı yoxlayır → casino seansını yaradır/bərpa edir → UI verir.

WebApp başlanğıcı: düymələr və deep-link

Variantlar:

Кнопка в ReplyKeyboard/InlineKeyboard c `web_app: {url: "https://your. app/tg"}' - Telegram daxilində mini-proqram açır.
Main Menu (BotFather → Menu Button) - Daimi Açma düyməsi.
Deep-link `https://t. me/< bot>? startapp = '- başlanğıc kontekstini atın (məsələn, promo/referal/oyun).

Məsləhət: "Niyyət 'in təhlükəsiz ötürülməsi üçün 'startapp' istifadə edin (hansı ekranı açmaq olar). İmza yoxlanıldıqdan sonra məzmun və hüquqları özünüz təyin edin.

Hesabın autentifikasiyası və linklənməsi

WebApp nə gəlir

Telegram müştərisi pəncərəyə JS-obyekt 'Telegram əlavə edir. WebApp 'və' initData '/' initDataUnsafe 'sətri - istifadəçi/söhbət, vaxt və imza haqqında məlumat.

İstifadəçini necə təsdiqləmək olar

1. Cəbhədə Telegram-ı götürün. WebApp. initData 'və sizin backend olduğu kimi göndərin.

2. Arxa planda Telegram alqoritmi ilə imzanı yoxlayın (bot tokenindən alınmış açar ilə məlumat xəttində HMAC-SHA256; dəqiq alqoritm - rəsmi Telegram sənədlərində).

3. Yoxlama uğurlu olarsa, 'user-i çıxarın. id ',' username 'və metadata → tapın və ya bir əlaqə yaradın' telegram _ user _ id account_id'.

4. Casino platformasının qısa ömürlü JWT/seans tokenini cəbhəyə verin (məsələn, TTL 10-30 dəq + təhlükəsiz API-də refresh).

💡 Serverdə imzanı yoxlamadan heç vaxt 'initData' etibar etməyin. «Cəbhədən gələn user_id» həqiqətin yeganə mənbəyi kimi istifadə etməyin.

VebApp bot məlumat mübadiləsi

WebApp-dan bota: 'Telegram. WebApp. sendData(JSON. stringify (payload) '- bot' web _ app _ data 'alacaq və mesaj/düymə ilə cavab verə bilər.

WebApp daxilində UI hadisələri: 'MainButton', 'BackButton', 'HapticFeedback', 'onEvent (' themeChanged '	'viewportChanged'	…)`.
Mini-proqramın bağlanması: 'Telegram. WebApp. close () '- «uğurla yerinə yetirildikdən» sonra rahatdır.

Pattern: mürəkkəb əməliyyatları (kassa, yoxlama) WebApp-da aparırıq; bot - trigger/bildirişlər üçün («bonus aktiv», «KYC təsdiq»).

Platformaların kassası və məhdudiyyətləri

Telegram ödənişləri: platformanın daxili ödəniş mexanizmləri və kateqoriyalar üzrə ayrıca qaydaları var. Gambling üçün yerli qanunları və Telegram siyasətini tətbiq edin.

Praktik yanaşma:

Tam KYC/AML/KYT kontur və idempotency açarları ilə xarici brauzerdə (deeplink 'target = _ blank') çek açın.
Doldurma/çıxarış üçün yalnız istifadəçi ölkəsi üçün icazə verilən metodları (geo-maliyyə) göstərin.
Həmişə chat bot təsdiqini təkrarlayın (pupa əvəz kimi).

UX: necə «yerli» və tez etmək

Mövzu/Rənglər: Telegram istifadə edin. WebApp. themeParams 'və' colorScheme '(light/dark), kirayədə' themeChanged 'ilə dəyişdirin.

Naviqasiya: 'MainButton. setText ('Davam'). show()`; `BackButton. show () 'və prosessor' onEvent ('backButtonClicked',...) '.

Viewport: `Telegram. WebApp. expand()`; 'viewportHeight' (xüsusilə iOS-da).

Lokalizasiya: 'initDataUnsafe-dən dil götürün. user. language_code' + onun i18n.

Performans: PWA + Service Worker, hash-assets, lazy-chunks ilə CDN. İlk ekran ≤ 150-200 KB br.

Mikro-nümunə (ön):

html
<script>
const tg = window. Telegram. WebApp;
tg. expand();
tg. MainButton. setText ('Lobbi açın'). show(). onClick(() => {
//bota siqnal göndərəcəyik (isteğe bağlı) və ya sadəcə SPA tg daxilində route edəcəyik. HapticFeedback. impactOccurred('medium');
});
//fetch ('/api/tg/auth ', {method:' POST ', headers: {' Content-Type ':' application/json '}, body: JSON. stringify({ initData: tg. initData })});
</script>

Təhlükəsizlik: məcburi tədbirlər

Serverdə 'initData' imzasının yoxlanılması. «Təzə pəncərə» saxlayın (məsələn, 1-5 dəqiqə) - köhnə imzaları rədd edin.

Şəxsiyyət dəstəsi: 'telegram _ user _ id' - profil atributudur, lakin pula hər zaman token/sessiya vasitəsilə çıxış.

Botun vebhukları: gizli yol ('/bot 'və ya öz başlığı), IP-allowlist Telegram, taymaut/idempotent.

Anti-bot: device-fingerprint və davranış siqnalları WebApp, rate-limit 'telegram _ user _ id' və IP.

Məzmun təhlükəsizliyi: Mini-app domeni üçün CSP, 'X-Frame-Options' Telegram-da inteqrasiyaya mane olmur, API-yə ciddi CORS.

Log & PII: GDPR/yerli qaydalara görə saxlayın, ödəniş/oyun hadisələri üçün WORM istifadə edin.

Telemetriya və analitika

RUM: WebApp daxilində TTFB/LCP/TTI; события «open_from_deeplink», «auth_ok», «deposit_start/success», «bet_place».

Kanal işarələri: 'startapp' → vasitəsilə referal/utm atın casino sessiyası ilə əlaqə saxlayın.

SLO: p95 'auth _ via _ initData' ≤ 200-300 ms, p95 «birinci ekran» ≤ 2 s, imza yoxlama xətası <0. 1%.

Frod siqnalları: ölkələrə/saatlara/cihazlara görə anomaliyalar, hərəkətsiz kütləvi kəşflər, təkrarlanan 'startapp'.

Tipik backend-kontur (psevdokod)

pseudo
POST /api/tg/auth { initData }
assert verifyTelegramSignature (initData )//ciddi şəkildə Telegram dock let tgUser = parse (initData)
let account = findOrCreateByTelegram(tgUser. id)
let session = issueJWT(account_id, ttl=20m, scope='webapp')
return { token: session. jwt, account }

POST /api/cashier/deposit { token, method, amount }
assert auth(token)
assert geoAllowed(account. country)
createIdempotencyKey()
redirectToPSP (... )//üçün xarici brauzer

POST /api/bot/webhook verifyTelegramSignatureOrSecret()
handle commands, web_app_data, callbacks reply with messages/buttons

Casino üçün Telegram WebApp çek siyahısı

Hüquq və siyasət

Yurisdiksiyalar, geo-blokinq, yerli RG/KYC mətnləri.
Sizin kateqoriya üçün Telegram siyasəti, ölkələrin/kanalların ağ siyahıları.

Autentifikasiya

'initData' imzasının server yoxlaması (təravət pəncərəsi daxil olmaqla).
Link 'telegram _ user _ id account_id', qısa JWT.

Kassa

Xarici brauzerdə bir çek çıxarılması (lazım olduqda), idempotency, KYC/KYT.
Geo-asılı üsullar, bot mesajları status dublyaj.

Frontend

'themeParams', 'MainButton/BackButton', 'expand ()' -dən mövzu/rənglər.
PWA/SW, hash assetləri ilə CDN, LCP ≤ 2 s.

Təhlükəsizlik

Webhook: secret/allowlist/taymaut.
Rate-limits, anti-bot, CSP/CORS.
Pul/oyunlar üçün WORM log; PII maskalanması.

Analitika

RUM metrikası, onbording/kassa/bahis hadisələri.
'startapp' vasitəsilə kanal atributu.

Anti-nümunələr

Server yoxlaması olmadan cəbhədə 'initData' etibar edin.

Siyasət/yurisdiksiyaya məhəl qoymadan WebApp-da tam çeki «sıxışdırmağa» çalışın.

Mövzu/rənglər → Telegram-ın qaranlıq/parlaq mövzusunda oxunmaz.

Bot kassasında və vebhuklarında idempotency olmaması.

Rotasiya və geri çağırılmadan uzunmüddətli sessiyalar.

Monolit bandl 5-10 MB → yavaş ilk ekran və çöp sessiyası.

Telegram WebApp inteqrasiyası casinoya sürətli giriş, rahat rabitə və quraşdırılmamış «yüngül» müştəri verir. Uğur - «initData» vasitəsilə düzgün identifikasiya, hesabın düzgün linki və ödəniş/məzmun siyasətlərinə riayət etməkdə. Yerli UX (mövzu, düymələr, haptika), CDN asset təchizatı, ciddi təhlükəsizlik və ölçülə bilən analitika əlavə edin - və mini app ağrısız miqyaslı effektiv acquisition- və retention kanalı olacaq.