Documentation
Which path is yours?
Botxona is a service that uploads, runs and monitors your Telegram bot. Pick which of the three paths below fits you — the docs follow from there.
1. I already have a bot (ZIP or GitHub)
You already have the bot's code — you wrote it yourself or someone wrote it for you. Start with Deploy your first bot in 10 minutes: get a token from BotFather, zip the files, upload them and pass the checks.
2. I don't have a bot — I'll build one with AI
No programming experience? No problem. Copy a ready-made task from the Prompt library and give it to ChatGPT, Claude or Gemini — they will write the complete code for you. To go deeper into working with AI, see AI assistants.
3. I'm a developer
Go straight to the technical docs: the 6 rules (standards), the botxona.yaml schema and contract.md for AI agents.
Sections
Getting started
Preparing your bot
- Getting a token from BotFather
- Preparing a ZIP
- The 6 standard rules
- Check results
- botxona.yaml — full schema
- Environment variables
- Data and backups
- Connecting via GitHub and auto-deploy
Management
- Sleep mode
- Dashboard tour
- Reading logs (even if you're not a developer)
- Analytics — metrics in plain language
- Errors and fixes
Payments and plans
AI assistants
Technical reference
Frequently asked questions
Do I need to pay to deploy a bot?
Not at first. Every new bot gets a 15-minute free trial — during that time the bot is fully functional and you can test it in Telegram. When the trial ends, you pick a plan and pay to keep it running (How payment works).
Can I do this without knowing how to code?
Yes. Use the Prompt library to have AI write the code, then just zip it up and upload it — you don't need to understand the code.
What if my bot stops working?
Start with Errors and fixes — it covers the 15 most common problems and how to solve them.