Редактор сценаріїв

Для чого це потрібно?

Редактор сценаріїв — це місце, де ви будуєте автоматизовані послідовності комунікацій для ваших подій. Ви візуально розташовуєте дії — наразі це надсилання електронних листів — на часовій шкалі відносно події (до, при реєстрації, після). Редактор показує чіткий потік: дії перед подією → сама подія → дії після події. Це дозволяє проектувати капельні кампанії, нагадування, послідовності після події та сповіщення без написання коду.

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

1. Відкрити Редактор сценаріїв

• Со сторінки Списку сценаріїв натисніть СТВОРИТИ СЦЕНАРІЙ, щоб почати новий.
• Або натисніть Редагувати у меню (⋮) існуючого сценарію, щоб змінити його.
• Відкриється редактор з верхньою панелью інструментів та областю полотна нижче.

2. Зрозумійте розташування полотна

Полотно відображає ваш сценарій як горизонтальний потік:

• Ліва сторона (Перед подією): Дії, що спрацьовують до початку події, відсортовані за часом (спочатку тригери при підписці, потім тригери часу-перед-подією від найдовшого до найкоротшого зсуву).
• Центр (Подія): Фіксований маркер етапу події — показує назву події та іконку календаря.
• Права сторона (Після події): Дії, що спрацьовують після закінчення події, відсортовані за часом (від найкоротшого до найдовшого зсуву).
• Стрелки з'єднують кожен крок, показуючи порядок виконання.

3. Додати дію Email (Завдання)

1. На верхній панелі інструментів знайдіть секцію ДІЇ (ліва група).
2. Натисніть на іконку конверта (підказка: "створити email-дію").
3. З'явиться вікно — налаштуйте дію email (деталі в інструкції Налаштування email-дії).
4. Натисніть Зберегти у вікні.
5. Нова картка дії email з'явиться на полотні в правильній позиції залежно від типу тригера.

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

1. На полотні знайдіть картку дії email, яку хочете змінити.
2. Натисніть на випадаюче меню (⋮) на картці.
3. Виберіть Редагувати.
4. Змініть налаштування у вікні та натисніть Зберегти.
5. Картка оновиться на полотні.

5. Видалити дію Email

1. На полотні відкрийте випадаюче меню (⋮) картки дії.
2. Виберіть Видалити.
3. Підтвердіть у діалозі. Дія зникне з полотна та сценарію.

6. Встановити метадані сценарію (Назву та Опис)

1. На верхній панелі інструментів знайдіть секцію НАЛАШТУВАННЯ (права група).
2. Натисніть на іконку метаданих (тег/мітка, підказка: "Додати метадані").
3. Відкриється вікно з двома полями:
   • Назва (обов'язкове, макс. 100 символів) — за замовчуванням: "Custom journey"
   • Опис (необов'язкове, макс. 200 символів)
4. Заповніть поля та натисніть Зберегти.
5. Назва сценарію з'явиться у списку та при призначенні до подій.

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

1. У секції НАЛАШТУВАННЯ (права група панелі) натисніть кнопку Зберегти (іконка дискетки, підпис: "зберегти").
2. Якщо це новий сценарій: він збережеться, а URL оновиться з його ID.
3. Якщо редагуєте: зміни збережуться. З'явиться toast з повідомленням про успіх.

8. Перевірити, де використовується сценарій

1. У секції ІНСТРУМЕНТИ (центральна група панелі) натисніть на іконку інформації (i в колі, підказка: "інформація про використання сценарію у подіях").
2. Відкриється вікно зі списком усіх подій, що використовують цей сценарій, з їхніми назвами та статусами.
3. Якщо сценарій використовується в якомусь активному події, на полотні з'явиться іконка замка з написом "редагування заблоковано, використовується в активних подіях!" — ви не зможете редагувати дії в такому стані.

9. Повернутися до Конструктора подій (якщо з'ясувалося)

• Якщо ви відкрили редактор з Конструктора подій (під час налаштування сценарію для події), у секції НАЛАШТУВАННЯ з'явиться кнопка Назад до редактора.
• Натисніть її, щоб зберегти сценарій і повернутися до Конструктора подій із попередньо вибраним сценарієм.

Важливі правила та поради

Примітка: Наразі існує лише один тип дії — Дія Email (Надіслати Email). Майбутні оновлення можуть додати SMS, вебхуки або інші типи дій.

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

Візуальне сортування: Ви не можете перетягувати дії для зміни порядку. Система автоматично позиціонує дії на основі їх типу тригера та часу:

• Тригери при підписці завжди з'являються першими (найлівіше).
• Тригери час-перед-подією сортуються за зсувом за спаданням (напр., 5 днів перед → 30 хв перед).
• Тригери час-після-подієї сортуються за зсувом за зростанням (напр., 30 хв після → 5 днів після).

Ліміти символів:

• Назва сценарію: макс. 100 символів
• Опис сценарію: макс. 200 символів
• Тема email: макс. 100 символів
• Тіло email: макс. 300 символів (у редакторі)

Обов'язкові поля: Назва сценарію та принаймні одна Дія Email з усіма її обов'язковими полями (Шаблон, Тема, Тіло) мають бути заповнені для успішного збереження.

Поширені запитання та виправлення неполадок

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

Я додав дію, але вона з'явилася не в тій позиції. Дії автоматично сортуються за типом тригера та часом. Перевірте тип тригера (Перед/Після/При підписці) та значення зсуву — позиція розраховується автоматично.

Кнопка Зберегти, здається, нічого не робить. Перевірте, чи ввели ви Назву сценарію у вікні Метаданих, і чи всі дії Email мають заповнені обов'язкові поля (Шаблон, Тема, Тіло). Помилки з'являються червоним текстом під порожніми обов'язковими полями.

Чи можу я мати кілька дій Email з однаковим часом спрацювання? Так. Вони з'являться як окремі картки послідовно. Порядок між діями з однаковим часом слідує за порядком створення.

Що станеться, якщо я видалю дію, яка вже надіслалася деяким підписникам? Видалення дії впливає лише на майбутні виконання. Email-и, вже надіслані або стоячі в черзі на найближчі спрацювання, не відкликаються.

Як протестувати мій сценарій перед використанням у реальній події? Створіть тестову подію, призначте сценарій і використайте функцію "Попередній перегляд Email" у вікні кожної дії Email, щоб побачити, як відображатиметься email із шорткодами.