AI Blueprints: build a Telegram bot with ChatGPT or Claude
Describe your bot to ChatGPT or Claude, paste the answer into TeleBotBuilder, and your bot is ready to run. No code, no drag and drop needed to get started.
What is a blueprint?
A blueprint is a whole bot flow written as text: what starts it, every message and button, and where each button leads. TeleBotBuilder turns a blueprint into a flow you can see and change in the visual editor, and any saved flow can be turned back into a blueprint.
Because a blueprint is plain text, a chat AI can write one for you. TeleBotBuilder gives the AI exact instructions, checks its answer before anything is saved, and tells you in plain words what to fix if something is wrong.
How it works in 3 steps
Copy the AI prompt
In TeleBotBuilder, open Import blueprint and press Copy AI prompt. You can also copy the prompt on this page.
Describe your bot to ChatGPT or Claude
Paste the prompt into a new chat, then say in your own words what the bot should do.
Paste the answer into TeleBotBuilder
Copy the AI's answer, paste it into Import blueprint, check the summary and press Import.
Nothing in your bot changes until you press Import. You can import as a new flow or replace an existing one, and the replaced flow is kept as a previous version you can restore.
A complete example
This blueprint is a small pizza order bot. Someone sends /order, picks a size with a button, sends their address, and gets a confirmation. It uses only blocks that work on the Free plan.
- Starts when someone sends /order
- Sends a greeting with their first name
- Shows three buttons: Small, Large and Show me the menu
- The menu button sends a link to the menu, then shows the sizes again
- Asks for the delivery address and remembers it
- Waits two seconds, then confirms the order with the address
{
"telebot": 1,
"name": "Pizza order",
"trigger": {
"type": "command",
"command": "/order"
},
"blocks": [
{
"id": "welcome",
"type": "text",
"text": "Hi {{first_name}}! Let's get your pizza ready.",
"next": "pick_size"
},
{
"id": "pick_size",
"type": "buttons",
"text": "Which size would you like?",
"buttons": [
{
"text": "Small",
"next": "ask_address"
},
{
"text": "Large",
"next": "ask_address"
},
{
"text": "Show me the menu",
"next": "menu_link"
}
]
},
{
"id": "menu_link",
"type": "link",
"text": "Here is our full menu.",
"label": "Open the menu",
"url": "https://example.com/menu",
"next": "pick_size"
},
{
"id": "ask_address",
"type": "text",
"text": "Where should we deliver it? Please send your address.",
"waitForReply": true,
"replyVar": "address",
"next": "thinking"
},
{
"id": "thinking",
"type": "delay",
"seconds": 2,
"next": "confirm"
},
{
"id": "confirm",
"type": "text",
"text": "Thank you, {{first_name}}! Your pizza is on its way to: {{address}}"
}
]
}
The same example as a file: /blueprints/example.json.
The blocks you can use
A blueprint can use 17 kinds of blocks. 10 of them need the Pro plan (or a free trial). If a blueprint uses Pro blocks on the Free plan, the import says so before anything is saved.
| Block | What it does | Plan |
|---|---|---|
Messagetext | Sends a message. It can also wait for the person's answer and remember it. | Free |
Buttonsbuttons | Sends a message with buttons under it. Each button can lead to a different next step. | Free |
Menumenu | Shows a keyboard of choices at the bottom of the chat (up to 6). Each choice can lead somewhere else. | Free |
Imageimage | Sends a picture from a web address, with an optional caption. | Free |
Link buttonlink | Sends a message with one button that opens a web page. | Free |
Pausedelay | Waits a few seconds (at most 30) before the next step, like a person typing. | Free |
Conditioncondition | Checks something, for example whether the answer is "yes", and goes one way or the other. | Pro |
Looploop | Repeats some steps a number of times, or until something is true. | Pro |
Web requestapi | Asks another web service for information, for example the weather, and remembers the answer. | Pro |
Variablevariable | Remembers a value under a name, and can do simple sums such as adding 1. | Pro |
Save datastorage_save | Saves a row to one of your bot's lists (collections), for example an order or a sign-up. | Pro |
Find datastorage_find | Looks up one row in a list and goes one way if it is found and another if not. | Pro |
Find rowsstorage_find_many | Looks up all matching rows in a list and counts them. | Pro |
Update datastorage_update | Changes rows in a list, for example marks an order as paid. | Pro |
Delete datastorage_delete | Deletes rows from a list. | Pro |
Reminderschedule_reminder | Sends a message later (minutes, hours or days from now), or jumps to another step then. | Pro |
Stars paymentstars_payment | Sells a digital product for Telegram Stars and goes one way when paid and another when cancelled. Works on every plan. Real Stars payments need a paid Pro plan; on other plans it runs in demo mode. | Free |
The AI prompt
Copy this prompt into ChatGPT or Claude, then describe your bot. Inside TeleBotBuilder, the Copy AI prompt button gives you the same prompt made for your own bot and plan, including the variables and saved lists it already has.
You are writing a chatbot flow for TeleBotBuilder, a Telegram bot builder.
Reply with ONE code block containing a single JSON object in the "telebot": 1
blueprint format described below, and nothing else. No comments inside the JSON.
FORMAT
{
"telebot": 1,
"name": "<short flow name>",
"trigger": {"type": "command", "command": "/something"},
"collections": [{"name": "orders", "scope": "per_user", "columns": ["size", "address"]}],
"variables": ["names this flow reads but another flow sets"],
"blocks": [{"id": "welcome", "type": "text", "text": "Hi {{first_name}}!", "next": "<id>"}]
}
- The flow starts at the first block in "blocks".
- trigger.type is one of: start, command, keyword, default, start_payload, any_message.
A command trigger needs "command" (a slash, then lowercase letters, digits or underscores; not /start).
A keyword trigger needs "keyword". "start" answers /start.
- Block ids: lowercase letters, digits and underscores, unique.
- "next" is the block that runs after this one; leave it out to end the flow there.
- buttons and menu blocks: put "next" on each button or option instead.
- Branching blocks use "branches": condition {true, false}; loop {body, done}; storage_find {found, not_found}; storage_find_many {found, not_found}; stars_payment {paid, cancelled}.
- Every block must be reachable from the first block.
BLOCKS YOU MAY USE (fields; * = required; = default)
- text: Sends a message; can wait for the reply and store it. Fields: text*, waitForReply, replyVar="user_reply", showBack. Edges: "next".
- buttons: Sends a message with inline buttons; each button is an output port. Fields: text*, buttons*[{text*, next}], showBack. Edges: "next" on each item (at most 8).
- menu: Shows a reply keyboard of options; each option is an output port. Fields: text, options*[{text*, next}], showBack. Edges: "next" on each item (at most 6).
- image: Sends a photo from a URL, with an optional caption. Fields: url*, caption, showBack. Edges: "next".
- link: Sends a message with one button that opens a URL. Fields: text*, label*, url*. Edges: "next".
- delay: Waits a few seconds before the next block. Fields: seconds=5. Edges: "next".
- condition: Compares a variable with a value and branches true/false. Fields: varName*, operator (==|!=|>|<|contains|matches), value. Edges: branches: true, false.
- loop: Repeats its body a number of times, or until a condition holds. Fields: loopType (count|condition), count=3, condVar, condOp (==|!=|>|<|contains|matches), condVal. Edges: branches: body, done.
- api: Calls an external HTTP API and stores the response in variables. Fields: method (GET|POST|PUT|DELETE), url*, headers="{}" (object), body="{}" (object), responseVar="api_result", responsePath. Edges: "next".
- variable: Sets a variable; spaced arithmetic like {{n}} + 1 is calculated. Fields: varName*, value. Edges: "next".
- storage_save: Saves a new row to a collection. Fields: collection*, values[{column*, value}], resultVar="saved_row". Edges: "next".
- storage_find: Finds one row; branches found/not_found. Fields: collection*, conditions[{column*, operator, value}], resultVar="row". Edges: branches: found, not_found.
- storage_find_many: Finds matching rows; sets a count; branches found/not_found. Fields: collection*, conditions[{column*, operator, value}], resultVar="rows". Edges: branches: found, not_found.
- storage_update: Changes the listed columns of matching rows. Fields: collection*, values*[{column*, value}], conditions[{column*, operator, value}], resultVar="updated". Edges: "next".
- storage_delete: Deletes matching rows. Fields: collection*, conditions[{column*, operator, value}], resultVar="deleted". Edges: "next".
- schedule_reminder: Schedules a message, or a jump to another block, for later. Fields: delayValue*, delayUnit (minutes|hours|days), text, target, resultVar="reminder". Edges: "next".
- stars_payment: Sells a digital product for Telegram Stars; branches paid/cancelled. Fields: title*, description*, price=50, photoUrl, productKey, resultVar="payment". Edges: branches: paid, cancelled (both required).
LIMITS: at most 99 blocks; message text at most 2000 characters;
at most 8 buttons per message; menus at most 6 options.
VARIABLES
- Insert values as {{name}}. Built in: first_name, last_name, username, telegram_id, bot_username, today, user_input, start_payload, command_args, random_code, random_number.
- Names the flow sets itself also work: a text block's replyVar, a variable block's varName,
and storage or API results as {{<resultVar>_<column>}}.
- This bot already has these variables, set by its other flows: none listed here. In TeleBotBuilder, the "Copy AI prompt" button lists the variables your bot's other flows already set.
If you read one of them, list it in "variables".
- A condition's "value" is compared as written; never put {{variables}} in it.
- Name fields (varName, replyVar, resultVar, responseVar, condVar) take a plain name without braces.
COLLECTIONS (saved data)
- The bot already has: none listed here. In TeleBotBuilder, the "Copy AI prompt" button lists your bot's saved lists (collections) and their columns.
Reuse one when it fits; name it in a block's "collection".
- You may declare up to 3 new collections in "collections" (column names: lowercase letters, digits, underscores).
RULES
- Use only the block types and fields listed above. Never invent any.
- API blocks may call only public https URLs. Never put real keys or passwords in the
blueprint; write a placeholder like "<<YOUR_API_KEY>>" where one belongs.
- Write the bot's messages in the language of my request. Keep them short and friendly.
- Output JSON only, inside one ```json code block.
Now ask me what the bot should do, then answer with the blueprint.
Share a bot with a link
Made a bot others could use? Open the flow's menu and choose Share this flow. You get a private link to copy. For safety the link is shown only once, and you can get a new link at any time. Anyone who opens it sees the steps in plain words and can press Use this bot to import a copy into their own account. Keys and passwords are never shared, and you can turn a link off whenever you like.
For developers and AI tools
- JSON Schema of format version 1:
/blueprints/spec-v1.json - A complete example:
/blueprints/example.json - A short summary for AI assistants:
/llms.txt
Questions
Is it free?
Yes. Copying the AI prompt, importing a blueprint and sharing a link work on every plan, including Free. Some blocks, such as saving data or calling a web service, need the Pro plan; the import tells you which ones before anything is saved.
Which AI works?
ChatGPT and Claude both work well, and so does any other chat AI that can follow instructions and write JSON. Paste the whole prompt first, then describe your bot.
What if the import fails?
TeleBotBuilder checks the blueprint before it saves anything and lists each problem with its line. Press Copy fix request for ChatGPT, paste it into the same chat, and paste the corrected answer back. Nothing changes in your bot until the check passes.
Do I need to know how to code?
No. You describe the bot in your own words and the AI writes the blueprint. You can then change every message and button in the visual editor.
Are my passwords or API keys safe when I export or share?
Yes. When a flow is exported or shared, values that look like keys, tokens or passwords are replaced with placeholders such as <<YOUR_API_KEY>>. The person who imports it fills in their own.
Can I share a bot I made?
Yes. Use Share this flow to get a private link. Anyone with the link sees the steps and can press Use this bot to import a copy into their own account. You can turn the link off or get a new link at any time.
Build your first bot with AI
Sign in, connect your Telegram bot, and import your first blueprint in a few minutes.
Start with a free 14-day Pro trial: no credit card, it begins when you connect your bot.
Try it free