Як редагувати існуючий сценарій бота?

Коли потрібно внести зміни до вже створеного сценарію, редагування дозволяє оновити логіку бота, додати нові елементи або виправити помилки. Ця інструкція допоможе відредагувати сценарій та зберегти зміни.

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

  • Потрібно оновити тексти повідомлень у сценарії.
  • Треба додати нові ноди або секції до існуючого сценарію.
  • Потрібно виправити помилки у логіці переходів між нодами.
  • Треба змінити послідовність дій у сценарії.

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

  • Конкурентне редагування — якщо інший користувач одночасно редагує той самий сценарій, система заблокує можливість збереження для запобігання конфліктів.
  • Автозбереження — деякі зміни зберігаються автоматично, але для фінального збереження потрібно натиснути кнопку "Зберегти".
  • Історія версій — кожне збереження створює нову версію сценарію, яку можна відновити пізніше.

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

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

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

1. Відкрити сценарій для редагування

  1. Перейдіть до модуля Dialog через меню Додатки -> Dialog.
  2. Виберіть бота, сценарій якого потрібно редагувати.
  3. Натисніть на кнопку редагування сценарію або перейдіть за роутом /dialog/bot-scenario/:id.

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

  1. Система автоматично перевірить, чи інший користувач не редагує цей сценарій через Socket.IO.
  2. Якщо з'явиться повідомлення (snackbar) про те, що сценарій редагує інший користувач:
    • Ви можете продовжити перегляд сценарію, але збереження буде заблоковано (кнопка "Зберегти" стане неактивною).
    • У повідомленні відображається email користувача, який редагує сценарій.
    • Натисніть кнопку "Зняти блокування" (Remove user), якщо ви впевнені, що інший користувач не працює з сценарієм (потребує прав адміністратора).
    • Або дочекайтеся, поки інший користувач завершить роботу — система покаже повідомлення про можливість редагування та запропонує перезавантажити сторінку.
  3. Після завершення редагування іншим користувачем натисніть кнопку "Перезавантажити сторінку" (Reload page) у повідомленні, щоб оновити дані сценарію.

3. Вибрати секцію для редагування

  1. У панелі секцій зверху екрана виберіть секцію, яку потрібно редагувати.
  2. Рабочее полотно (canvas) автоматично оновиться та відобразить ноди обраної секції.

4. Редагувати існуючу ноду

  1. Клацніть на ноду, яку потрібно редагувати — справа відкриється панель редагування (RightSideBar).
  2. Внесіть необхідні зміни:
    • Для повідомлень: змініть текст у полі "Текст повідомлення".
    • Для клавіатур: додайте або видаліть кнопки, змініть тексти кнопок.
    • Для Input нод: змініть тип вводу або валідацію.
    • Для дій: виберіть інший шаблон дії або змініть параметри.
  3. Зміни зберігаються автоматично або після натискання кнопки "Зберегти" у панелі редагування.

5. Додати нову ноду

  1. На рабочее полотно (canvas) натисніть правою кнопкою миші або використайте кнопку "Додати ноду".
  2. У модальному вікні виберіть тип ноди, яку потрібно додати.
  3. Нода з'явиться на рабочее полотно (canvas) — перетягніть її в потрібне місце.
  4. З'єднайте нову ноду з існуючими через edges.

6. Видалити ноду

  1. Клацніть на ноду, яку потрібно видалити.
  2. У панелі редагування натисніть кнопку "Видалити" або використайте клавішу Delete на клавіатурі.
  3. Підтвердіть видалення у діалоговому вікні.
  4. Усі зв'язки (edges) з цією нодою також будуть видалені.

7. Змінити зв'язки між нодами

  1. Щоб видалити зв'язок: клацніть на edge (стрілку між нодами) та натисніть Delete.
  2. Щоб створити новий зв'язок: перетягніть edge від вихідного handle однієї ноди до вхідного handle іншої ноди.
  3. Щоб змінити цільовий перехід для кнопки клавіатури: у панелі редагування клавіатури виберіть іншу цільову ноду з випадаючого списку.

8. Перемістити ноду на рабочее полотно (canvas)

  1. Перетягніть ноду мишею на нове місце на рабочее полотно (canvas).
  2. Позиція ноди зберігається автоматично.

9. Зберегти зміни

  1. Перевірте всі внесені зміни на рабочее полотно (canvas).
  2. Натисніть кнопку "Зберегти" знизу екрана або використайте комбінацію клавіш Ctrl+S (або Cmd+S на Mac).
  3. Система збереже всі зміни та покаже повідомлення про успіх.
  4. Нова версія сценарію буде створена в історії версій.

Що відбувається після

Всі зміни збережено та сценарій оновлено. Бот буде використовувати нову версію сценарію під час наступних діалогів з користувачами. Ви можете переглянути історію версій та відновити попередню версію, якщо потрібно.

Як переконатися, що все вдалось

  • Перевірте, що всі зміни відображаються на рабочее полотно (canvas).
  • Переконайтеся, що повідомлення про успішне збереження з'явилося.
  • Спробуйте відкрити сценарій ще раз — всі зміни повинні зберегтися.
  • Перевірте історію версій — нова версія повинна з'явитися у списку.

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