Група блоків "Загальні"

Група блоків "Загальні" містить базові блоки, які є обов'язковими або беруть участь в більшості сценаріїв, їх шість:

• Початок

• Кінець

• Таймер

• Запуск за часом

• Завдання

• Умова

Блок "Початок"

Обов'язковий блок, без якого сценарій не запуститься. При створенні нового сценарію він з'являється автоматично. Якщо ви його випадково видалили, то встановіть заново: клікніть іконку блоку ліворуч або перетягніть з панелі в редактор. Блок "Початок" у сценарії може бути тільки один.

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

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

• якщо за ним запускалася певна подія (наприклад, раніше підписався на курс і вже отримав навчальний ланцюжок);

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

• він уже зробив замовлення (наприклад, за 7 днів до початку розсилки).

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

• сценарій за подією;
• сценарій за входженням до групи;
• сценарій за замовленням.

Завершити сценарій за подією

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

Пошук подій здійснюється за ключем — унікальним параметром, який є у кожної події (його вказують у полі "Ключ події" при створенні події, найчастіше в цьому параметрі передається емейл або ID контакту). Змінна називається ${eventKey} — це універсальна назва змінної для ключа події — і за замовчуванням прописана в блоці. Під час запуску сценарію перевіряється вибрана подія: якщо подію була знайдено, то сценарій на цьому завершується. 

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

Завершити сценарій за входженням до групи

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

• номера телефону;

• email;

• ID контакту в eSputnik.

Звершити сценарій за замовленням

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

• номера телефону;

• email;

• ID контакту в eSputnik.

В першу чергу пошук виконується за ID контакту, якщо його не вказано, то по externalCustomerId, якщо він є в параметрах події.

Блок "Кінець"

Блок "Кінець" — другий обов'язковий елемент, без якого сценарій не спрацює. Може бути використаний кілька разів. Блок означає завершення сценарію. Всі шляхи (гілки) сценарію обов'язково мають закінчуватися блоком "Кінець".

Блок "Таймер"

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

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

Наприклад: після підтвердження підписки стартує сценарій з welcome-серією. Людина перейшла за посиланням "Підтвердити підписку" → система відправить першого листа з ланцюжка → після цього зробить паузу в один день і відправить другого листа. На цьому сценарій закінчиться.

Для налаштування блоку "Таймер" праворуч задаються 2 параметри:

• Час очікування

• Чекати до

Ви можете обрати одну умову або обидві, але для роботи блоку необхідно вказати мінімум один параметр.

Параметр "Час очікування"

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

Параметр "Чекати до"

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

Налаштування часу надсилання працюють за такою ж логікою. Якщо ви виставили час відправки на 8:45, а сценарій запустився о 15:00, то клієнт отримає лист о 8:45 наступного дня (якщо не вказано конкретний день тижня).

Зверніть увагу на загальну логіку роботи блоку "Таймер". Наприклад, ви скомбінували параметри так:

• Час очікування – 1 день;
• Чекати до понеділка;
• Години та хвилини – 8:45.

Сценарій запустився в неділю о 15:00. Система чекає 1 день (24 години). Настає понеділок. Час закінчення роботи параметра “Час очікування – 1 день” у нашому прикладі – 15:00 у понеділок.

Далі система перевіряє день тижня у параметрі "Чекати до". У нас обрано понеділок, сьогодні понеділок – поки що все добре. Після цього слід перевірити час відправлення. Умовами встановлено 8:45, а зараз 15:00. Умови не спрацювали. Це означає, що клієнт отримає лист не цього понеділка, а лише наступного о 8:45.

Виставляйте параметри уважно!

Блок "Запуск за датою"

Блок використовується для відправлення повідомлення:

• за N днів/годин/хвилин до дати й часу, які ви передаєте в події,
• із зазначенням часу запуску (з події або вказаного вручну),
• за датою (з параметра події або вказаною у блоці).

У параметрі "За" вказуємо, за який час до події треба відправити повідомлення: за 1 годину, 3 дні, 10 хвилин тощо.

У параметрі "Перед датою" доступна можливість витягнути потрібну дату з переданої події, нижче вставляємо ту саму назву, якою цей параметр прописаний у самій події. Наприклад: ${date}.

Важливо! Треба точно передати час і дату. Допускаються два формати:

1) за часом UTC: 2011-12-03T10:15:30;

2) за часом UTC із коригуванням за таймзоною: 2011-12-03T10:15:30+02:00.

+02:00 у цьому випадку — це коригування часу для подій в Україні, оскільки час у Києві на 2 години випереджає час за UTC взимку.

Блок "Завдання"

Призначення цього блоку — вирішити одне із завдань:

• Створити контакт;

• Оновити контакт;

• Отримати контакт;

• Підтвердити контакт;

• Відправити обов'язковий (транзакційний) email;

• Відправити транзакційне Viber повідомлення;

• Відправити транзакційне SMS повідомлення;

• Отримати замовлення;

• Створити промокод;

• Запустити подію;

• Отримати промокод.

Вибрати потрібне завдання можна з випадаючого списку або через пошук.

Створити контакт

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

Завдання має три параметри:

• Contact's email — обов'язкове поле для завдання, якщо треба створити контакт за email. За замовчуванням там вже прописано змінну ${email}. Якщо у вас в події інша назва змінної, треба вписати в поле саме її.
• Phone — обов'язкове поле для завдання, якщо треба створити контакт за номером телефону. За замовчуванням там вже прописано змінну ${phoneNumber}. Якщо у вас у події інша назва змінної, треба вписати в поле саме її.
• JSON — у цьому полі прописується рядок або ставиться змінна, що містить рядок у форматі JSON, із даними для заповнення полів контакту (телефон, ім'я, прізвище, місто, додаткові поля). Якщо його не прописати, то залишиться тільки емейл. За необхідності зафіксувати ім'я, прізвище, дату народження тощо поле потрібно заповнити обов'язково.

В полі JSON ви можете вказати змінну contactJson. В такому випадку, на REST API буде виконана валідація значень цього параметра. У разі передачі параметрів контакту з помилками, в повідомленні про помилку будуть вказані параметри, що містять помилку, а також допустимі значення.
Приклад даних для поля json:

{"firstname":"...","lastname":"...","sms":"...","town":"...","profileInputs":

[{"profileInputId":10001,"value":"..."}]}

Де:

• profileInputs — масив додаткових полів;

• profileInputId — ID додаткового поля;

• value — значення додаткового поля;

• confirmed — статус email-адреси контакту (підтверджено/не підтверджено).

 

У цьому випадку поле json матиме таку структуру:

{"firstname":"...","lastname":"...","sms":"...","town":"...","profileInputs":

[{"profileInputId":10001,"value":"..."}],"confirmed":false}

Якщо потрібно створити контакт із певним значенням поля типу “дата”, то використовуйте формат такого вигляду: "DD/MM/YYYY":

{"profileInputs": [{"profileInputId":10001,"value":"11/06/2011"}]}

 

Якщо потрібно створити контакт із певним значенням поля типу “дата з часом”, то використовуйте формат такого вигляду: "DD/MM/YYYY HH:mm":

{"profileInputs": [{"profileInputId":10001,"value":"11/06/2011 16:42"}]}

Оновити контакт

Завдання використовується для оновлення інформації про контакт у системі, працює за принципом завдання "Створити контакт". Єдина відмінність: якщо контакт уже є в системі, то він оновиться, а якщо немає — система його НЕ продублює, а просто пропустить.

Завдання є актуальним, коли треба оновити дані контакту з події, переданої за API методом Generate event v2, або якщо в сценарії треба задавати фіксоване значення додаткового поля.

Завдання має чотири параметри:

• ContactId – якщо ви хочете оновити контакт не по email, а за його ID в системі, необхідно прописати назву змінної, в якій міститься ID контакту. За умовчанням у системі вона називається ${ContactId}.

• Email – обов'язкове поле для завдання. За замовчуванням там уже прописано змінну ${email}. Якщо у вас у події інша назва змінної, необхідно вписати в поле саме цю назву. У наших системних подіях змінна зветься EmailAddress. Системні події — це ті, що генеруються всередині самої системи (клік кнопки в листі, запуск регулярного сценарію за групою, форма підписки, реактивація за допомогою RFM-аналізу). Для них у поле треба вписати ${EmailAddress}.

• Phone – номер телефону контакту

• JSON – у цьому полі прописується рядок або ставиться змінна, що містить рядок у форматі JSON, із даними для заповнення полів контакту (телефон, ім'я, прізвище, місто, додаткові поля). Формат даних такий самий, як і для завдання "Створити контакт", але параметр confirmed ігнорується.

Отримати контакт

Мета завдання — отримати дані про контакт і передати їх у лист або для блоку "Умова". Наприклад, ми бажаємо запускати відправлення листа-повідомлення з контактними даними щоразу, коли в базі з'являється новий підписник. Другий варіант — ми хочемо після реєстрації надіслати клієнтові його реєстраційні дані.

Завдання працює таким чином:

1. У системі створюється (реєструється) подія, яка містить дані про контакт.

2. Завдання витягує всі наявні дані щодо контакту, які зберігаються в базі.

3. Отримані дані передаються в лист.

Завдання має чотири параметри:

• ContactId — ID контакту в системі eSputnik.

• EmailAddress — email-адреса контакту.

• Phone — номер телефону контакту.

• MobPushToken — мобільний токен контакту.

Параметри EmailAddress, ContactId, Phone та MobPushToken використовуються для вибору способу ідентифікації контакту. Одне з цих полів має бути обов'язково заповнене відповідними даними.

Наприклад, якщо ви бажаєте ідентифікувати людину не за email, а за її ID в системі, ви прописуєте назву змінної, яка містить ID контакту. За замовчуванням у системі вона зветься ${ContactId}.

У листі можна використовувати такі змінні:

• $!Data.get ('firstName') — ім'я;

• $!Data.get ('lastName') — прізвище;

• $!Data.get ('email') — email-адреса;

• $!Data.get ('sms') — номер телефону;

• $!Data.get ('contactKey') — ключ контакту;

• $!Data.get ('id') — ID контакту в системі;

• $!Data.get ('createdDate') — дата створення;

• $!Data.get ('updatedDate') — дата останньої зміни контакту;

• $!Data.get ('confirmed') — статус email-адреси контакту (true — підтверджено, false — не підтверджено);

• $!Data.get ('fields'). get ('12345') — додаткові поля. Замість "12345" треба підставити ID додаткового поля.

Підтвердити контакт

Мета завдання — підтвердити email-адресу підписника і зробити його активним у системі, щоб йому надходили листи.

Наприклад: коли людина заповнює форму підписки, контакт потрапляє до eSputnik із непідтвердженим email і йому на пошту надходить повідомлення з проханням підтвердити підписку. Доки він не перейде за посиланням підтвердження, контакт не отримуватиме розсилки. Коли людина підтверджує підписку, запускається сценарій, спрацьовує завдання "Підтвердити контакт" і вона стає активною в системі.

Завдання має два параметри:

• EmailAddress — у цьому полі за замовчуванням використовується змінна ${EmailAddress}, тож ви можете залишити це поле порожнім. Ви змінюєте її, тільки якщо створюєте власну змінну, яка містить email.

• ContactId — якщо ви бажаєте підтвердити контакт не за email, а за його ID в системі, то слід прописати назву змінної, яка містить ID контакту. За замовчуванням у системі вона зветься ${ContactId}.

Ми рекомендуємо залишати в цьому блоці налаштування за замовчуванням. У дуже рідкісних випадках логіка вашого сценарію може потребувати внесення змін. У такому випадку зверніться за консультацією до  support@esputnik.com.

Відправити обов'язковий (транзакційний) email

Мета завдання — відправити лист контактові, незважаючи на його статус у системі. Тобто ви матимете змогу відправити листа на будь-який email (підтверджений, непідтверджений, відписався, із позначкою "скаржився на спам"), окрім контактів із чорного списку.

Завдання має п’ять параметрів:

• Email контакту — поле для введення параметра з події, в якій передається email-адреса одержувача. За замовчуванням у це поле ставиться стандартний параметр із системних подій eSputnik — ${EmailAddress}. При використанні завдання “Відправити обов'язковий (транзакційний) email" у полі email вказується назва змінної з події.

• Повідомлення — обов'язкове поле. Виберіть заздалегідь створений лист, який має бути відправлений.

• ID контакту — ідентифікатор контакту в системі eSputnik. Може використовуватися для ідентифікації отримувача замість email-адреси.

• languageParam — ID мови або параметр події, що містить його. Він потрібний для створення мультимовних повідомлень. Залиште поле порожнім, якщо ви не використовуєте мультимовність або якщо мова контакта вказана в їх картках.

• jsonParam — довільні дані в форматі JSON, які передаються до листа. Якщо в параметрі події ви передаєте рядок з такими даними, то в поле JSON треба вставити назву цього параметра.

Наприклад, ви передаєте дані про замовлення і треба вивести в листі список замовлених товарів. У такому випадку в події ви передаєте дані про товари у вигляді рядка:

{

"name": "items",

"value": "{"array":[{"name":"Суха дитяча молочна суміш HiPP Combiotic 2, 750 г","price":"341.00","url":"https://site.com/catalog/suha-dityacha-molochna-sumish-hipp-combiotic-2-750-g","imageUrl":"https://site.com/uploads/product/big/20161122/20161122_7zvb.jpg"},{"name":"Молочна органічна вівсяна каша з яблуком HiPP \"На добраніч”\", 250 г","price":"78.00","url":"https://site.com/catalog/molochna-organichna-vivsyana-kasha-z-yablukom-hipp-na-dobranich-250-g","imageUrl":"https://site.com/uploads/product/big/23112013/2125.jpg"}]}"

}

У нашому прикладі параметр зветься items. Відповідно в поле JSON прописуємо ${items}.

Відправити транзакційне Viber повідомлення

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

Завдання має шість параметрів:

• Повідомлення — обов'язкове поле. Виберіть заздалегідь створений лист, який має бути відправлений.

• Телефон – номер телефону контакту.

• Час життя повідомлення, сек – через вказаний час повідомлення буде видалено з телефону.

• ID контакта – ідентифікатор контакту в системі eSputnik. Може використовуватися для ідентифікації отримувача замість email-адреси.

• languageParam — ID мови або параметр події, що містить його. Він потрібний для створення мультимовних повідомлень. Залиште поле порожнім, якщо ви не використовуєте мультимовність або якщо мова контактів вказана в їх картках.

• jsonParam –  довільні дані в форматі JSON, які передаються до листа. Якщо в параметрі події ви передаєте рядок з такими даними, то в поле JSON треба вставити назву цього параметра.

Відправити транзакційне SMS повідомлення

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

Завдання має п’ять параметрів:

• Повідомлення — обов'язкове поле. Виберіть заздалегідь створений лист, який має бути відправлений.

• Телефон – номер телефону контакту.

• contactId – ідентифікатор контакту в системі eSputnik. Може використовуватися для ідентифікації отримувача замість email-адреси.

• languageParam — ID мови або параметр події, що містить його. Він потрібний для створення мультимовних повідомлень. Залиште поле порожнім, якщо ви не використовуєте мультимовність або якщо мова контактів вказана в їх картках.

• jsonParam –  довільні дані в форматі JSON, які передаються до листа. Якщо в параметрі події ви передаєте рядок з такими даними, то в поле JSON треба вставити назву цього параметра.

Отримати замовлення

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

Блок застосовується лише у сценаріях, у яких події передаються API методом Add orders.

Щоб налаштувати параметри завдання "Отримати замовлення":

Клікніть на стрілці, щоб розгорнути список «Отримати замовлення по» і виберіть один з варіантів:

• ID замовлення. Вибирайте цей варіант, коли хочете отримати дані замовлення по ID, який сформований нашою системою.

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

Не обов'язково заповнювати поле ID замовлення/Зовнішній ID замовлення. Завдання автоматично отримує всі параметри з події про замовлення.

Завдання працює наступним чином:

1. Система отримує дані про замовлення.

2. Блок "Завдання" отримує всі дані, які передаються із замовленням, і передає ці данні до листа, де вони прописані у вигляді змінних.

Докладніше про блок "Завдання" читайте у статті Автоматизація роботи із замовленнями.

Створити промокод

Мета завдання — створити (згенерувати) промокод і передати його до листа, що є наступним у ланцюжку. Якщо ви вибрали метод формування промокодів через сценарій, система eSputnik згенерує промокод і передасть дані до листа. Параметри будуть зашифровані за вашим ключем алгоритмом, а при введенні такого промокоду на сайті його розшифрує зворотний алгоритм. Детальніше.

Завдання має чотири параметри:

• days — вказується кількість днів до завершення терміну дії промокоду. Система їх додасть до поточного числа і отриману дату завершення терміну дії зашифрує в промокод.

• type — тип промокоду. У вас може бути 32 типи промокодів, які ви задаєте самі. Наприклад: промокод за підписку — надано type 0, до дня народження — type 1, реактивація — type 3 та ін. У змінній вказується число від 0 до 31, яке відповідає потрібному типу.

• discount — розмір знижки. Використовується для генерації промокоду, коли знижка надається у відсотках від суми замовлення. Це завжди двозначне число, тому знижки до 10% слід доповнити нулем попереду. Наприклад, указати 05 для підстановки до листа 5% дисконту.

• key — ключ шифрування. Можна не міняти й залишити за замовчуванням.

Після цього блоку в сценарії ставиться блок відправлення повідомлення (Email, SMS, Viber тощо). У листі на місці промокоду треба використовувати змінну $!Data.get ('promocode').

Запустити подію

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

Завдання має три параметри:

• eventTypeId — обов'язкове поле. У ньому треба вибрати тип події, що запускається.

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

• params — масив параметрів, які ми бажаємо передати до події, що запускається. Якщо поле не заповнено, будуть передані параметри з події, що запустила поточний сценарій. Формат параметрів є таким:

[{"name":"paramName","value":"значення параметра"}]

Отримати промокод

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

Завдання має три параметри (всі обов'язкові):

• days — кількість днів від поточної дати, протягом яких промокод ще має бути діючим;

• type — заданий вами для сегментації тип промокоду;

• discount — розмір знижки від 01 до 99.

Згідно з ними система відбиратиме промокоди із завантаженої бази. Принцип роботи розглянемо на прикладі. У параметрах зазначимо такі дані: days — 10, type — newyear, discount — 25.

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

Після блоку "Отримати промокод" у сценарії ставиться блок відправлення повідомлення (Email, Viber, Push або SMS). У листі в те місце, де має бути промокод, треба вписати змінну $!Data.get ('promocode').

Блок "Умова"

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

Блок має один вхід (блок "Початок") і два виходи ("Кінець"): для гілки "Так" і для гілки "Ні".

Блок "Умова" має 7 завдань:

• Перевірити подію;

• Змінна відповідає регулярному виразу;

• Контакт підтверджений;

• Контакт існує;

• Користувач залогінився (завдання є службовим і в практичних цілях не використовується);

• Перевірити параметр за значенням дати/часу.

• Перевірити поле контакту на відповідність до параметра з події.

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

Перевірити подію

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

Завдання має два параметри:

• key — який ключ події шукати. Наприклад, ключами подій, що перевіряються, може бути email-адреса. Таким чином, у цьому полі необхідний параметр, що містить email-адресу. Це параметр із події, що запустила поточний сценарій. Якщо він має назву EmailAddress, то в полі слід написати ${EmailAddress}.

• type — тип подій, які треба перевіряти. Обов'язкове поле, без якого сценарій не буде працювати.

Змінна відповідає регулярному виразу

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

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

Завдання має два параметри:

• name — назва змінної, яку треба перевірити. Це може бути параметр із події. Зверніть увагу, що в цьому полі назва параметра записується без ${}. Якщо ж ми перевіряємо дані, отримані іншими блоками сценарію (наприклад, блок "Отримати контакт"), то слід вписати в поле системну змінну smartMessageJson.

• pattern — регулярний вираз, на відповідність якому ми перевіряємо дані. Наприклад: ми бажаємо перевірити, що параметр address із події містить текст "Київ". У цьому випадку в pattern прописуємо .*Київ.*

Приклад роботи і повного налаштування такого блоку.

Контакт підтверджено

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

Наприклад, людина зареєструвалася на сайті або підписалася на вашу розсилку. Ви бажаєте надіслати їй привітальний лист.

У цьому випадку:

1. Контакт з'являється в базі eSputnik, але має статус непідтвердженого;

2. Людині відправляється лист із проханням підтвердити реєстрацію;

3. Завдання перевіряє, підтвердила людина реєстрацію чи ні;

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

5. Якщо ще не підтвердила реєстрацію, сценарій перебігає за гілкою "Ні".

Завдання має два параметри:

• EmailAddress — email-адреса контакту.

• ContactId — ID контакту в системі.

За замовчуванням система перевіряє, підтверджений контакт чи ні, за email: там уже прописано службову змінну EmailAddress, і якщо змінна, яка містить email, так і прописана в події, можна нічого не змінювати. Якщо змінна в події має іншу назву, тоді потрібно додати в форматі ${назва змінної з події}. Наприклад, ${MailAddress}.

Якщо ви бажаєте, щоб ідентифікація здійснювалася за ID контакту, треба в поле ContactId вписати змінну ${ContactId}.

У будь-якому випадку має бути вказаний один із параметрів.

Контакт існує

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

У цього завдання є два параметри, так само як у завдання "Контакт підтверджений":

• EmailAddress — email-адреса контакту.

• ContactId — ID контакту в системі.

За замовчуванням система перевіряє, існує контакт чи ні, за email. Якщо ви бажаєте, щоб ідентифікація здійснювалася за ID контакту, треба в поле ContactId вписати змінну ${ContactId}.

Перевірити параметр за значенням дати/часу

Мета завдання — перевірити дату з параметра події.

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

Наприклад, перевіряємо дату з часом 2020-07-30 13.00. Часовий пояс користувача - (GMT +3) Europe/Kiev, відповідно, в подію буде передано "2020-07-30T13:00 + 03:00".

У завдання є:

• Назва параметра — необхідно вказати значення параметра, яке передається в параметрі. Потрібний формат передачі дати - ISO 8601.

• Дата, де необхідно вибрати зі списку конкретну дату або діапазон дат.

• Вибір конкретної дати.

Назва параметра

Поле «Назва параметра» приймає назву параметра в системі.

• Введіть назву параметра у вигляді змінної або рядка. Наприклад, ${userId} або 123abc.

Вибір параметрів дати та/або часу

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

• Дата

• Дата з часом

• Діапазон дат

• Діапазон часу

• Діапазон дат з часом

• Дата входить до періоду до

• Дата входить до періоду після

• Дата з часом більше поточного на

2. Налаштуйте потрібні параметри дати й часу для вибраного параметра, як описано нижче.

Налаштування параметрів «Дата»

Коли ви вибираєте «Дата», блок «Умова» перевіряє, чи збігається дата події з вибраною датою для цього параметра.
Щоб вибрати дату:

• Натисніть на значок календаря та виберіть потрібну дату.

Налаштування параметрів «Дата з часом»

Коли ви вибираєте «Дата з часом», блок «Умова» перевіряє, чи збігається дата події з вибраними датою та часом для цього параметра.

Щоб вибрати дату з часом:

1. Клікніть на значок календаря та виберіть потрібну дату у вікні вибору дати.

2. У вікні вибору годин виберіть потрібну годину.

3. У вікні вибору хвилин виберіть точний час. Значення часу в цьому вікні знаходяться в межах 1 години з діапазоном в 5 хвилин.

Налаштування параметрів «Діапазон дат»

Коли ви вибираєте «Діапазон дат», блок «Умова» перевіряє, чи збігається дата події з вибраним діапазоном дат для цього параметра.

Щоб вибрати діапазон дат:

• Клікніть на піктограмі календаря біля верхнього поля дати та виберіть початкову дату діапазону.

• Клікніть на піктограмі календаря біля нижнього поля дати та виберіть кінцеву дату діапазону.

Налаштування параметрів «Діапазону часу»

Коли ви вибираєте параметр «Діапазон часу», блок «Умова» перевіряє, чи збігається діапазон часу події з вибраним діапазоном часу для цього параметра.

Щоб вибрати діапазон часу:

• Клікніть на піктограмі календаря біля верхнього поля часу та виберіть початковий час у вікні вибору часу.

• Клікніть на піктограмі календаря біля нижнього поля часу та виберіть час завершення у вікні вибору часу.

Налаштування параметрів «Діапазон дат з часом»

Коли ви вибираєте «Діапазон дат з часом», блок «Умова» перевіряє, чи відповідають діапазон дати й часу події вибраному діапазону дати й часу для цього параметра.

Щоб вибрати діапазон дати/часу:

1. Клікніть на верхній піктограмі календаря та виберіть потрібну початкову дату у вікні вибору дати.

2. У вікні вибору годин виберіть потрібну годину.

3. У вікні вибору хвилин виберіть точний час. Значення часу в цьому вікні знаходяться в межах 1 години з кроком 5 хвилин.

4. Клікніть на нижній піктограмі календаря та виберіть кінцеву дату, годину та хвилини, так саме як і для початкових дати та часу.

Налаштування параметрів «Дата входить до періоду до»

Коли ви вибираєте «Дата входить до періоду до», блок «Умова» перевіряє, чи знаходиться дата події, отримана як параметр, в діапазоні дат до вибраної дати.

Щоб вибрати параметри для «Дата входить до періоду до»:

• Клікніть на піктограмі календаря поруч із полем дати та оберіть дату.

Налаштування параметрів «Дата входить до періоду після»

Коли ви вибираєте «Дата входить до періоду після», блок «Умова» перевіряє, чи знаходиться дата події, отримана як параметр, в діапазоні дат після вибраної дати.

Щоб вибрати параметри для «Дата входить до періоду після»:

• Клікніть на піктограмі календаря поруч із полем дати та оберіть дату.

Налаштування параметру «Дата з часом більше поточного на»

Коли ви вибираєте «Дата з часом більше поточного на», блок «Умова» перевіряє, чи дата та час події, отримані як параметр, перевищують поточну дату та час на N хвилин/годин/днів.

Приклад:

Ви організуєте вебінар з датою та часом початку 2022-10-10 16:00.

Ви налаштували відправлення 3 повідомлень зареєстрованим учасникам: за 30, 10 і 5 хвилин до початку вебінару.

Дата та час реєстрації учасника - 2022-10-10 15:52 (поточна дата та час).

Блок "Умова" порівнює поточний час з часом із параметра події. В результаті порівняння:

• Відправлення першого повідомлення скасовується, оскільки умова відправлення повідомлення (за 30 хв) не виконується.

• Відправлення другого повідомлення скасовується, оскільки умова відправлення повідомлення (за 10 хв) не виконується.

• Третє повідомлення буде відправлено згідно з розкладом, оскільки умова відправлення повідомлення (за 5 хв) виконується.

Щоб налаштувати умову "Дата та час більше поточного на":

• Введіть значення в поле дати/часу і виберіть його формат зі списку: хвилини, години або дні.

Перевірити поле контакту на відповідність до параметра з події

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

Завдання має 5 параметрів:

• Contact ID – ідентифікатор контакту у системі eSputnik.

• Phone – це номер телефону контакту.

• Contact's email – email-адреса контакту.

• Contact's field – поле із картки контакту, відповідність якого потрібно перевірити. Можна вибрати зі списку або за допомогою пошуку в рядку. Порівнювати можна поля таких типів: текстове поле, текстова область, число, дробове число, випадаючий список.

• Event parameter – параметр події, на відповідність до якого перевіряємо поле контакту. Значення можна вказати як змінну ${parameterName} (назва параметра у події, наприклад ${city}) – у цьому випадку порівнюється поле контакту, вказане в Contact's field, зі значенням із зазначеного параметра у події. Також можна задати рядок у форматі 123abc (наприклад, Київ) – тоді відбувається порівняння поля контакту з конкретним значенням, вказаним у параметрі (тобто Contact's field 123abc?). Якщо при порівнянні операція має бути чутливою до регістру, встановіть відповідний прапорець під цим полем.

Перші три параметри використовуються для вибору способу ідентифікації контакту. Для коректної роботи завдання необхідно заповнити одне із цих полів відповідними даними. Наприклад, якщо потрібно ідентифікувати людину за ID в системі, потрібно прописати змінну ${ContactId}. Поля можна залишити порожніми, якщо перед блоком “Перевірити поле контакту на відповідність параметру з події” стоїть блок “Отримати контакт”. У такому разі визначення контакту відбуватиметься за ідентифікатором, вказаним у його налаштуваннях.