Документация/Быстрый старт

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

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

Порядок изучения и формат разделов. Создать бота, собрать workflow, протестирова

Как читать документацию

Все разделы устроены по одному принципу: действие → что делает система → как проверить → частые ошибки. Это пошаговая инструкция для работы, а не просто обзор платформы.

  • Сначала пройдите «Быстрый старт» от начала до конца. Не пытайтесь сразу выучить все ноды.
  • Когда всё получится, посмотрите разделы «Разделы редактора» и «Компоненты интерфейса» — так вы поймете, где находятся нужные функции.
  • Раздел «Ноды и пресеты» используйте как справочник: возвращайтесь к нему, когда нужна конкретная нода.
  • Добавляете кнопки? Обязательно прочитайте «Клавиатуры и триггеры». Это поможет не путать обычные кнопки (Reply) и кнопки в самом сообщении (Inline).
  • Если что-то сломалось, загляните в «Тест, логи, деплой» и «Частые проблемы» — там написано, как всё починить.
Видео скоро появится.

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

Быстрый старт: первый бот от идеи до теста

Самый быстрый путь к работающему боту: создать бота, соединить ноды Trigger и Message, сохранить, нажать Test и проверить логи.

1. Создайте бота в разделе Bots

Получить карточку бота и перейти в редактор.

Действия
Откройте Дашборд -> Боты.
Нажмите Новый бот / Create first bot.
Введите имя и короткое описание.
После создания перейдите в редактор (Кликнете по карточке бота два раза).
Что проверить
После входа вы должны увидеть экран редактора бота с холстом, левой навигацией и панелью нод.
Верхний хедер показывает название бота и кнопки Сохранить и Тест.
Видео: Создание первого бота и вход в редактор

2. Соберите минимальный workflow на Canvas

Сделать простой сценарий: триггер -> сообщение.

Действия
Добавьте Command Trigger и Message.
Соедините их линией.
В настройках Command Trigger укажите команду, например /start.
В Message задайте текст ответа.
Что проверить
На холсте отображается соединение между trigger и message.
При выборе ноды справа (или в модальном режиме) видны её настройки.
Видео: сборка первого сценария на холсте

3. Добавьте переменную и используйте её в сообщении

Понять разницу между пользовательскими переменными и runtime-данными.

Действия
Откройте раздел Система.
Добавьте пользовательскую переменную (например welcomeText).
Вернитесь в канвас и нажмите на ноду Message и вставьте шаблон {{welcomeText}} (через подсказки {{ выберите свою переменную).

Либо используйте ноду Action -> setVariable, если хотите значение только в runtime теста.
В чем отличия в обычных переменных и runtime-переменных
Пользовательские переменные сохраняются в конфиге (bot_configs.variables).
Runtime-переменные (setVariable) живут в тестовой сессии и не обязаны появляться в таблице переменных System.
Что проверить
В System -> Переменные видна созданная пользовательская переменная.
В поле текста Message подсказка переменных появляется при вводе {{.
Видео скоро появится.
Подробнее по шагу: System -> переменная welcomeText
Видео скоро появится.
Видео: runtime-переменные и как работать с ними

4. Сохраните конфиг бота

Зафиксировать текущий canvas и настройки проекта.

Действия
Нажмите Сохранить в верхнем хедере редактора.
Дождитесь завершения сохранения.
Если есть ошибки, проверьте настройки бота (токен/секреты) отдельно в Настройки.
Видео скоро появится.
Подробнее по шагу: сохранить изменения

5. Запустите Test и проверьте логи

Проверить workflow без полноценного деплоя.

Действия
Нажмите Тест на холсте.
Откройте панель логов внизу (Логи бота).
Отправьте боту сообщение или команду в Telegram.
Проверьте, сработал ли нужный триггер и отправилось ли сообщение.
Что проверить
В логах видно запуск теста, входящее событие и выбранный путь по нодам.
В Telegram приходит ответное сообщение от бота.
Видео скоро появится.
Подробнее по шагу: запуск Test и проверка логов

6. Остановите Test и зафиксируйте рабочую версию

Завершить сессию теста.

Действия
Нажмите Стоп / Stop (та же кнопка теста, когда тест активен).
Убедитесь, что статус теста и логи перестали обновляться.
Сохраните финальные изменения, если что-то правили во время теста.
Что делает система
Останавливается тестовый runtime/polling для данного бота.
Флаг активного теста сбрасывается в метаданных бота.
Нижняя панель логов остаётся доступной для просмотра истории запуска.
Что проверить
Кнопка возвращается в состояние Тест.
Новые логи не появляются без новых действий.
Видео скоро появится.
Подробнее по шагу: остановка теста
Видео скоро появится.
Видео: корректная остановка теста

Навигация по документации

Переходите по страницам по порядку, как по учебному маршруту.

Руководство по работе с CBToollРабота по разделам