> ## Documentation index
> Fetch the complete documentation index at: https://tgcloud.docs7.io/llms.txt
> Ask it with GET https://tgcloud.docs7.io/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.

# Быстрый старт

> От нуля до живого бота за пять минут диалога

# Быстрый старт

## 1. Токен

@BotFather → ваш бот → **Serverless → CLI Access → Access token**.
Формат `app<id>:<secret>`. Это не Bot API токен (`123456:AA…`).
Сначала включите Serverless у этого бота.

## 2. Диалог с агентом

```
Вы:    создай бота в ~/bots/echo
Агент: create_project → попросит CLI access token → login_bot
       → поправит tgcloud/handlers/message.js → push → webhook_sync
```

Бот жив. Проверка логики без живого чата:

```
Агент: run_handler { module: 'handlers/message', args: '{ chat: { id: 1 }, text: "hi" }' }
```

`run_handler` запускает и endpoints. Init data передаётся в `ctx`.

## 3. Что дальше

- [Инструменты](tools.ru) — все 16 команд
- [Безопасность](security.ru) — guardrails и токены
- [Кукбук](cookbook.ru) — бот с базой, кнопками и Mini App

После правок фронтенда агент вызывает `deploy` (сборка, затем push).
Обычный `push` заливает папку сборки как есть и бандлер не запускает.
Изменение схемы: `push`, затем `migrate` (предпросмотр), затем `migrate`
с `confirm: true`. Если в предпросмотре нет удалений, берите `apply: "safe"`.