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, images, delays, loops, conditions, API, and variables.
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 globally via card, PayPal, or bKash/Nagad.
🚀 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. Your 14-day Pro trial starts immediately.
Build Your First Flow
Go to Flow Builder, add a Trigger block (set to /start), connect a Text block with your welcome message, and save.
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 (Pro plan) with different triggers
🧩 Block Types
📩 Trigger (Free)
The starting point of every flow. Trigger types:
/start— when a user sends /start- Custom command — any /command you define
- Keyword — matches words in user messages
- Default — catches all unmatched messages (once per 24 hours)
💬 Text (Free)
Send a text message to the user. Supports variables like {{first_name}}.
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.
🖼️ Image (Free)
Send a photo with an optional caption. Paste a direct image URL. Upload images for free at imgbb.com.
⏱️ Delay (Free)
Pause the flow for 1–3600 seconds before continuing to the next block.
🔀 Condition (Pro)
Branch your flow based on variable values. Operators: ==, !=, >, <, contains, matches.
Has two output ports: Yes (condition true) and No (condition false).
🔁 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: Body (each iteration) and Done (loop finished).
🌐 API (Pro)
Call any external REST API. Supports GET, POST, PUT, DELETE. Response is saved to a variable.
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}}.
📦 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 @handle |
{{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.
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 flow, 15 blocks max
- Trigger, Text, Buttons, Image, Delay blocks
- 500 character text limit
Pro Plan — $4.99/month
- 20 flows, 100 blocks per flow
- All block types (conditions, loops, API, variables)
- Live chat & broadcasts
- 2000 character text limit
- Wait for user reply
How to Upgrade
Click Upgrade to Pro in the sidebar or go to telebotbuilder.com/pay.html.
bKash / Nagad (Bangladesh)
Send ৳500 via bKash or Nagad
Send payment to 01881738485 (Personal number).
Copy Your TrxID
After sending, you'll receive a transaction ID (TrxID) in your payment confirmation.
Enter TrxID & Verify
Paste your TrxID on the payment page and click Verify. Pro activates instantly for 30 days.
❓ FAQ
Can I connect multiple bots?
Currently one bot per account. Disconnect your current bot in Settings to connect a different one.
What happens when my trial expires?
Your account switches to the Free plan. Your flows and data are saved — 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.