Getting Started
Create your first bot in under 5 minutes with our quick start guide.
Flow Builder
Learn how to use blocks, connections, and triggers to build bot logic.
Block Types
Text, buttons, menus, links, images, delays, conditions, loops, API, variables, data storage, and reminders.
Variables
Store user data, personalize messages, and create dynamic flows.
Live Chat
Take over conversations from your bot and chat directly with users.
Billing & Plans
Free vs Pro plans, trial info, and how to upgrade to Pro.
🚀 Getting Started
Create a Telegram Bot
Open Telegram, search for @BotFather, send /newbot, and follow the prompts. Copy the bot token it gives you.
Connect Your Bot
Go to Settings in TeleBotBuilder, paste your bot token, and click Connect. Connecting your first bot starts your 14-day Pro trial.
Build Your First Flow
Go to Flow Builder. A newly connected bot with no flows gets a ready-made /start starter flow: edit its welcome message, or build your own by adding a Trigger block (set to /start) and connecting a Text block to it.
Test It!
Open your bot on Telegram, send /start, and watch your flow execute. You're live!
TeleBotBuilder! ⚡
🔧 Flow Builder
The flow builder is a visual canvas where you create your bot's logic by connecting blocks together.
How It Works
- Drag blocks from the palette on the left onto the canvas
- Connect blocks by clicking an output port (right circle) and dragging to an input port (top circle)
- Edit blocks by clicking on them — the editor panel opens on the right
- Auto-save — your flow saves automatically 2 seconds after every change
- Multiple flows — create up to 20 flows per bot with different triggers on Pro (1 flow on Free)
🧩 Block Types
📩 Trigger (Free)
The starting point of every flow. Trigger types:
/start— when a user sends /start- Custom command — any /command you define; the message must be exactly the command (not case-sensitive)
- Keyword — runs when the message contains the keyword anywhere (not case-sensitive)
- Default — catches messages no other flow matched, at most once per 24 hours per user
If more than one flow matches, /start wins, then commands, then keywords, then the default. On the Free plan only your one active flow responds.
💬 Text (Free)
Send a text message to the user. Supports variables like {{first_name}}. Up to 500 characters on Free, 2000 on Pro.
Wait for Reply (Pro): Toggle this to pause the flow and wait for the user's response. Their reply is saved to a variable you specify.
🔘 Buttons (Free)
Send a message with clickable inline buttons. Each button has its own output port — connect different blocks to create branching conversations. Up to 3 buttons on Free, 8 on Pro.
🖼️ Image (Free)
Send a photo with an optional caption. Paste a direct image URL, or use Upload Image in the block editor (images up to 32MB).
📋 Menu (Free)
Show a persistent keyboard of options under the chat. Each option has its own output port. Up to 3 options on Free, 6 on Pro. If the user types something that isn't an option, the menu is shown again.
🔗 Link Button (Free)
Send a message with a button that opens a web link. The message text counts toward your plan's text limit.
⏱️ Delay (Free)
Pause the flow for up to 30 seconds before continuing to the next block. Longer values are shortened to 30 seconds. To follow up later, use a Reminder block (Pro).
🔀 Condition (Pro)
Branch your flow based on variable values. Operators: ==, !=, >, <, contains, matches.
Has two output ports: True and False. > and < compare numbers; contains is not case-sensitive.
🔁 Loop (Pro)
Repeat a set of blocks multiple times. Two modes:
- Count — repeat N times (max 100)
- Condition — repeat until a variable matches a value
Has two output ports: Loop (each iteration) and Done (loop finished).
🌐 API (Pro)
Call an external REST API that returns JSON. Supports GET, POST, PUT, DELETE. The call times out after 10 seconds and does not follow redirects. The response is saved to a variable (default api_result); if it has a text field, that text is sent to the user.
Response fields are auto-flattened: if the API returns {"name":"Ali"}, you can use {{api_result_name}}.
📦 Set Variable (Pro)
Store data in a variable for use in later blocks. Click the presets panel for quick options like {{user_input}}.
🗄️ Data Storage (Pro)
Save and look up rows in collections you create on the Data page. Blocks: Save Data, Find Data, Find Many (up to 100 rows), Update Data (up to 100 rows), and Delete Data. Find blocks have Found and Not found output ports.
Each bot can have up to 20 collections, each with up to 32 columns and 50,000 rows.
⏰ Reminder (Pro)
Schedule a message for later, from 1 minute to 365 days ahead. Each user can have up to 100 pending reminders.
📦 Variables
Variables let you personalize messages and store user data. Use them anywhere with {{variable_name}} syntax.
Built-in Variables
| Variable | Description |
|---|---|
{{first_name}} | User's Telegram first name |
{{last_name}} | User's Telegram last name |
{{username}} | User's Telegram username (without the @) |
{{telegram_id}} | User's numeric Telegram ID |
{{user_input}} | User's last message text |
name once, use {{name}} anywhere in later flows.
💬 Live Chat
Take over a conversation from your bot and reply directly to users. Live chat is a Pro feature.
How to Use
- Go to the Live Chat page
- Select a contact from the left panel
- Toggle Live Chat ON — the bot pauses for this user
- Type your message and hit Enter to send
- Toggle OFF when done — the bot resumes handling messages
💳 Billing & Plans
Free Plan
- 1 bot
- 1 flow, 15 blocks max
- Trigger, Text, Buttons, Menu, Link Button, Image, Delay blocks
- Up to 3 buttons per block
- 500 character text limit
Pro Plan
- Up to 5 bots
- 20 flows, 100 blocks per flow
- All block types (conditions, loops, API, variables, data storage, reminders)
- Up to 8 buttons per block
- Live chat & broadcasts
- 2000 character text limit
- Wait for user reply
How to Upgrade
Upgrade to Pro from the Upgrade option in the app or on the web dashboard.
❓ FAQ
Can I connect multiple bots?
Yes. The Free plan allows 1 bot; Pro and the trial allow up to 5. Connect more bots in Settings.
What happens when my trial expires?
Your account switches to the Free plan. Your flows and data are saved, but only your one active flow responds, and a flow that uses Pro blocks stops running. Upgrade anytime to reactivate everything.
Is my bot token safe?
Yes. Your token is stored securely on our server and never exposed to the frontend or other users.
Can I use variables in image URLs?
Yes! Use {{variable_name}} in the image URL field to dynamically set images based on user data or API responses.