All templates
Python 3.13

Telegram bot starter

Answers /start, /help and /id and repeats anything else sent to it in a private chat: the plumbing you would write first, with a clear place for your own commands. Telegram delivers every message to the app as an HTTPS request, so the bot can sleep while the chat is quiet and wake for the next message, which is what lets it run on the Free plan. It registers its own webhook on boot, checks a secret header on every update, and has a status page showing the webhook state and the last error. Add a token from @BotFather and redeploy.

Telegram Webhooks Free plan
Deploy this template You will sign in first. We keep your pick.

The source

This template is an ordinary public repository. Read it, fork it, or open a pull request against it. Deploying pulls its default branch and builds it the same way velixir builds your own code.

velixirnet/template-telegram-bot

Once it is live

The template is just a starting point. Clone it, edit it, then ship over the top with the CLI:

velixir deploy

Or add the GitHub Actions workflow from the app's Deploys tab to your repo, and every push to your deploy branch ships a release. Both run the same pipeline this template just went through.