Налаштування та редагування сценаріїв

eSputnik пропонує drag-and-drop редактор для побудови сценаріїв. Він містить готові блоки, які ви можете розміщувати й підключати до сценарію, а також призначати їм задачі та умови.

Створення нового сценарію

1. Перейдіть у вкладку Тригери → Сценарії, натисніть Новий сценарій.

2. Вкажіть назву сценарію. Додайте мітки (опціонально).

Назва сценарію може містити до 100 символів. Якщо довга назва не вміщується на панелі, вона скорочується посередині — повний текст відображається в підказці при наведенні.

3. Додайте й налаштуйте необхідні блоки.

Обов’язкові блоки:

• Блок Старт. Під час створення нового сценарію він з'являється автоматично.
• Блок Кінець. Перетягніть блок у кінець гілки сценарію.

4. Збережіть сценарій одним із способів:

• Зберегти — без виходу з редактора.
• Зберегти і вийти — повернення до списку сценаріїв.
• Зберегти й запустити один раз — одноразовий запуск сценарію.

На верхній панелі інструментів:

• Зберегти й протестувати/ Протестувати — з тестовим запуском сценарію.

Керування блоками

Розглянемо дії, які можна виконувати з блоками.

Пошук блоків

Щоб швидко знайти потрібний блок і не переглядати групи Дія, Відправлення та Умови вручну, використовуйте поле Пошук у верхній частині панелі блоків. Почніть вводити назву блока, і панель одразу відфільтрує список та покаже блоки, що відповідають запиту в усіх групах.

За замовчуванням у кожній групі показані лише найпоширеніші блоки. Натисніть Ще блоки, щоб розгорнути групу й переглянути повний список, або Згорнути, щоб знову приховати додаткові блоки.

Додавання блоків

Блоки можна додати до сценарію кількома способами:

1. Перетягніть блок у робочу область та підключіть його вручну.
2. Виділіть блок у робочій області та клікніть потрібний блок на панелі. Новий блок буде автоматично підключений до вибраного.

Щоб вставити блок між двома з'єднаними блоками:

1. Перетягніть блок на лінію з'єднання.
2. Коли лінія стане пунктирною, відпустіть блок.

Редактор автоматично вставить блок у ланцюжок, перепідключить зв'язки та змістить інші блоки, щоб звільнити місце.

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

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

Щоб об’єднати гілки:

1. Виберіть блок, у якому вони мають зійтися.
2. Перетягніть зв’язок з виходу кожної гілки до цього блоку.

У результаті блок матиме кілька вхідних підключень.

Видалення блоків

Виберіть блок і натисніть значок Кошик над ним або на верхній панелі, або клавішу Delete.

Для видалення з’єднання між блоками виділіть його (кольорові точки стануть синіми) і натисніть Delete.

Вибір блоків

• Для вибору кількох блоків і з’єднань утримуйте Shift і клікайте елементи.
• Для вибору всіх блоків і з’єднань натисніть Ctrl+A.

Скасування дій

Натисніть стрілки скасування/повтору на панелі або використайте клавіші:

• Ctrl + Z — скасувати дію.
• Ctrl + Y — повторити дію.

Навігація у випадних списках

У випадних списках можна використовувати клавіші ↑ та ↓ для переміщення між елементами, а Enter — для вибору потрібного елемента. Поточний елемент підсвічується.

Додаткові налаштування блоків 

Блоки, що потребують додаткових налаштувань, позначені помаранчевим знаком оклику.

Виберіть блок і відредагуйте параметри на правій панелі.

Щоб згортати або розгортати панель блоків, натисніть клавішу [ або іконку кутових дужок у редакторі.

Опис і попередній перегляд сценарію

Опис сценарію допоможе позначати сценарії короткою інформацією про їхнє призначення та ключові дії.

Натисніть значок Опис сценарію у редакторі та додайте необхідну інформацію.

Опис відображається у спливаючій підказці при наведенні курсору.

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

Щоб внести зміни, натисніть Редагувати сценарій.

Масштабування сценарію

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

Скористайтеся кнопками в нижньому лівому куті у редакторі або у вікні попереднього перегляду сценарію:

• + : для збільшення;
• – : для зменшення;
• 100% : для відновлення стандартного масштабу,

або комбінації:

• Scroll + ctrl або ctrl +/- — для Windows;
• Scroll + CMD — або CMD +/- для MacOS.

Копіювання

Блоки

Ви можете дублювати блоки у сценарії, щоб дубльований блок мав таку саму конфігурацію, як і вихідний.

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

Щоб дублювати блок, натисніть значок Копіювати над ним або на верхній панелі. Також ви можете використовувати комбінації клавіш клавіатури Ctrl+C / Ctrl+V.

Щоб скопіювати блоки з одного сценарію до іншого:

1. Відкрийте сценарії на 2 різних вкладках.
2. За допомогою миші виберіть блоки у сценарії, які потрібно скопіювати, або натисніть Ctrl + C на клавіатурі.
3. Перейдіть до іншого сценарію та вставте скопійовані блоки, натиснувши Ctrl+V на клавіатурі.

Сценарії

Щоб скопіювати сценарій цілком:

1. Перейдіть у Тригери → Сценарії.
2. Натисніть на три крапки біля потрібного сценарію.
3. Оберіть Копіювати.

Відкриється новий сценарій із позначкою [copy] у назві, копіями всіх блоків і налаштуваннями умов запуску та зупинки з вихідного сценарію. Новий сценарій можна редагувати і зберегти.

Налаштування умов запуску та зупинки сценарію

Запуск і зупинка можуть бути налаштовані у відповідних блоках і в загальних параметрах сценарію.

Докладніше читайте у статті >

Тестування сценаріїв

Коли ви натискаєте Запустити тест, eSputnik перевіряє сценарій до відкриття налаштувань запуску. Якщо сценарій містить помилки, відкривається панель Перед запуском сценарію з розділами Виправте помилки та Перевірте попередження. Виправте помилки, які блокують запуск, а попередження перегляньте, щоб переконатися, що поточна конфігурація є навмисною. Якщо помилок немає, налаштування тестового запуску відкриваються відразу. Перевірка однаково працює в редакторі сценаріїв і в загальному списку сценаріїв.

Перевірити коректність роботи сценарію можна двома способами:

A. У редакторі під час створення або редагування сценарію (кнопка Зберегти й протестувати/Протестувати або меню кнопки Зберегти і вийти → Зберегти й запустити один раз):

B. У загальному списку сценаріїв (опції Протестувати/ Запустити один раз):

Після визначення способу оберіть один з варіантів тестування:

• Запустити на контакт
• Запустити за параметрами події
• Запустити на групу (цей варіант доступний лише в опції Запустити один раз)

Запустити на контакт

Натисніть Вибір контакта і виберіть потрібний контакт зі списку.

Якщо в сценарії використовуються параметри події, виберіть її зі списку.

Якщо в блоках сценаріїв прописані змінні, вкажіть їх значення у відповідних полях.

Натисніть Запуск.

Запустити за параметрами події

Введіть у відповідне поле параметри події у форматі JSON і натисніть Запуск.

Запустити на групу

Натисніть Додати групу, виберіть статичний або умовний сегмент і натисніть Запуск. Для кожного контакту з вибраної групи буде згенерований тип події manualRunEventType.

Якщо у сценарії є блок Таймер, ви можете пропустити його для прискорення тестування — натиснувши кнопку Пропустити очікування.

Для виходу із меню тестування натисніть кнопку Закрити або Завершити сценарій для його зупинки.

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

Активація та деактивація сценаріїв

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

Щоб активувати сценарій:

1. Перейдіть на вкладку Тригери → Сценарії та виберіть Неактивні в меню зліва.

2. Натисніть значок Активувати у потрібному сценарії.

Щоб деактивувати сценарій:

1. Перейдіть на вкладку Тригери → Сценарії та виберіть Активні в меню зліва.
2. Натисніть значок Деактивувати у потрібному сценарії.

Історія запусків сценарію

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

1. У редакторі натисніть іконку Запуски.

2. У загальному списку натисніть іконку Запуски в рядку потрібного сценарію.

Після натискання відкриється меню Показати запуски. Виберіть один із пунктів:

• В процесі — запуски, які ще виконуються;
• Завершених — запуски, що завершилися без помилок;
• З помилками — запуски, під час виконання яких сталася помилка;
• Протягом останніх 7 днів — усі запуски, що почалися протягом останніх семи днів.

Для регулярних сценаріїв для групи у меню додатково доступний пункт Статуси запуску на групу.

В обох точках переходу меню містить однакові фільтри та використовує однакові правила підрахунку. Дані про запуски доступні лише за останні сім днів; вибрати довільний або триваліший період неможливо.

Докладніше читайте у статті Відстеження історії запусків сценарію.

Пошук та фільтрація сценаріїв

Для пошуку сценаріїв використовуйте рядок пошуку за назвою, міткою або ID сценарію.

Для фільтрації сценаріїв за активністю натисніть у меню ліворуч відповідну вкладку:

• Всі сценарії (відображаються сценарії зі всіма статусами)
• Активні
• Неактивні