Як протестувати сценарій в Scenario Builder?

Scenario Builder — новий модуль, що замінює Scenario Dialog. Ця інструкція допоможе запустити сценарій для перевірки роботи, переглянути історію запусків та використати прев'ю чату.

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

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

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

• Повний запуск — сценарій виконується з початку (Start Node). Під час виконання можна взаємодіяти через прев'ю чату.
• Історія запусків (Runs) — у лівій панелі зберігається історія всіх запусків. Для кожного запуску видно виконані ноди та статус.
• Прев'ю чату — віджет, що показує діалог у реальному часі під час тесту. Можна відправляти повідомлення та бачити відповіді бота.
• Тест окремої дії — для Action нод можна протестувати дію без запуску всього сценарію (див. Використати action в сценарії).

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

• Ви увійшли в систему з правами інтегратора або адміністратора.
• У вас є відкритий сценарій в Scenario Builder.
• Сценарій опубліковано (немає критичних помилок валідації).

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

1. Запустити сценарій

1. У панелі інструментів зверху натисніть «Запустити» або «Тест».
2. Система валідує сценарій. Якщо є помилки — запуск блокується, показується список помилок.
3. Після успішної валідації створюється новий запуск. Відображається індикатор виконання (running, success, error).

2. Взаємодіяти через прев'ю чату

1. Під час виконання відкрийте прев'ю чату (якщо воно не відкрито автоматично).
2. У віджеті чату відображаються повідомлення бота та можливість відправити відповідь (текст, кнопки).
3. Відправте повідомлення — сценарій продовжить виконання відповідно до логіки.

3. Переглянути історію запусків

1. У лівій панелі знайдіть розділ «Запуски» (Runs).
2. Виберіть запуск зі списку — відобразиться інформація про виконані ноди та статус.
3. Можна переглянути логи виконання, якщо виконання завершилося з помилкою.

4. Знайти блок у послідовності виконання

1. Відкрийте запуск у розділі «Запуски» — з'явиться панель «Деталі виконання» з послідовністю виконаних нод.
2. У полі пошуку над послідовністю введіть назву блоку або його ID. Щоб знайти блок точно за ID, введіть # та ID, наприклад #12.
3. Щоб шукати лише блоки певних типів, натисніть кнопку з лійкою праворуч від поля й позначте один або кілька типів, наприклад «Роутер». У списку є лише типи блоків, які виконувалися в цьому запуску, з кількістю кроків. Без тексту в полі знайдуться всі кроки цих типів. Обрані типи з'являться під полем: хрестик прибирає тип, кнопка «Усі типи» скидає вибір. Кнопка з перекресленим оком поруч зі стрілками залишає в списку лише знайдені кроки.
4. Натисніть Enter, щоб перейти до наступного збігу, або Shift+Enter — до попереднього. Пошук іде лише серед нод, які виконувалися в цьому запуску. Якщо нода виконувалася кілька разів, кожен прохід — окремий збіг, і панель показує, наприклад, «Прохід 2 з 3».
5. Кнопки «Список» і «Canvas» (іконки праворуч) визначають, де показати знайдену ноду: прокрутити до неї список, відкрити її на полотні або і те, і те. Вимкнути обидва не можна.
6. Позначка «Видалено» означає, що нода виконувалася в цьому запуску, але в сценарії її вже немає, тож на полотні її не показати. У списку типів такі кроки зібрано в пункт «Видалені блоки».
7. Esc очищає текст пошуку, обраний тип лишається.

5. Переглянути вхідні та вихідні дані кроку

1. У панелі «Деталі виконання» клацніть по кроку в послідовності або відкрийте його в окремому вікні кнопкою у рядку кроку.
2. Блок «Вхідні дані» показує, з чим крок працював: назву дії, параметри кроку так, як їх налаштовано в блоці, змінні, використані в параметрах, з їхніми значеннями на момент перед кроком, і решту змінних до кроку.
3. Блок «Вихідні дані» показує, що крок віддав далі: результат кроку, обраний вихід — блок, у який сценарій справді пішов (наприклад, «Вихід: default → блок #8»), — і змінені змінні з позначками «додано», «змінено», «видалено». Якщо крок завершився помилкою, тут видно її текст. Якщо ж результат кроку — error, а тексту помилки немає, шукайте його в «Логах» цього кроку. Крок, що чекає відповіді користувача (кнопки, ввід, пошук у списку), замість виходу показує позначку «Очікування»: куди сценарій пішов після відповіді, видно з наступного кроку.
4. Службові ключі запуску (channel, chat_id, section_id, test_run_id, initial_state) сховано; їх кількість показує рядок «Приховано службових ключів».
5. Щоб побачити повний JSON — «Стан до», «Результат», «Стан після», — увімкніть «Показати сирий payload» над блоками. Вибір запам'ятовується в браузері. «Вихідні повідомлення» і «Логи» видно в обох режимах.

Важливо. «Вхідні дані» — це параметри, як їх налаштовано, і окремо значення змінних, на які вони посилаються. Рядка після підстановки змінних тут немає: якщо в параметрі записано Знижка {{discount}}%, ви побачите саме Знижка {{discount}}% і поруч значення discount (наприклад, 10), а не готове Знижка 10%. Змінні, яких немає в стані діалогу (наприклад, константи бота), позначено «немає в стані».

6. Зупинити виконання (опційно)

1. Під час виконання натисніть «Зупинити» у панелі інструментів.
2. Виконання перерветься, стан збережеться в історії запусків.

7. Опублікувати зміни після тесту

1. Якщо під час тесту виявили потрібні зміни — внесіть їх у сценарій.
2. Натисніть «Опублікувати» у панелі інструментів. У вікні «Опублікувати сценарій» за потреби додайте «Коментар до версії» і натисніть «Опублікувати».
3. Запустіть тест знову для перевірки.

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

• Переглянути історію версій
• Використати action в сценарії — тест окремої дії в Node Inspector
• Знайти ноду на полотні — пошук по всіх нодах сценарію, а не лише по виконаних
• Хаб Scenario Builder