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

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 — для вибору потрібного елемента. Поточний елемент підсвічується.

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

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

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

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

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

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

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

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

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

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

Нотатки в сценарії

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

Щоб додати нотатку, натисніть значок Додати нотатку на верхній панелі й введіть текст. Текст може займати кілька рядків. На нотатці відображаються email-адреса автора й час останньої зміни.

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

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

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

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

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

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

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

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

Довідка та комбінації клавіш

Натисніть кнопку довідки (?) у нижньому лівому куті редактора, над кнопками масштабування, щоб відкрити меню довідки:

• База знань, Як працювати з API і Доступні методи API відкривають відповідні ресурси документації.
• Комбінації клавіш відкриває діалог зі списком комбінацій редактора, згрупованих за категоріями: навігація по полотну, виділення, редагування, скасування та повтор, дублювання, видалення тощо. Клавіші-модифікатори відображаються відповідно до операційної системи — Cmd на macOS і Ctrl на Windows. Відкрити й закрити цей діалог можна також комбінацією Shift + ?.
• Зв'язатися з нами відкриває чат підтримки.

Копіювання

Блоки

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

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

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

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

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

Сценарії

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

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

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

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

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

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

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

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

Якщо в сценарії є умова зупинки за подією, перед тестуванням вимкніть Налаштування зупинки: ручний запуск цю умову не перевіряє. Докладніше — Налаштування умов запуску та зупинки сценарію.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Перевірка проблем перед активацією

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

Виправте помилки

Усі блокуючі помилки потрібно усунути, перш ніж активувати сценарій. Панель пояснює кожну проблему та пропонує дії для її усунення. Приклади:

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

Перевірте попередження

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

• Деякі блоки містять попередження — перевірте позначені блоки сценарію, щоб дізнатися подробиці.
• У коротких посиланнях використовується спільний домен — за замовчуванням посилання у ваших повідомленнях скорочуються через спільний домен платформи, яким користуються всі відправники. Натисніть Налаштувати користувацький домен, щоб додати власний домен, або Нагадати через 30 днів, щоб відкласти нагадування.
• Подія запускає інші активні сценарії — перевірте перелічені сценарії та переконайтеся, що вони актуальні. Біля кожного сценарію відображається значок ока для попереднього перегляду.

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

Деактивація сценарію

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

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

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

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

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

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

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

Після натискання відкриється меню Показати запуски. В обох точках переходу меню містить однакові фільтри та використовує однакові правила підрахунку. Для регулярних сценаріїв для групи у меню додатково доступний пункт Статуси запуску на групу.

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

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

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

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

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