Опис блоків (група Загальні) | Підтримка eSputnik

Email

Омніканальність

Автоматизація

Опис блоків (група "Загальні")

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

Блоки "Загальні"

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

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

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

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

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

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

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

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

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

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

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

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

Ключ унікальності в історії подій

Важливо!

Ключ події (email, ID контакту та ін.) має збігатися в події, яка запустила сценарій, і події, яка має завершити сценарій.

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

Завершити сценарій, якщо контакт входить в групу

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

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

  • email;

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

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

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

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

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

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

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

Таймер у сценарії

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

Welcome-серія з таймером

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

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

  • Чекати до

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

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

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

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

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

Важливо!

Якщо ви вибираєте зачекати 1/2/3 дні, це означає, що сценарій продовжиться відповідно через 24/48/72 години з моменту спрацьовування сценарію. Якщо клієнт підписався на вашу розсилку о 07:00, то першого листа він отримає о 07:00 наступного дня.

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

Чекати до

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

Важливо!

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

Налаштування часу надсилання працюють за такою ж логікою. Якщо ви виставили час відправки на 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;

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

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

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

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

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

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

Вибір завдання для блоку

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

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

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

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

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

Блок для підтвердження контакту

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

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

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

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

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

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

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

Важливо!

Блок потрібний тільки для специфічних завдань, коли дані передаються за API методом /v1/event і лише частину даних треба записати при створенні контакту. Наприклад, ви передали подію методом v1/event для контакту, якого немає в системі. За допомогою цього блоку ви матимете змогу створити контакт. Для всіх інших методів цей блок не потрібний.

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

  • 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-адреси контакту (підтверджено/не підтверджено).

Важливо!

Якщо ви бажаєте створити контакт непідтвердженим, до тіла запиту треба додати параметр "confirmed":false.

У цьому випадку поле 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 методом /v1/event, або якщо в сценарії треба задавати фіксоване значення додаткового поля.

 Завдання "Оновити контакт"

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

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

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

Обов'язковий email

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

Важливо!

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

Блок має чотири параметри:

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

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

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

  • JSON — довільні дані в форматі 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}.

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

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

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

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

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

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

Вибір назви завдання

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

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

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

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

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

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

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

Завдання "Запустити подію"

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

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

Параметр eventTypeId

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

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

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

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

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

Блок "Створити промокод"

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

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

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

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

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

Важливо!

Усі параметри є обов'язковими для заповнення.

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

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

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

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

Завдання "Отримати промокод"

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

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

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

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

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

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

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

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

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

Завдання "Отримати контакт"

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

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 додаткового поля.

Блок "Умова"

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

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

Блок "Умова" має 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}. Поля можна залишити порожніми, якщо перед блоком “Перевірити поле контакту на відповідність параметру з події” стоїть блок “Отримати контакт”. У такому разі визначення контакту відбуватиметься за ідентифікатором, вказаним у його налаштуваннях.

Протестуйте на реальних розсилках

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email