> For the complete documentation index, see [llms.txt](https://help.telebotcreator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.telebotcreator.com/getting-started/readme.md).

# Telebot Creator Docs: Build Telegram Bots

Official Telebot Creator documentation: create, host and manage Telegram bots for free with TPY, 30+ libraries, AI, payments, broadcasts and ads.

*Telebot Creator Documentation — Platform v7.1.2 · Telegram Bot API 10.1*

*Last updated: October 2026 | Maintained by Telebot Creator Team*

## What is Telebot Creator?

Telebot Creator (TBC) is a **free platform for building, hosting, and managing Telegram bots**. You don't need your own server, you don't need to pay anything, and you can go from zero to a live bot in under 5 minutes.

TBC uses **TPY (Telebot Python)**, a custom scripting language based on Python. TPY comes with **30+ built-in libraries** for AI, payments, blockchain, data management, webhooks, and more — so you can build powerful bots without installing anything.

### Platform Statistics (2026)

| Metric                   | Value        |
| ------------------------ | ------------ |
| **Bots Running**         | 240,000+     |
| **Total Bots Created**   | 420,000+     |
| **Bot Users**            | 60,000,000+  |
| **TBC Platform Version** | 7.1.2        |
| **Telegram Bot API**     | 10.1         |
| **Libraries**            | 30+ built-in |

> **Two version numbers, two different things.** The **TBC platform version** (currently **7.1.2**) tracks the Telebot Creator product itself — its TPY runtime, libraries, dashboard, and services. The **Telegram Bot API version** (currently **10.1**) tracks how much of Telegram's official Bot API the `bot` object supports. They are independent: a platform release can ship without changing the Bot API level, and a Bot API bump can ship without a platform version change.

***

## Quick Start — Create a Bot in 5 Minutes

1. **Register** — Create a free account at [telebotcreator.com](https://telebotcreator.com/register).
2. **Get a Bot Token** — Open Telegram, message [@BotFather](https://t.me/BotFather), use `/newbot`, and copy the API token.
3. **Add Your Bot** — On the TBC dashboard, click **"Add New Bot"**, paste your token, and click **"Create Bot"**.
4. **Write Your First Command** — Click on your bot, go to Commands, add a `/start` command with this code:

   ```python
   bot.sendMessage("Hello! Welcome to my bot 🚀")
   ```
5. **Start Your Bot** — Click the Start button. Your bot is now live on Telegram!

> **Need help?** Join the [TBC Community Group](https://t.me/telebotcreatorbetachat) on Telegram.

***

## What Are Commands?

Commands are the building blocks of every TBC bot. When a Telegram user sends a message like `/start` or `/help`, your bot runs the TPY code you wrote for that command.

```python
# /start command example
first_name = message.from_user.first_name
bot.sendMessage(f"Hey {first_name}! Welcome to my bot. Use /help to see what I can do.")
```

Commands can:

* Send text, photos, videos, files, stickers, and more
* Ask for user input and process it step by step
* Store and retrieve user data
* Make HTTP requests to external APIs
* Accept payments via crypto or traditional gateways
* Run AI models (GPT-4, Gemini, etc.)
* Schedule tasks up to 1 year in the future
* Broadcast messages to all your bot's users

***

## What is TPY?

**TPY (Telebot Python)** is TBC's custom scripting language. If you know basic Python, you already know TPY. If you don't know Python, TPY is simple enough to learn in a few hours.

**Key features:**

* **Python-based syntax** — Variables, if/else, loops, functions, try/except all work the same way
* **30+ built-in libraries** — AI (OpenAI, Gemini), payments (Coinbase, TON), data (CSV, Resources), HTTP, webhooks, and more
* **Pre-defined variables** — `msg`, `message`, `bot`, `Bot`, `User`, `Account`, `params`, `u`, `options` are ready to use
* **Sandboxed environment** — Each bot runs in isolation. No `eval()`, `exec()`, or system module access for security
* **Up to 160 seconds** execution time per command

***

## It's Free — Unlimited Points

Bot hosting on TBC is free and there is no usage limit:

| Feature              | Details                    |
| -------------------- | -------------------------- |
| **Points**           | Unlimited                  |
| **Cost Per Command** | 0 points                   |
| **Hidden Fees**      | None — it's genuinely free |

Running a command (like responding to `/start`) costs 0 points, so your bots can run as many commands as they need.

### Advertising Policy

TBC keeps the platform free through minimal, non-intrusive advertising:

* Ads appear only **2-4 times per month** as a single broadcast message
* No continuous spam or pop-ups
* Your bot users get an uninterrupted experience

***

## Key Features at a Glance

| Feature                   | Description                                                                                                                             |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Free Hosting**          | No servers to manage. TBC hosts your bots for free.                                                                                     |
| **Telebot Creator AI**    | An AI assistant in the dashboard that builds, edits, tests and debugs your bots from a chat                                             |
| **Monetization**          | Optional rewarded ads: you earn when your users watch them ([guide](/libraries-and-integrations/monetization.md))                       |
| **Mini Apps**             | Open web apps inside Telegram from your bot and get their data back ([guide](/core-reference/mini-apps.md))                             |
| **Auto-Translation**      | Bot messages translated into 92 languages ([guide](/libraries-and-integrations/auto-translation.md))                                    |
| **AI Integration**        | Built-in OpenAI (GPT-4o), Gemini, and OpenRouter support                                                                                |
| **Crypto Payments**       | Coinbase Commerce, TON blockchain, Web3 (all EVM chains)                                                                                |
| **Broadcasting**          | Send messages to all bot users at once                                                                                                  |
| **Scheduled Commands**    | Schedule actions from 1 second to 366 days ahead                                                                                        |
| **Webhooks**              | Real-time integrations with external services                                                                                           |
| **Data Storage**          | User-level and bot-level data storage, CSV files, Resources system                                                                      |
| **Multi-Bot Management**  | Manage all bots from one account using the Account class                                                                                |
| **Bot Transfer**          | Transfer bot ownership to another account                                                                                               |
| **Bot Recovery**          | Recover deleted bots within 90 days                                                                                                     |
| **Inline Queries**        | Handle inline mode, callback queries, payments, and all Telegram update types                                                           |
| **Telegram Bot API 10.1** | Full coverage of the latest Telegram features — Gifts, Stories, Business accounts, Checklists, Suggested posts, Verification, and Stars |
| **Image Processing**      | OpenCV and Pillow libraries for image manipulation                                                                                      |
| **Code Editor**           | Built-in TPY code editor with syntax highlighting and autocomplete                                                                      |
| **Bot Export / Import**   | Export a bot to a portable file, import it back, and round-trip through the AI assistant                                                |
| **Docs MCP Server**       | Public Model Context Protocol endpoint so any AI assistant can read the live TBC docs                                                   |

***

## Built-in Libraries

TBC includes 30+ libraries you can use directly in your code — no installation needed:

| Category       | Libraries                                                                                            |
| -------------- | ---------------------------------------------------------------------------------------------------- |
| **AI**         | `libs.openai_lib` (GPT-4o, Assistants API), `libs.gemini_lib` (Gemini Flash/Pro), OpenRouter support |
| **Payments**   | `libs.Coinbase`, `libs.Coinpayments`, `libs.Oxapay`, `libs.MDxchange`                                |
| **Blockchain** | `libs.TonLib` (TON), `libs.web3lib` (all EVM chains), `libs.Crypto`                                  |
| **Data**       | `libs.CSV`, `libs.Resources` (points, credits, leaderboards)                                         |
| **Media**      | `libs.OpenCV`, `libs.Pillow`                                                                         |
| **HTTP**       | `libs.customHTTP`, built-in `HTTP` module                                                            |
| **Webhooks**   | `libs.Webhook`                                                                                       |
| **Utilities**  | `libs.Random`, `libs.DateAndTime`                                                                    |

***

## The New UI (Version 2)

Telebot Creator now features a modern, redesigned dashboard:

* **Dark theme** with a clean, professional design
* **Bot management** — Add, start, stop, and delete bots from one screen
* **Command editor** — Built-in TPY code editor with syntax highlighting, autocomplete, and AI-powered code suggestions
* **Error logs** — View and debug command errors with timestamps
* **Settings** — Update bot tokens, manage transfers, and configure bot options
* **Notifications** — Real-time alerts for bot events
* **Mobile-friendly** — Fully responsive design that works on all devices

***

## All Documentation Pages

* [How to create a Telegram bot: quick start](/getting-started/getting-started.md)
* [BotFather: create a bot and get its token](/getting-started/botfather-and-bot-token.md)
* [AI Telegram bot builder](/getting-started/ai-telegram-bot-builder.md)
* [Telegram bot commands in TPY](/getting-started/command-in-tpy.md)
* [TPY language reference](/core-reference/tpy-language-reference.md)
* [TPY method index](/core-reference/tpy-method-index.md)
* [Built-in libraries](/core-reference/tbc-libraries-libs.md)
* [Bot features](/core-reference/bot-features-and-functionalities.md)
* [Keyboards and buttons](/core-reference/keyboards-and-buttons.md)
* [Files and media](/core-reference/files-and-media.md)
* [Payments: Telegram Stars and invoices](/core-reference/payments.md)
* [Telegram Mini Apps](/core-reference/mini-apps.md)
* [Advanced features](/core-reference/advanced-features.md)
* [Broadcast to all bot users](/libraries-and-integrations/broadcast-function-in-tbc.md)
* [Monetization with rewarded ads](/libraries-and-integrations/monetization.md)
* [Build bots with AI (MCP server)](/libraries-and-integrations/mcp-server.md)
* [Auto-translation into 92 languages](/libraries-and-integrations/auto-translation.md)
* [Coinbase payments](/libraries-and-integrations/coinbase-library-tbc.md)
* [TON blockchain](/libraries-and-integrations/ton-library-documentation.md)
* [Crypto libraries (Web3, EVM)](/libraries-and-integrations/crypto-libraries-documentation.md)
* [Example bots and use cases](/guides-and-examples/real-world-use-cases.md)
* [How to make a ChatGPT Telegram bot](/guides-and-examples/chatgpt-telegram-bot.md)
* [How to add a bot to a Telegram group or channel](/guides-and-examples/how-to-add-a-bot-to-a-telegram-group.md)
* [Free Telegram bot hosting](/guides-and-examples/free-telegram-bot-hosting.md)
* [Tips and troubleshooting](/guides-and-examples/tips-best-practices-and-troubleshooting.md)
* [FAQ](/guides-and-examples/frequently-asked-questions-faqs.md)
* [Glossary](/guides-and-examples/glossary-and-key-concepts.md)

***

## Community & Support

* **Telegram Help Group**: [t.me/telebotcreatorbetachat](https://t.me/telebotcreatorbetachat)
* **Documentation**: [help.telebotcreator.com](https://help.telebotcreator.com)
* **ChatGPT AI Assistant**: [Telebot Creator AI GPT](https://chatgpt.com/g/g-67ce8f8e7da081918cc244a92dc5aa55-telebot-creator-ai)
* **Website**: [telebotcreator.com](https://telebotcreator.com)