Deployka
Sign inStart now
All documentation
PythonExperimental

Telegram Mini App

A backend for a Telegram Mini App — a mini-website that opens right inside Telegram. The Mini App itself (what the user sees) must be deployed separately — e.g. with the "React SPA" template — and its address given in WEBAPP_URL.

  1. 1

    Sign up on Deployka

    If you don't have an account yet — create one in 30 seconds: email and password.

    Create an account →
  2. 2

    Get the values you'll need

    This template needs 2 variables: BOT_TOKEN, WEBAPP_URL. Here's exactly how to get each one.

    BOT_TOKEN
    1. Open Telegram — phone or desktop, doesn't matter.
    2. Search for @BotFather and open it — this is Telegram's official bot for creating bots.
    3. Send it the command /newbot.
    4. It will ask for a name — type anything, e.g. "My First Bot". This is just the display name.
    5. Then it asks for a username — it must end in "bot", e.g. my_first_helper_bot. If it's taken, try another.
    6. BotFather sends back a long string like 123456789:AAHf3x... — that's your token. Select and copy the whole thing.
    7. Paste that token into the BOT_TOKEN field on Deployka.

    Never share this token with anyone — it grants full control over your bot.

    WEBAPP_URL
    1. This is the address of your Mini App — a small site that opens right inside Telegram.
    2. First deploy the Mini App itself as a regular project — e.g. with the "React SPA" or "Landing Page" template.
    3. Copy that project's address (looks like https://name.deployka.dev) from its page in your dashboard.
    4. Paste that address into the WEBAPP_URL field here.
  3. 3

    Deploy it

    Click the button below — it opens the templates page with this template already selected. If it needs variables, paste the values from the step above and click Deploy.

    Deploy "Telegram Mini App"

    Deploy usually takes 20–40 seconds. The project status appears in your dashboard and switches to "running" once it's ready.

  4. 4

    Check that it works

    In @BotFather, open your bot → Bot Settings → Menu Button and set it to your WEBAPP_URL. Then open the bot in Telegram — a button next to the input field will open the Mini App.

    This type of project has no web address of its own — that's expected, not an error.

  5. 5

    Something not working?

    Open the project page in your dashboard → Logs tab — it shows the exact reason (wrong token, code error, missing variable). Still stuck? Contact support right from your dashboard, or via the Telegram bot with /support.

Looking for another template? See the full list in the docs.