ДОКУМЕНТАЦИЯ

Понятно и бизнесу, и разработке.

Короткая обзорная документация продукта: из каких сущностей состоит Chatron и как проходит путь от сценария до опубликованного Telegram-бота.

Стек

Flask · Jinja · SQLAlchemy · REST API · Telegram Webhook · HTML/CSS/JavaScript.

01 · КОНЦЕПЦИЯ

Бот = сценарий + состояние пользователя

Редактор хранит сценарий как граф блоков и переходов. Flow-engine понимает текущий блок пользователя, обрабатывает входящее сообщение, сохраняет переменные и переводит сессию дальше.

02 · БЛОКИ

Базовые элементы сценария

Старт — входная точка.
Сообщение — отправка текста пользователю.
Вопрос — ожидание ответа и сохранение значения.
Условие — выбор ветки.
Переменная — запись значения.
HTTP — вызов внешнего API.
Пауза — отложенный переход.
Завершение — конец ветки.

03 · ПЕРЕМЕННЫЕ

Персонализация сценария

Ответы пользователя сохраняются в сессии и могут использоваться в последующих сообщениях.

Привет, {{name}}! Ваш выбранный бюджет: {{budget}}

04 · ПУБЛИКАЦИЯ

Черновик и опубликованная версия

Редактирование не обязано сразу затрагивать живого бота. Сначала сценарий меняется и тестируется, после чего публикуется новая версия.

05 · API

Точки расширения

GET /api/bots POST /api/bots PUT /api/bots/:id/flow POST /api/bots/:id/simulate GET /api/contacts GET /api/analytics

Конкретный набор endpoint можно расширять под бизнес-логику проекта.

FAQ

Частые вопросы

Для базовой логики — нет. Программист нужен, когда вы подключаете нестандартный внешний сервис или добавляете собственную серверную логику.

Да. Для этого используются HTTP-блоки, webhooks или собственные Flask API-endpoint.

Да. Встроенный эмулятор прогоняет тот же flow-engine и показывает сохранённые переменные.

Да. Готовые шаблоны — только стартовая точка. Сценарий можно собрать с чистого холста.