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.

  1. Starts when someone sends /order
  2. Sends a greeting with their first name
  3. Shows three buttons: Small, Large and Show me the menu
  4. The menu button sends a link to the menu, then shows the sizes again
  5. Asks for the delivery address and remembers it
  6. 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.

BlockWhat it doesPlan
Message
text
Sends a message. It can also wait for the person's answer and remember it.Free
Buttons
buttons
Sends a message with buttons under it. Each button can lead to a different next step.Free
Menu
menu
Shows a keyboard of choices at the bottom of the chat (up to 6). Each choice can lead somewhere else.Free
Image
image
Sends a picture from a web address, with an optional caption.Free
Link button
link
Sends a message with one button that opens a web page.Free
Pause
delay
Waits a few seconds (at most 30) before the next step, like a person typing.Free
Condition
condition
Checks something, for example whether the answer is "yes", and goes one way or the other.Pro
Loop
loop
Repeats some steps a number of times, or until something is true.Pro
Web request
api
Asks another web service for information, for example the weather, and remembers the answer.Pro
Variable
variable
Remembers a value under a name, and can do simple sums such as adding 1.Pro
Save data
storage_save
Saves a row to one of your bot's lists (collections), for example an order or a sign-up.Pro
Find data
storage_find
Looks up one row in a list and goes one way if it is found and another if not.Pro
Find rows
storage_find_many
Looks up all matching rows in a list and counts them.Pro
Update data
storage_update
Changes rows in a list, for example marks an order as paid.Pro
Delete data
storage_delete
Deletes rows from a list.Pro
Reminder
schedule_reminder
Sends a message later (minutes, hours or days from now), or jumps to another step then.Pro
Stars payment
stars_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

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

More guides

AI Telegram Bot Builder Make a No-Code Telegram Bot Telegram Bot Templates Free Telegram Bot Maker Telegram Bot With a Database Telegram Referral Bot