Skip to main content

The Workspace

Everything you build lives in the Botgami workspace. Here's a tour of what you'll use.

The code editor​

You write .botgami source in a full code editor with:

  • Autocomplete — node names, builtins, variables, and Telegram fields suggest as you type.
  • Inline error highlighting — mistakes are underlined in place, with a clear message. Your code is checked as you type, so you fix problems before publishing.
  • Hover docs — hover any node or builtin to see its parameters and a short description.

This is the source of truth for your bot. Most authors work here.

The live visual graph​

Next to the editor is a live graph of your flows. Each trigger becomes an entry point, and the steps inside a flow render as connected nodes. The graph updates as you type — it's a read-along map of your bot's logic that makes the shape of a complex flow easy to follow.

The Variables panel​

The Variables panel lists every variable your bot declares, grouped by scope:

  • user.* — persistent per-user state.
  • shared.* — bot-wide state shared across all users.
  • global.* — read-only configuration set once, before publishing.

This is where you set secrets and config — API keys, an admin user id, prices — without hardcoding them in your source. Declare a global.* variable in your blueprint, then fill in its value in the Variables panel.

bot MyBot {
  global api_key: String = ""   // set the real value in the Variables panel
  global admin_id: Number = 0
}
danger

Never paste secrets into your .botgami source. Declare a global.* variable and set the value in the Variables panel. Reference it as global.api_key in your flows.

See Variables and state for the full picture.

The Store​

The Store is where you browse and install reusable pieces:

  • Bots — complete published bots you can clone as a starting point.
  • Libraries — bundled subflow collections (payments, formatting, weather, and more). Open the Libraries tab, find one, and click Add to Bot — it inserts the import line for you and you can call its subflows immediately.

See the Standard Library for what's bundled.

Publish​

When your code is error-free, click Publish to push it live. Botgami keeps your variables in sync so the published bot uses current values.

Next​