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

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

Задати умови запуску/зупинки можна двома способами:

1. У параметрах блока Старт.

2. Через загальний список сценаріїв (розділ Тригери → Сценарії).

Клікніть Налаштування запуску/зупинки у полі потрібного сценарію.

Налаштування запуску

1. Активуйте перемикач Налаштування запуску.
2. Виберіть одну з наступних умов:

• За подією
• Регулярний
• За зміною поля контакту
• За подією з параметрами групи

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

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

Налаштування запуску за подією

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

Коли ви обираєте умову За подією, ви можете встановити такі параметри запуску сценарію:

• Подія
• Обов’язкові параметри події
• Обробляти унікальні події

Вибір події

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

Одна і та сама подія може запускати різні сценарії, що дозволяє розділяти складні схеми на окремі незалежні один від одного ланцюжки умов та дій

Вибір обов’язкових параметрів

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

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

Для доступу до вкладених параметрів події використовуйте такі формати запису:

• Крапковий селектор — order.orderId
• Індексний селектор — items[0]
• Комбінований — order.items[0].title

Це дозволяє фільтрувати запуск сценарію за значеннями всередині складних об'єктів та масивів.

Доступні наступні параметри перевірки:

• дорівнює,
• не дорівнює,
• вказано,
• не вказано, 
• вірно,
• невірно,
• містить,
• не містить,
• починається з,
• не починається з,
• закінчується на,
• не закінчується на,
• один з,
• не один з.

Для булевих параметрів події, наприклад isFirst, можна використовувати вірно, невірно, дорівнює, не дорівнює, вказано, не вказано, містить, не містить, починається з і не починається з. Для прямої перевірки значення true/false використовуйте вірно або невірно, або оператор дорівнює зі значенням true чи false.

За необхідності ви зможете додати перевірку інших значень (умови ТА/АБО, їх кількість не обмежена).

Вибір обробки унікальних подій

Унікальні події визначають, чи потрібно:

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

Щоб вибрати потрібну умову, натисніть радіокнопку біля одного з пунктів Обробляти унікальні події.

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

Налаштування регулярного сценарію

Параметри конфігурації регулярного сценарію:

• Група. Дозволяє додати групу контактів.
• Розклад запуску. Визначає періодичність виконання сценарію.
• Дата і час запуску. Визначає дату і час запуску сценарію.
• Дозволені дні запуску. Дозволяє встановити конкретні дні тижня для запуску сценарію.
• Закінчення сценарію. Дозволяє встановити дату завершення сценарію.
• Обробляти унікальні події. Дивіться розділ Вибір обробки унікальних подій.
• Не запускати сценарій, якщо є той, що виконується.

У полі Група доступні лише умовні групи.

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

Запуск з'являється в Статусах запуску на групу лише після завершення.

Для email-повідомлень, які сценарій надсилає окремими відправками (а не масовою розсилкою) — включно з відправками, ініційованими через API, — діє ліміт швидкості надсилання. За замовчуванням він становить орієнтовно 100 листів на годину; це технічний параметр акаунту, тому фактичне значення може відрізнятися, а для довірених акаунтів обмеження може не застосовуватися. Щоб дізнатися поточне значення ліміту для вашого акаунту або підвищити його, зверніться до підтримки.

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

Встановлені значення днів та часу у параметрах запуску означають, що розсилка буде запущена, коли настане вказаний час та дата. Наприклад, якщо ви встановили час запуску з 09:00 до 10:00 раз на день, це означає, що сценарій буде автоматично запускатися в межах зазначеного часу кожного дня. Точну хвилину запуску задати не можна: сценарій запускається в будь-який момент у межах вибраної години. 

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

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

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

Сценарій стартуватиме, коли поле контакту зміниться в результаті імпорту контакту або оновиться одним з API методів:

• Add/update contacts
• Add/update a contact
• Update contact

Створення контакту не запускає такий сценарій: поле має змінитися у вже наявного контакту. Щоб охопити нових контактів, запускайте регулярний сценарій для групи — тоді новий контакт потрапить у сценарій не одразу, а під час наступного запуску (не частіше ніж раз на годину).

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

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

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

Налаштування

1. У редакторі сценарію відкрийте блок Старт і активуйте Налаштування запуску.
2. Виберіть За подією з параметрами групи та вкажіть подію.
3. У полі Група виберіть наявну групу Умовна з параметрами або створіть нову, не виходячи з редактора сценарію.
4. В умовах групи вкажіть параметр, який має відповідати параметру події.

У нашому випадку параметр групи — це ID книги, яку читає контакт (bookStartedBookId), а параметр події — динамічна змінна оновленої книги ($bookUpdatedBookId).

5. Збережіть групу, щоб повернутися до налаштувань запуску. Створену групу буде вибрано в полі Група.

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

Налаштування зупинки

Для налаштування зупинки:

1. Активуйте перемикач Налаштування зупинки.
2. Оберіть одну з наступних умов:

• За подією
• За знаходженням у групі
• За замовленням

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

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

Налаштування зупинки за подією

Умова За подією зупиняє сценарій у разі, якщо відбувається (або відбулась до запуску сценарію) одна з обраних подій.

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

Щоб налаштувати умови зупинки за подією:

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

Для перегляду ключів унікальності перейдіть до розділу Тригери → Історія подій.

2. Введіть значення періоду (максимум 2 роки). Сценарій зупиниться якщо подія відбудеться у вказаний період до початку його запуску. 

Налаштування зупинки за знаходженням у групі 

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

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

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

При зупинці сценарію за знаходженням у групі та за замовленням система шукає контакт за contactId, якщо він не вказаний — за іншими ідентифікаторами

Налаштування зупинки за замовленням

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

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