Про те, як влаштований редактор сценаріїв

Редактор сценаріїв (Scenario Builder) — це візуальний інструмент для побудови діалогових сценаріїв ботів у ConnectiveOne. Замість написання коду ви додаєте блоки на полотно, з'єднуєте їх стрілками, налаштовуєте умови і переходи. Ця сторінка пояснює принципи роботи редактора, ключові концепції та чому він влаштований саме так.

Контекст і проблема

Діалогові сценарії ботів можуть бути складними: різні гілки розмов, збір даних, переходи до операторів, інтеграції з зовнішніми системами. Описувати таку логіку текстом або кодом важко — легко заплутатися в гілках і переходах.

Що вирішує візуальний редактор:

Вся логіка діалогу видна на одному екрані: блоки, переходи, умови
Зміни вносяться без коду — через кліки та налаштування полів
Помилки легше знайти — некоректні з'єднання або відсутні переходи видно на схемі
Команда може спільно працювати над сценарієм — кожен бачить структуру

Типові сценарії використання:

Створення бота з нуля: привітання, меню, збір даних, передача оператору
Додавання нових гілок до існуючого сценарію
Перебудова логіки після змін у бізнес-процесах
Тестування сценарію перед запуском

Основні концепції

Блоки (ноди)

Кожен блок — це елемент логіки сценарію. Блоки мають різні ролі:

Старт — точка входу в секцію, тригери (канали, webhook, внутрішні події, MCP Tool). Детальніше: Що таке стартова нода
Повідомлення з кнопками — надіслати текст або меню користувачу. Детальніше: Меню та кнопки для клієнта
Очікування вводу — зібрати дані (текст, число, дата, вибір). Детальніше: Текст від клієнта
Роутер — направити за умовами в різні гілки. Детальніше: Умовні гілки (роутер)
Точка виходу / Точка входу — перейти в іншу секцію або процес. Детальніше: Перехід між секціями
Підключення до оператора — передати діалог оператору. Детальніше: Живий оператор у діалозі
Set — зберегти константи / пари ключ-значення. Детальніше: Зберегти значення для наступних кроків
Дії — викликати зовнішні системи (API, email, інтеграції)
Замітка — пояснення на схемі для команди

Блоки додаються через кнопку «+» на полотні. Модальне вікно показує категорії (Основні, Messaging, Data тощо) та пошук. Після додавання блок налаштовується в панелі справа (Node Inspector).

Полотно і переходи

Полотно (Canvas) — центральна область, де розташовуються блоки. Ви перетягуєте блоки, з'єднуєте їх стрілками (edges). Стрілка визначає порядок виконання: після завершення одного блоку виконання переходить до наступного.

Переходи можуть бути:

Простими — один вихід з блоку до одного наступного
Розгалуженими — роутер з кількома умовами направляє в різні гілки
Між секціями — точка виходу з однієї секції з'єднується з точкою входу в іншу

Секції

Складні сценарії розбиваються на секції. Секція — це група блоків з власною логікою. Точки виходу та входу дозволяють переходити між секціями без дублювання коду. Це спрощує підтримку: зміни в одній секції не впливають на інші.

Змінні та константи

Змінні процесу — дані, які зберігаються під час діалогу (ім'я користувача, вибір, введені значення). Вони є в окремій панелі зліва і доступні в блоках через підстановку {{variable_name}}.

Константи — значення, які не змінюються під час діалогу (наприклад, URL API, ключі). Також керуються в бічній панелі.

Пошук на полотні

У верхній панелі є пошук нод: можна швидко знайти блок за назвою чи вмістом, у поточній секції або в усьому сценарії. Покроково: Як знайти ноду на полотні.

Як це працює разом

Ви відкриваєте сценарій у бібліотеці процесів або створюєте новий.
На полотні додаєте блоки та з'єднуєте їх стрілками.
В панелі справа налаштовуєте кожен блок: текст, умови, параметри дій.
Змінні та константи додаєте в бічній панелі.
Зберігаєте сценарій. Система валідує з'єднання та перевіряє коректність.
Тестуєте через «Запуски» — історія запусків, прев'ю чату, підсвітка виконаних блоків.

Єдиний контекст: Бібліотека процесів і редактор разом — не потрібно перемикатися між розділами. Знайшли бота → відкрили конструктор → редагуєте.

Чому саме візуальний редактор

Альтернатива: описувати сценарій у вигляді JSON або коду. Це дає гнучкість, але вимагає технічних знань і легко призводить до помилок при зміні структури.

Візуальний підхід:

Підходить тим, хто не пише код — бізнес-аналітики, контент-менеджери
Структура видна одразу — не потрібно «збирати» логіку з тексту
Помилки легше знайти — порожні виходи, нез'єднані блоки видно на схемі
Команда може спільно працювати — замітки на схемі, історія версій, збереження з коментарем

Обмеження: для дуже специфічних інтеграцій може знадобитися дію (Action) з кастомною логікою. Але більшість сценаріїв можна побудувати повністю візуально.

Наслідки для користувачів

Для тих, хто створює сценарії:

Починайте зі стартового блоку — налаштуйте тригери (канали, webhook)
Використовуйте секції для складних сценаріїв — не намагайтеся все вмістити в одній схемі
Використовуйте замітки — вони допомагають команді зрозуміти логіку

Типові помилки:

Порожній вихід з блоку — блок не з'єднаний з наступним, діалог «зависає». Перевіряйте, що кожен блок має хоча б один вихід (крім кінцевих).
Циклічні залежності — безкінечний цикл між блоками. Роутер або умова повинні мати вихід для завершення діалогу.
Забули змінну — в блоці використовується {{name}}, але змінна не створена в панелі. Додайте змінну в бічній панелі.

Пов'язані документи

Explanation: Про те, як влаштована бібліотека процесів
Explanation: Що таке стартова нода
How-to: Як працювати з бібліотекою процесів
Learn: Процеси та сценарії — Scenario Builder — огляд модуля та відео
How-to: Створити сценарій
How-to: Редагувати сценарій
How-to: Протестувати сценарій
Інтегратор: Scenario Builder — хаб для інтеграторів