Ինչպե՞ ս է կազինոն ինտեգրում Telegram Live App

Ինչու է Telegram Live App խաղատուն

Ցածր շփումը '1-2 տապա' բոտի հետ խոսակցությունից, առանց կայքի որոնման։

Ակնթարթային առաքում 'ճակատը ապրում է ձեր պրոֆիլում, CDN-ի միջոցով։

Կապված Telegram-ի հետ 'օգտագործողի հասկանալի գրանցումը և հաղորդակցման պատրաստ ալիքները (թնդանոթների փոխարեն բոտ հաղորդագրությունները)։
Մարքեթինգի ֆորումը 'հղում' t. me/... "և կոճակները ալիքներում/զրույցներում։

💡 Կարևոր է, որ Telegram-ում գործում են վճարումների և բովանդակության սեփական կանոնները։ Հեմբլինգի համար պահպանեք իրավասությունները, արգելափակեք գեոն և կայքի պայմանները։ Վճարային պայմանագրերի մի մասը ավելի լավ է դուրս բերել արտաքին բրաուզերին (տե՛ ս «Կասա և սահմանափակումներ» բաժինը)։

Ճարտարապետություն, որը կազմված է ինտեգրումից

Բաղադրիչները

1. Bot API շերտը (webhook/long-poling) 'ընդունում է հրամաններ, ընտրացանկերի սաղավարտը, սկսում է SysteApp-ը։

2. Intel App (SPA/PWA) ձեր թողարկման վրա 'լոբբի, պրոֆիլ, պրոմո, թեթև խաղային տեսարաններ, դրամարկղեր։

3. Պլատֆորմային API խաղատուն 'վավերացում, հավասարակշռություն/տոկոսադրույք, բոնուսներ, ձայներիզներ, պատմություններ։

4. Նստաշրջանների/ոսպնյակների պահեստ '«telegram _ user _ id medaccount _ id»։

5. CDN + anti-bot/frod 'մինի դիմումների պաշտպանությունն ու բաշխումը։

Գործարկման հոսքը

Օգտագործողը գրում է bot-ը սեղմում է «Բացել» կոճակը (web _ app)։

Telegram-ը ձեր Direct App-ը կառուցում է հաճախորդի մոտ և փոխանցում է ձեզ 'initExpress "(ստորագրված օգտագործողի/չաթի պարամետրերը)։
Intel Appp-ը ստուգում է ստորագրությունը backende-ի վրա, ստեղծում/վերսկսում է գնումները կազինոյում։

SysteApp-ի գործարկումը 'կոճակներ և deep-link

Տարբերակները

Кнопка в ReplyKeyboard/InlineKeyboard c `web_app: {url: "https://your. ap/tg" + - ը բացում է Telegram-ի ներսում մինի ծրագիր։

Main Mox (BotFather no Mult Button) - «Բացել» մշտական կոճակը։

Deep-link `https://t. me/< bot>? startapp = - հավաքեք մեկնարկային ենթատեքստը (օրինակ ՝ պրոմո/referal/խաղ)։

Խորհուրդ 'օգտագործեք «startapp» անվտանգ փոխանցման համար «մտադրություններ» (ինչ էկրան բացել)։ Ստորագրությունը ստուգելուց հետո որոշեք բովանդակությունն ու իրավունքները։

Վավերացում և ակկաունտի ոսպնյակ

Ի՞ նչ է գալիս App-ում

Telegram հաճախորդը ավելացնում է JS-օբյեկտի պատուհանում 'Telegram։ SysteApp "և" initExpress "տողը/" initSystement Unsafe" - տեղեկատվությունը ֆորումի/զրույցի, ժամանակի և ստորագրության մասին։

Ինչպես հաստատել օգտագործողը

1. Առջևում վերցրեք "Telegram. WebApp. initExpress "և ուղարկեք այն ինչպես ձեր backend.

2. Backende-ում տեղադրված է Telegram ալգորիթմի ստորագրությունը (HMAC-SHA256 տվյալների տողում տվյալների տողի վրա 'ստեղից պատրաստված բանալին։ ճշգրիտ ալգորիթմը Telegram-ի պաշտոնական փաստաթղթերում է)։

3. Եթե ստուգումը հաջողակ է, հանեք "user. id ', «username» և մետատվյալներ կարելի է գտնել կամ ստեղծել «telegram _ user _ id medaccount _ id»։

4. Առջևը տվեք կարճ JWT/նստաշրջանի հոսքը կազինոյի պլատֆորմի վրա (օրինակ ՝ TTL 10-30 րոպե + refresh անվտանգ API)։

💡 Երբեք մի վստահեք «initExpress» առանց սերվերի ստորագրությունը ստուգելու։ Մի օգտագործեք «user _ id» որպես ճշմարտության միակ աղբյուրը։

Տվյալների փոխանակում Windows App

Apple-ից բոտա 'Telegram։ WebApp. sendData(JSON. stringify (payload) "- բոտը կստանա" web _ app _ ext "և կարող է պատասխանել/կոճակի հաղորդագրությանը։

UI-ի իրադարձությունները Intel App-ի ներսում '«MainButton», «BackButton», «HapticFeedback», «oneVent» («themeChanged»	'viewportChanged'	…)`.
Ռուսական մինի ծրագրեր ՝ "Telegram. WebApp. close () "- հարմար է" հաջողությամբ միացումից "հետո։

Pattern: բարդ վիրահատություններ (ձայներ, հավատալիքներ) մենք վարում ենք SysteApp-ում։ bot - գրավիչների/ծանուցումների համար («բոնուսը ակտիվացված է», «KYC հաստատված»)։

Գանձապահը և պլատֆորմների սահմանափակումները

Telegram-ում վճարումները ՝ պլատֆորմը ունի ներկառուցված հիբրիդային մեխանիզմներ և կատեգորիաների առանձին կանոններ։ Հեմբլինգի համար օգտագործեք տեղական օրենքները և Telegram քաղաքականությունը։

Գործնական մոտեցում

Chek-aut բացեք արտաքին զննարկիչում (deeplink 'target = _ blank ") ամբողջական KYC/AML/KYT կոնտուրով և idempotency-բեկորներով։

Համալրման/եզրակացության համար ցույց տվեք միայն ընդունելի մեթոդներ երկրի համար (գեո ֆենսինգ)։

Միշտ կրկնօրինակեք ապացույցները բոտայի զրույցի մեջ (որպես փոխարինող թնդանոթներին)։

UX 'Ինչպե՞ ս անել «ոչ» և արագ

Թեման/գույները 'օգտագործեք "Telegram. WebApp. themeParams "և" colorScheme "(light/dark), փոխեք" themeChanged "-ը։

Ռոտացիան '"MainButton. Setault («Շարունակել»)։ show()`; `BackButton. 07 () «և» onEvent «(» backButox Clicked «,...)»։

Viewport: `Telegram. WebApp. expand()`; հետևեք «viewich Height» (հատկապես iOS)։

Տեղայնացում 'վերցրեք լեզուն' initiOne Unsafe-ից։ user. language _ code '+ իր i18n.

Արտադրողականությունը ՝ PWA + WindoWorker, CDN, hash-ասետներով, lazy-chunks։ Առաջին էկրանը 150-200 ՔԲ-ն է։

Միկրո օրինակ (ճակատը)

html
<script>
const tg = window. Telegram. WebApp;
tg. expand();
tg. MainButton. Setault («Բացել լոբբի»)։ show(). onClick(() => {
//ուղարկենք բոտայի ազդանշանը (պարտադիր չէ) կամ պարզապես SPA tg-ի ներսում։ HapticFeedback. impactOccurred('medium');
});
//փոխանցենք initPro սերվերին fetch ('/api/tg/auth «,» method: «POST», headers: <<Entertaint-Type ': <application/json' com, body: JSON։ stringify({ initData: tg. initData })});
</script>

Անվտանգություն 'պարտադիր միջոցներ

«InitExpress» ստորագրության ստուգումը սերվերի վրա։ Պահեք «թարմ պատուհանը» (օրինակ ՝ 1-5 րոպե) հին ստորագրությունները մերժեք։

Նույնականության կապը '«telegram _ user _ id» - ռուսական, բայց փողի հասանելիությունը միշտ ձեր հոսանքի/միջոցով է։

Bebhuks bota: Գաղտնի ճանապարհ ('/bot > կամ սեփական վերնագիր), IP-alowlist Telegram, թայմաուտներ/idempotenty։

Anti-bot: device-fingerprint և System App-ում վարքագծային ազդանշաններ, rate-limit 'telegram _ user _ id "և IP։

Բովանդակության անվտանգությունը 'CSP-ը մինի-ախտի տիրույթի համար, «X-Frame-Options» -ը չի խանգարում Telegram-ում կառուցել, խիստ SNS-ը API-ին։

Լոգներն ու PII 'դիմակավորված, պահեք GDPR/տեղական ստանդարտներով, օգտագործեք WORM-ը ստացիոնար/խաղային իրադարձությունների համար։

Թելեմետրիա և վերլուծություն

RUM: TTFB/LCP/TTI-ի ներսում։ события «open_from_deeplink», «auth_ok», «deposit_start/success», «bet_place».

Կանալային պարամետրերը 'անցեք referala/utm «startapp» -ի միջոցով, կապեք կազինոյի նստաշրջանի հետ։

SLO: p95 'auth _ via _ initExpress' 24200-300 ms, p95 «առաջին էկրանը» 242 s, ստորագրության ստուգման սխալը <0։ 1%.

Ֆրոդ ազդանշաններ 'անոմալիաներ երկրներով/ժամացույցներով, զանգվածային հայտնագործություններ առանց գործողությունների, որոնք կրկնում են «startapp»։

Տիպիկ backend-71 (կեղծ)

pseudo
POST /api/tg/auth { initData }
as.verifyTelegram Signature (initExpress )//խստորեն Telegronlet tgUser = parse (initExpress) չափաբաժիններով։
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()
redirectum PSA (... )//արտաքին զննարկչի մեջ

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

Telegram Express App-ի գործարկման թուղթը կազինոյի համար

Իրավունք և քաղաքականություն

Իրավասություններ, գեո բլոկինգ, RG/KYC տեքստերը լոկալներում։
Telegram քաղաքականությունը ձեր կատեգորիայի համար, երկրների սպիտակ ցուցակները/ալիքները։

Վավերացում

Ստորագրության սերվերային ստուգում «initExpress» (ներառյալ թարմության պատուհանը)։
Լինկովկա 'telegram _ user _ id www.account _ id ", կարճ JWT։

Գանձապահը

Չեկի ելքը արտաքին զննարկչի (որտեղ պետք է), idempotency, KYC/KYT։
Գեո կախված մեթոդներ, բոտային հաղորդագրությունների արձանների կրկնօրինակումը։

Ֆրոնտենդը

Թեման/գույները «themeParams», «MainButton/BackButton», «expand ()»։
PWA/SW, CDN hash-Assets, LCP 242 վրկ։

Անվտանգություն

Webhuki: Գաղտնիք/allowlist/թայմաուտներ։
Rate-limits, anti-bot, CSP/MSS։
Logs WORM փողի/խաղերի համար; PII դիմակավորում։

Վերլուծություն

RUM չափումներ, ուռուցքաբանության/տոմսարկղերի իրադարձություններ/2019։
Կանալ անջատումը «startapp» -ի միջոցով։

Anti-patterns

Վստահել «initExpress» -ի առաջնագծում առանց սերվերացման։

Փորձել «նետել» ամբողջական չեկ-աուտը International App-ում, անտեսելով քաղաքականությունը/իրավասությունը։
Hardocodation թեմայի/գույների մասին կարդացված չէ Telegram-ի մութ/պայծառ թեմայում։
Idempotency-ի բացակայությունը տոմսարկղում և վեբհուկներում։
Երկարատև նստաշրջաններ առանց հավատարմագրման և հետ կանչելու։
Մոնոլիտ ավազակը 5-10 ՄԲ-ն է, որը պատրաստեց դանդաղ առաջին էկրանը և շեղեց նստաշրջանները։

Telegram International App-ի ինտեգրումը տալիս է խաղատուն արագ շարժիչ, հարմար հաղորդակցություն և «թեթև» հաճախորդ առանց տեղադրման։ Հաջողությունը ճիշտ տարբերակում է «initExpress» -ի միջոցով, հաշիվի կոկիկ ոսպնյակի և վճարումների/բովանդակության քաղաքական քաղաքականության միջոցով։ Ավելացրեք niational UX (թեման, կոճակները, հապտիկան), CDN-ռուսական ասետները, խիստ անվտանգությունը և չափված վերլուծությունը, և մինի-ծրագիրը կդառնա արդյունավետ acquisition- և retention-ալիքը, որը մեծանում է առանց ցավի։