Як використати дію в сценарії Scenario Builder?

Scenario Builder — модуль, що замінює Scenario Dialog. Дії розширюють функціональність сценарію: інтегрують його із зовнішніми системами, обробляють дані та виконують складну логіку.

Коли знадобиться

• Потрібно інтегрувати сценарій з CRM, API або іншими системами.
• Треба виконати обчислення, перевірку даних або зовнішній запит.
• Потрібно надіслати email, створити тікет або викликати зовнішній сервіс.

Що важливо знати

• Action — дія з Бібліотеки дій (ActionJail), яку можна використати в сценарії.
• Режим форми — у Scenario Builder дії налаштовуються через форму в інтерфейсі. За потреби можна перемкнутися на JSON-режим для ручного редагування.
• Документація в панелі — для кожного типу дії в Node Inspector відображається вбудована документація та підказки для параметрів.
• Тест дії — у панелі конфігу ноди можна протестувати дію з поточним станом.
• Події — виходи дії (наприклад, create, update, error). Кожна подія — окремий рядок на ноді, від якого йде стрілка до наступної ноди. Список подій — у розділі «Події» в Node Inspector.

Перед початком

• Ви увійшли в систему з правами інтегратора або адміністратора.
• У вас є відкритий сценарій в Scenario Builder.
• Потрібну дію створено у Бібліотеці дій (ActionJail).

Покрокова інструкція

1. Додати ноду Action

1. На полотні натисніть «+».
2. У модальному вікні виберіть категорію Data або Основні.
3. Виберіть тип ноди Action (Дія).
4. Нода з'явиться на полотні.

2. З'єднати з попередньою нодою

1. Перетягніть зв'язок від попередньої ноди (наприклад, WaitForInput) до ноди Action.
2. З'єднайте Action з наступною нодою за логікою сценарію.

3. Налаштувати дію

1. Клацніть на Action ноду — справа відкриється Node Inspector.
2. Виберіть шаблон дії з Бібліотеки дій.
3. Заповніть параметри через форму (поля, випадаючі списки, правила). Для кожного типу дії відображається вбудована документація та підказки.
4. Використовуйте змінні процесу у форматі {{variable_name}}.
5. За потреби перемкніть на Режим JSON — для ручного редагування конфігурації (якщо дія підтримує цей режим).

4. Змінити порядок подій на ноді (опційно)

Спочатку події стоять на ноді в порядку додавання. Якщо наступні ноди праворуч розташовані в іншому порядку, стрілки перетинаються і схему важко читати. Розставте події так, як зверху вниз стоять ноди, до яких вони ведуть:

1. Клацніть на ноду дії та розгорніть у Node Inspector розділ «Події».
2. Біля події натисніть стрілку вгору («Перемістити вгору») або вниз («Перемістити вниз») — подія поміняється місцями із сусідньою.
3. Подивіться на полотно: рядки на ноді стоять у тому ж порядку, що й у панелі, і кожна стрілка виходить зі своєї події. Якщо подій більше чотирьох, частина рядків схована під кнопкою «+N ще» — натисніть її, щоб побачити всі.
4. Натисніть «Опублікувати», щоб зберегти новий порядок.

Що варто знати про порядок подій:

• На роботу бота порядок не впливає: куди веде кожна подія, підписи й кольори стрілок залишаються такими самими.
• Нова подія — додана кнопкою «Додати подію» або зі списку «Доступні події» — з'являється внизу списку.
• У нодах Роутер, Каскад черги оператора та в дії interval__start стрілок для перестановки немає: там порядок подій впливає на роботу сценарію.
• Дві сусідні події з однаковою назвою не міняються місцями — кнопка між ними неактивна.
• Кнопки неактивні, коли секцію зараз редагує колега, — див. Редагувати сценарій разом з колегами.
• Порядок подій важливий, коли ви видаляєте ноду дії: редактор сам з'єднує попередню ноду з наступною. Якщо в ноди немає окремого виходу без події, він продовжує гілку від події success, а без неї — від першої зверху події зі стрілкою, як вона стоїть на ноді.

5. Протестувати дію (опційно)

1. У Node Inspector знайдіть кнопку «Тест дії» або «Протестувати».
2. Можна підтягнути стан з останнього запуску («З останнього запуску»).
3. Запустіть тест — результат відобразиться в панелі.

6. Опублікувати зміни

1. Натисніть «Опублікувати» у панелі інструментів. У вікні «Опублікувати сценарій» за потреби додайте «Коментар до версії» і натисніть «Опублікувати».

Пов'язані матеріали

• Хаб Scenario Builder
• Підписати гілку (стрілку) у сценарії — підпис, опис і колір стрілки
• Довідник вбудованих дій — маршрутизація, оператор, Custom Data, графік, таймери і Context API
• Дія register_client_context
• Дія load_external_context
• Бібліотека дій (ActionJail)
• Довідник дій
• Scenario Dialog — використання дій — концепції, які застосовуються й до Scenario Builder