Telegram Mini App
Open a HomeGame24 session inside Telegram so players sign in with Telegram identity — no username/password form. Each account configures its own bot.
What you need
- A Telegram bot from BotFather, with the Mini App URL pointed at your game play host (
…/play). - Bot token saved under Admin → Integrations (per account — not shared with other tenants).
- A game session with Allow Player Registration enabled and Player Login Method set to Telegram Mini App.
Share the session
Copy the session play link from the panel (/play?s=<session_id>), or send a bot deep link:
https://t.me/<your_bot>/<mini_app>?startapp=<session_id>
session_id is the 26-character run id from the panel.
Player experience
- Player opens the link inside Telegram.
- The game loads in the Telegram WebView.
- Sign-in is automatic via Telegram identity.
- Same client UX as the browser (join, play, chat).
If someone opens the same play URL in a normal browser while the session is Telegram-only, they see a prompt to open it from Telegram instead.
For developers
| Step | Detail |
|---|---|
| Account bot | GET/PATCH /api/me/integrations (token never returned; telegram_bot_token_set only) |
| Session option | options.login_method = "telegram" |
| Private auth | POST /_private/player-auth/telegram with client_id, session_id, init_data |
| Game proxy | POST /auth/telegram with session_id, init_data |
| Token shape | Same player JWT as password / OTP |
Also see the Integration API docs for roster and session automation (separate from Mini App auth).
Safety
HomeGame24 hosts social / play-money games — not real-money gambling. Telegram Stars payments are not part of this login flow.