Guides¶
You've got a bot running. Now you're staring at Bot, Api, HTTP, webhooks, and webapps wondering which one actually does what you need. These pages are your decision tree.
They sit between the Command Flow guides (how commands work) and the reference sections (method lists and variable docs).
What are these guides?¶
These pages answer questions that come up once you've got a bot running but aren't sure which tool to reach for — command interactions, instance comparisons, and choosing the right web surface.
| You get | You skip |
|---|---|
| "When to use X" decision tables | Reading every reference page |
| Side-by-side comparisons | Trial-and-error tool picking |
| Links to the right deep dive | Getting lost in method lists |
New to TBL?
Haven't built a bot yet? Start with Getting Started → Your First Bot. Quick intro: Learning TBL.
Command & interaction guides¶
| Guide | When to read |
|---|---|
| Command Flow | Understand matching, execution, fields |
| Handling Callbacks | Inline buttons, answerCallbackQuery, edit message |
| Markdown & Formatting | Bold/italic answers, md2html |
| Public Web Commands | Static is_web pages per bot |
| Handling User Input | Multi-step input flows |
Instance comparison¶
Bot vs Api — lives in the sidebar after the Bot and Api sections. Read those overviews first, then use the comparison when both objects start to blur together.
Choosing a web surface¶
Not sure whether you need a webhook, webapp, or static page? Start here:
| Need | Use |
|---|---|
| Static landing page | Public web (is_web) |
Dynamic API with db | Webapp |
| Signed per-user action | User webhook |
| Cron / system trigger | Global webhook |
Where to go next¶
Haven't built a bot yet? Getting Started → Your First Bot.
For context in every command: Global Variables.
For instance reference: Bot, Api, Bot vs Api.