Перейти к основному содержимому

Архитектура бота. С чего начать

Бот в Квесче — это конструктор из нескольких уровней. Прежде чем строить — поймите, как они связаны. Каждый уровень решает свою задачу, и пропускать их нельзя.

Уровни конструктора​

Проект — это область изоляции сущностей бота. При выборе проекта в интерфейсе вы видите только то, что к нему относится: его боты, цепочки, списки, глобальные переменные, сценарии действий, интеграции и платёжные системы. Сущности других проектов скрыты — они не смешиваются.

Проект (выбран в шапке — фильтрует всё ниже)
│
├── Боты — токены и подключения к мессенджерам
├── Автоворонки — рабочие пространства для логики
│   └── Цепочки → Шаги → Сценарии → Блоки → Сценарии действий
├── Сценарии действий
├── Списки и глобальные переменные
├── Web Apps / Mini Apps
├── Файлы для ответов нейросети
├── Интеграции (CRM, Google, Яндекс)
├── Платёжные системы
└── Сотрудники
СущностьЧто этоГде живёт
ПроектОбласть изоляции — при выборе проекта показываются только его боты, цепочки, списки, сценарии действий, интеграции и платёжные системыРаздел «Проекты» (выбор в шапке)
БотПодключение к мессенджеру: токен + канал (Telegram, MAX, WhatsApp, VK, Viber, …)Страница «Боты» внутри проекта
АвтоворонкаКонтейнер логики внутри проектаВкладка «Автоворонки»
ЦепочкаКогда и почему запускается логикаВкладка «Автоворонки» → Цепочка → Настройки цепочки
Шаг цепочкиТочка с задержкой и сценариемВнутри цепочки
СценарийДоска с блоками — диалог с клиентомПо кнопке «Сценарий на доске»
БлокОдин экран диалога: сообщение, вопрос, переходНа доске сценария
Сценарий действийФоновая логика блока (запросы, расчёты, интеграции)На вкладке «Сценарий действий» внутри блока
Список / Глобальные переменныеДанные подписчиков и настройкиВкладка «Списки / Переменные»

Поток данных: что и куда передаётся​

  1. Триггер — подписчик пишет боту, нажимает кнопку или подходит время по расписанию.
  2. Цепочка ловит триггер и активируется.
  3. Шаг цепочки запускает свой сценарий (с задержкой или сразу).
  4. Сценарий ведёт диалог через блоки: показывает сообщения, ждёт ответ, реагирует на кнопки.
  5. Сценарий действий блока выполняет фоновую работу: считывает данные, обращается к API, сохраняет в списки, читает глобальные переменные.
  6. Бот отвечает подписчику и/или переходит к следующему блоку.

С чего начать — пошаговый план первого бота​

Шаг 1. Создайте проект и подключите бот​

  1. Раздел «Проекты» → «Добавить». Проект изолирует ваши сущности: при его выборе в интерфейсе видны только его боты, цепочки, списки, сценарии действий, интеграции и платёжные системы.
  2. Внутри проекта откройте страницу «Боты» → «Подключить». Выберите мессенджер (Telegram, MAX, WhatsApp, VK, Viber, Jivo), укажите токен.

→ Подробно: Подключение бота.

Шаг 2. Создайте автоворонку​

В проекте → вкладка «Автоворонки» → «Новая цепочка». Автоворонка — контейнер: внутри неё цепочки, сценарии со списками, переменными, интеграциями.

→ Подробно: Цепочки.

Шаг 3. Настройки цепочки​

Здесь решаете:

  • Когда запускать: команда /start, ключевые слова, новый подписчик, расписание, неизвестные сообщения, обращение в чат.
  • Что делать: создать первый шаг → создать сценарий.

→ Подробно: Цепочки.

Шаг 4. Постройте сценарий на доске​

Нажмите «Сценарий на доске». Откроется визуальный редактор. Добавляйте блоки (приветствие, вопрос, ответ, переход), соединяйте их кнопками.

→ Подробно: Сценарии, Работа с блоками.

Шаг 5. Подключите фоновую логику​

В блоке, где нужны вычисления, запросы или интеграции — добавьте «Сценарий действий» и добавьте действия: HTTP-запрос, оплата, сохранение в список и т.д.

→ Подробно: Сценарии действий.

Шаг 6. Сохраните данные​

Где нужно хранить — выберите механизм:

Шаг 7. Протестируйте​

Откройте бота в мессенджере, пройдите сценарий. Если блок не запускается, проверьте сообщение/кнопки блока или сценарий действий у блока, который должен запуститься для отладки. Проверьте:

  • В сообщении блока ошибки HTML тегов, например, присутсвует незакрытый тег или превышена допустимая длина сообщения
  • Превышена допустимаа длина названий, значений, данных кнопок
  • Возврат сообщения из сценария действий: добавьте первое действие и верните сообщение в блок

Шаг 8. Развивайте​

Логика построения хорошего бота​

1. Думайте сценариями, а не блоками​

Сначала набросайте на бумаге путь клиента: «вошёл → выбрал → оплатил → получил». Только потом собирайте блоки. Если запутались в схеме — клиент запутается тем более.

2. Используйте цепочки как разделители​

  • Одна цепочка = одна задача: «Приветствие», «Каталог», «Поддержка», «Возврат».
  • Не складывайте всё в одну гигантскую цепочку — её невозможно поддерживать.

3. Храните данные осознанно​

  • Не плодите 20 локальных переменных, если их можно положить одной строкой в список.
  • Конфиги (курсы, ссылки, флаги) — в глобальные переменные, а не в код блоков.

4. Выносите тяжёлую логику в сценарии действий​

Расчёты, форматирование, запросы — в сценарий действий. Блок-сообщение должен быть «глупым» — он только показывает результат.

5. Версионируйте через комментарии​

Используйте поле «Комментарий» у глобальных переменных и названия у цепочек/блоков/действий. Через месяц вы забудете, зачем сделали g_x = 1.

6. Тестируйте сразу, а не «в конце»​

Каждый новый блок — сразу проверка в чате. Цена опечатки в #{var} — час отладки на проде.

Где что искать в интерфейсе​

Если нужно…Идите в…
Изменить токен или подключить новый мессенджерПроект → Боты
Изменить, когда запускать диалогАвтоворонка → Цепочки
Изменить текст сообщенияЦепочка → Шаг → Сценарий на доске → блок
Изменить логику оплаты, расчётов, интеграцийБлок → Сценарий действий
Посмотреть/изменить данные клиентовАвтоворонка → Списки
Изменить промокод/курс/настройкуАвтоворонка → Глоб. перем.
Понять, почему бот не отвечаетСмотрите сообщение/кнопки блока или сценарий действий у блока, который должен запуститься
Отправить рассылкуПодписчики/Рассылки

Что дальше​