OMNA

Launch the Mini App

A 5-step checklist to publish OMNA inside Telegram and wire up the bot token.

1. 1

   Publish your OMNA app

   Click Publish in the top-right of the editor. Telegram requires a public HTTPS URL for Mini Apps.

   Your Mini App URL (after publish)

   https://your-app.lovable.app/loginCopy

   The path /login auto-detects Telegram and signs the user in.

2. 2

   Create or open your bot in @BotFather

   On Telegram, open @BotFather and either: @BotFather

   • /newbot — pick a name and username, then copy the HTTP API token.
   • /mybots → choose your bot → API Token.
3. 3

   Add TELEGRAM_BOT_TOKEN as a backend secret

   The token must live on the server — never in client code. Add it once and the verify endpoint picks it up automatically.

   • Open Backend → Secrets in Lovable Cloud.
   • Create TELEGRAM_BOT_TOKEN and paste the BotFather token.
   • Save. The telegram-auth function will use it on the next call.

   Secret name

   TELEGRAM_BOT_TOKENCopy
4. 4

   Register the Mini App with BotFather

   Tell Telegram which URL to load when users tap your bot.

   • In BotFather: /newapp → select your bot.
   • Provide a title, short description, 640×360 photo, and the Mini App URL below.
   • Optional: /setmenubutton → set a "Open OMNA" button pointing to the same URL.

   Web App URL

   https://your-app.lovable.app/loginCopy
5. 5

   Test inside Telegram

   Open your bot in Telegram and tap the menu button. You should land on the OMNA login screen, get authenticated automatically, and be redirected to your dashboard.

   • If nothing happens, re-check step 3 — the token must be set.
   • Outside Telegram, the login button shows the "open from Telegram" notice — that's expected.
   • Your initData is verified server-side via HMAC-SHA256.