Як створити новий сценарій бота?

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

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

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

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

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

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

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

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

1. Відкрити редактор сценарію

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

2. Створити першу секцію

  1. У панелі секцій зверху екрана натисніть кнопку "Додати секцію" або "Створити секцію".
  2. У модальному вікні введіть назву секції (наприклад, "Стартове привітання").
  3. Натисніть "Створити" — секція з'явиться у списку секцій.

3. Встановити стартову секцію

  1. У списку секцій знайдіть створену секцію.
  2. Натисніть на іконку зірочки або виберіть опцію "Встановити як стартову".
  3. Система автоматично встановить цю секцію як точку входу в сценарій.

4. Додати першу ноду (повідомлення)

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

5. Налаштувати текст повідомлення

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

6. Додати клавіатуру з кнопками

  1. Додайте нову ноду типу "Клавіатура" (Keyboard) на рабочее полотно (canvas).
  2. З'єднайте ноду повідомлення з нодою клавіатури через edge (перетягніть зв'язок від вихідного handle повідомлення до вхідного handle клавіатури).
  3. У панелі редагування клавіатури додайте кнопки:
    • Натисніть "Додати кнопку".
    • Введіть текст кнопки.
    • Налаштуйте перехід при натисканні кнопки (виберіть цільову ноду з випадаючого списку).

7. Додати очікування вводу (за потреби)

  1. Якщо потрібно зібрати дані від користувача, додайте ноду типу "Очікування вводу" (Input).
  2. З'єднайте клавіатуру з Input нодою через edge.
  3. У панелі редагування Input налаштуйте:
    • Тип вводу (текст, число, дата, email тощо).
    • Валідацію введених даних.
    • Змінну, в яку зберігатиметься введене значення.

8. Зберегти сценарій

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

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

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

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

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

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