> 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/guides-and-examples/frequently-asked-questions-faqs.md).

# Telebot Creator FAQ

Answers to common Telebot Creator questions: is it free, how to create a bot, commands, libraries, broadcasts, webhooks, transfers and errors.

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

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

Quick answers to the most common questions about Telebot Creator. If your question isn't covered here, ask in the [TBC Community Group](https://t.me/telebotcreatorbetachat).

***

## General Questions

### What is Telebot Creator?

Telebot Creator (TBC) is a free online platform for building, hosting, and managing Telegram bots. It uses TPY (Telebot Python), a custom scripting language based on Python, which includes over 30 built-in libraries for AI integration, cryptocurrency payments, data management, webhooks, and more. More than 240,000 bots are running on the platform, with over 60 million bot users, as of October 2026. You don't need your own server — TBC handles all hosting, scaling, and infrastructure. Points are unlimited and a command execution costs 0 points, so it is completely free to build and run bots. Whether you're a complete beginner or an experienced developer, TBC provides the tools to create anything from simple auto-reply bots to complex AI-powered applications.

### Is Telebot Creator really free?

Yes, Telebot Creator is 100% free to use. Points are unlimited and a command execution costs 0 points, so there is no usage limit. There are no hidden fees, no credit card required, no premium tiers, and no limits on the number of bots you can create. The platform sustains itself through minimal, non-intrusive advertising — just 2-4 broadcast messages per month. All 30+ libraries, the code editor, broadcasting, webhooks, and every feature are available to all users at no charge.

### How do I create my first bot?

Creating your first bot on Telebot Creator takes less than 5 minutes. First, register a free account at telebotcreator.com. Next, open Telegram and message @BotFather — use the `/newbot` command to create a new bot and copy the API token it gives you. Then go to the TBC dashboard, click "Add New Bot," paste your token, and click "Create Bot." Your bot appears on the dashboard in Stopped status. Click on it, go to Commands, add a `/start` command with code like `bot.sendMessage("Hello!")`, save it, and click Start. Your bot is now live on Telegram. For a detailed walkthrough with code examples, see the [Getting Started guide](/getting-started/getting-started.md). Everything about tokens is in the [BotFather guide](/getting-started/botfather-and-bot-token.md), and what the free hosting includes is in [Free Telegram Bot Hosting](/guides-and-examples/free-telegram-bot-hosting.md).

### What are the limitations of the free plan?

The free plan includes unlimited points (a command execution costs 0 points), a maximum of 2 simultaneous broadcasts per bot, and up to 160 seconds of execution time per command. There is a global limit of 1,000 simultaneous broadcasts across all platform users. Scheduled commands are limited to 100 per user per bot, with scheduling possible up to one year in advance. There are no limits on the number of bots you can create, the number of commands per bot, or which libraries you can use. All features including AI integration, blockchain libraries, webhooks, broadcasting, and the full Telegram Bot API are available to every user.

### Is there a limit on points?

No. Points are unlimited and running a command costs 0 points, so a bot never stops because of points. You do not need to check the `left_points` variable in your code.

### Will there be advertisements in my bot?

Telebot Creator uses a minimal advertising model to keep the platform free for everyone. Advertisements appear only 2 to 4 times per month, delivered as a single broadcast message to your bot's users. These ads are non-intrusive and non-repetitive — they won't spam your users or interrupt their experience. This approach is fundamentally different from other bot platforms that insert ads into every bot response or show pop-ups. The TBC team prioritizes user experience, so advertising frequency is kept to an absolute minimum. This revenue model allows the platform to provide free hosting, free libraries, and free points to all users without requiring paid subscriptions or premium tiers.

***

## Commands and Features

### How do I create a command?

Commands are created through the Commands tab in your bot's dashboard. Click "Add Command," enter a command name (like `/start` or `/help`), and write your TPY code in the built-in editor. Every command must have a name and associated code.

```python
# Example /start command
bot.sendMessage("Welcome to my bot! Type /help to see available commands.")
```

Save the command, make sure your bot is started, and test it by messaging your bot on Telegram. Commands can be simple one-line responses or complex multi-step workflows using `Bot.handleNextCommand()`, `Bot.runCommand()`, and `Bot.runCommandAfter()`.

### What is the difference between handleNextCommand and runCommand?

These are two fundamental command flow tools in TBC. `Bot.handleNextCommand("command_name")` tells the bot to wait for the user's next message and then route that message to the specified command — this is how you create multi-step conversations, forms, and interactive flows. `Bot.runCommand("command_name")` executes another command immediately without waiting for user input — useful for redirecting flow, running shared logic, or building modular bots. There's also `Bot.runCommandAfter(seconds, "command_name")` which schedules a command to run after a delay, from 1 second up to 366 days. Understanding these three functions is essential for building any interactive Telegram bot on TBC.

### What are the special commands (\* and @)?

TBC has two special command types. The **wildcard command (`*`)** triggers when a user sends any message that doesn't match a defined command. Use it for fallback responses, AI chatbot logic, or handling free-text input. The **at handler command (`@`)** runs before every other command — use it for preprocessing messages, logging user activity, checking banned users, or setting global variables. Together with `handleNextCommand`, these special commands give you complete control over how your bot handles every possible user interaction.

### Can I execute a command for another bot?

Yes, TBC supports cross-bot communication. You can use the `bot_id` and `api_key` parameters with functions like `libs.Webhook.getUrlFor()`, `Bot.runCommandAfter()`, and `Bot.broadcast()` to execute commands on another bot you own. This enables powerful multi-bot architectures where bots can coordinate actions, share data, and trigger each other's workflows. You need the target bot's ID and the account API key for authentication.

***

## Libraries and Integrations

### How do I integrate AI into my bot?

TBC includes built-in AI libraries for OpenAI and Google Gemini. Here's a quick example using OpenAI:

```python
client = libs.openai_lib.OpenAIClient(api_key="YOUR_OPENAI_KEY")
assistant = libs.openai_lib.AIAssistant(
    openai_client=client,
    model="gpt-4o",
    system_message="You are a helpful assistant."
)
response = assistant.send_message(msg)
bot.sendMessage(str(response.get("content")[0]['text']['value']))
```

TBC also supports Gemini via `libs.gemini_lib` and OpenRouter for access to 100+ AI models. AI commands can run up to 160 seconds, giving plenty of time for complex AI responses. A complete bot, step by step: [How to Make a ChatGPT Telegram Bot](/guides-and-examples/chatgpt-telegram-bot.md).

### How do I accept crypto payments?

Use the `libs.Coinbase` library for Coinbase Commerce payments:

```python
libs.Coinbase.setKeys("API_KEY", "SECRET")
client = libs.Coinbase.post()
payment = client.createCharge({
    "name": "Premium Subscription",
    "description": "Monthly access",
    "local_price": {"amount": "10.00", "currency": "USD"},
    "pricing_type": "fixed_price"
})
bot.sendMessage(f"Pay here: {payment['hosted_url']}")
```

For TON blockchain, use `libs.TonLib`. For EVM chains (Ethereum, Polygon, Arbitrum, etc.), use `libs.web3lib`.

### Can I use multiple libraries in a single bot?

Absolutely. TBC libraries are designed to work together. You can combine `libs.openai_lib` for AI responses, `libs.Coinbase` for payments, `libs.CSV` for data storage, `libs.Webhook` for real-time updates, and `libs.Resources` for user points — all in the same bot. There's no limit to how many libraries you can use simultaneously.

### How do I make HTTP requests to external APIs?

Use the built-in `HTTP` module (recommended) or `libs.customHTTP()`:

```python
# Using built-in HTTP (recommended since 4.9.0)
response = HTTP.get("https://api.example.com/data")
data = response.json()
bot.sendMessage(f"Result: {data}")

# POST request with JSON body
response = HTTP.post("https://api.example.com/submit", json={"key": "value"})
```

***

## Broadcasting

### How does broadcasting work?

Broadcasting sends a message or runs a command for all your bot's users at once. Use `Bot.broadcast()` with either a pre-defined Telegram function (like `send_message`, `send_photo`) or a custom command name. You can broadcast text, photos, videos, files, and more. Each bot can run 2 simultaneous broadcasts, and there's a global limit of 1,000 across all platform users.

```python
# Simple text broadcast
Bot.broadcast(function="send_message", text="Big announcement!")

# Run a command for all users
Bot.broadcast(command="send_promo")
```

### Can I bring my users from another bot platform (for example Bots.Business)?

Yes. Export the user list there, then open the bot in Telebot Creator → **Manage → Import Users** and upload the file. JSON, CSV and plain text are accepted: a column or field with Telegram user IDs (`user`, `user_id`, `telegram_id`, `chat_id`, `id` …) or simply one ID per line. Every ID is then checked with Telegram through your bot, and only users the bot can actually reach are added; nothing already in the bot is changed or removed. The check runs at about 10 users a second, so a list of 90,000 takes a few hours; it continues in the background with progress shown and you can leave the page. Keep the same bot token when you move: Telegram lets a bot reach only people who have started it, so with a new bot nothing would be found until users press Start again.

### Why is my broadcast not working?

The most common reasons are: you already have 2 running broadcasts (the per-bot limit), the command name doesn't exist in your bot, or the broadcast function name is invalid. Check your running broadcasts with `Bot.listBroadcasts()` and stop any completed ones with `Bot.clearBroadcast()`.

***

## Webhooks

### What are webhooks and how do I use them?

Webhooks allow your bot to receive real-time data from external services like payment processors, form submissions, or any system that can send HTTP requests. Generate a webhook URL with `libs.Webhook.getUrlFor()`, give that URL to the external service, and TBC will automatically trigger the specified command when data arrives. Inside webhook commands, the incoming data is available in `options["json"]` and `options["data"]`.

```python
# Generate webhook URL
webhook_url = libs.Webhook.getUrlFor("payment_received", user_id=u)
bot.sendMessage(f"Webhook URL: {webhook_url}")
```

***

## Bot Management

### How do I transfer a bot to another account?

Use the `Bot.Transfer()` function in any command:

```python
result = Bot.Transfer(
    email="NEW_OWNER_EMAIL",
    bot_id=bot_id,
    bot_token=bot_token,
    run_now=True
)
```

Points stay with the original account. The new owner needs their own points. Transferred bots cannot be retrieved unless the new owner transfers them back. Deleted bots can be recovered within 90 days.

### How do I manage multiple bots from one account?

Use the `Account` class (added in version 4.8.0). It provides account-level operations across all your bots:

```python
# List all bots in your account
bots = Account.get_bots_list()

# Save data accessible from any of your bots
Account.saveData("shared_config", {"setting": "value"})

# Get stats across all bots
stats = Account.getStats(time_frames=["24h", "7d"])
```

***

## Points and Billing

### How are points deducted?

They are not. Running a command costs 0 points: `/start`, callback queries, inline queries, webhook triggers, scheduled commands and broadcasts are all free, and so are HTTP requests, saving data and using libraries inside a command.

### What happens if I run out of points?

You cannot run out. Points are unlimited.

***

## Troubleshooting

### Why is my bot not responding?

Common causes: the bot is in Stopped status (click Start), the command name doesn't match what the user sent, or there's a syntax error in your TPY code (check Error Logs). Always check the Error Logs section in your bot's dashboard for specific error messages.

### How do I debug errors?

Use try-except blocks and check the Error Logs:

```python
try:
    result = some_operation()
    bot.sendMessage(f"Success: {result}")
except Exception as e:
    bot.sendMessage(f"Error occurred: {e}")
```

The Error Logs in your bot's dashboard show all runtime errors with timestamps, command names, and error details.
