Опис блоків (група “Дії”)

Група "Дії" складається з блоків:

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

Email

Блок відправляє один лист одному одержувачу.

Блок Email

Блок має шість параметрів:

  • Повідомлення — заповнення цього параметра є обов'язковим, інші заповнюються залежно від завдань. Необхідне повідомлення можна вибрати у два способи:

1) із випадаючого списку (найпростіший і найпоширеніший спосіб);

2) прописати ID-повідомлення (для цього у випадаючому списку виберіть системну змінну ${EmailMessageId} або натисніть на коліщатко і введіть в обидва поля назву параметра, що містить ID-повідомлення у вашій події, без ${}).

Способи вибору повідомлення

  • Email контакту – вкажіть email-адресу контакту або параметр із події, що містить email-адресу. За замовчуванням прописана змінна ${EmailAddress}; якщо у вашій події цей параметр називається інакше, замініть його своєю назвою.
  • ID контакту – замість email можна вказати ID контакту в системі. Для цього натисніть коліщатко і введіть в обидва поля назву параметра, що містить ID контакту. Для багатьох системних подій цей параметр має назву ContactId. Зверніть увагу, що в цих полях параметр записується без ${}.
  • 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\"}]}"
}

Для сумісного використання поля JSON із блоком “Отримати контакт” знадобиться звернення до даних із цього поля через проміжний об'єкт jsonParam на прикладі масиву items, поле name першого елемента стане доступним за допомогою такої конструкції:

$!data.get('jsonParam').get('array').get(0).get('name')

Якщо блок “Отримати контакт” не використовується, конструкція набуває такого вигляду:

$!data.get('array').get(0).get('name')
  • Мова повідомлення — у поле вставляється ідентифікатор мови або параметр із події, що містить його. Він потрібний для створення мультимовних повідомлень. Залиште поле порожнім, якщо не використовуєте мультимовність або для контактів уже призначено мову в їхніх картках.

Приклад параметра з події:

Приклад параметра з події:

Ідентифікатор мови можна записати одним зі способів:

  • ru, uk, en
  • RU, UK, EN
  • ru-RU, uk-UA, en-US

  Мова повідомлення

  • Відправляти тільки вдень — щоб додати цю умову, активуйте перемикач.

Відправляти тільки вдень

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

Установка денного часу для організації

На самому блоці є підказка, увімкнене у вас це налаштування чи ні. Позначка "24/7" (1) свідчить, що повідомлення може бути відправлене в будь-який час доби. Якщо ввімкнений денний час, на блоці буде присутня іконка годинника (2).

Позначка активності

SMS

Завдання блоку — відправити SMS-повідомлення користувачеві. Він використовується для відправлення одиночних повідомлень і працює аналогічно блоку Email, але замість листа надсилає SMS.

Блок SMS

Цей блок має п'ять параметрів:

  • Повідомлення — виберіть зі списку заздалегідь створене в системі SMS-повідомлення (обов'язкове поле). Способи вибору такі самі, як для Email.
  • Телефон — номер телефону одержувача або параметр із події, що містить його. Автоматично до параметру підставляється змінна ${PhoneNumber}. У вашій події вона може називатися ${SMS}, ${PhoneNumber}, ${Phone}. Перевірте й запишіть точну назву для коректної роботи блоку. Знайти її можна в події, що запускає сценарій. Для цього зайдіть у Тригери → Історія подій та відкрийте потрібну подію.
  • ID контакту — замість номера телефону можна використовувати ID контакту, аналогічно блоку Email.

ID контакту

  • 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\"}]}"
}

Для сумісного використання поля JSON із блоком “Отримати контакт” знадобиться звернення до даних із цього поля через проміжний об'єкт jsonParam на прикладі масиву items, поле name першого елемента стане доступним за допомогою такої конструкції:

$!data.get('jsonParam').get('array').get(0).get('name')

 Якщо блок “Отримати контакт” не використовується, конструкція набуває такого вигляду:

$!data.get('array').get(0).get('name')
  • Відправляти тільки вдень — принцип роботи такий самий, як і в блоці Email.

Viber

Завдання — відправити Viber-повідомлення користувачеві. Блок використовується для відправлення одиночних повідомлень (один раз одному контакту).

Блок Viber

Обов'язковими для заповнення параметрами в налаштуваннях є "Повідомлення" і "Телефон", інші заповнюються залежно від завдань.

Повідомлення — виберіть Viber-повідомлення, яке буде відправлене, із заздалегідь створених у редакторі.

Телефон — у цьому полі прописується змінна, що містить номер телефону. Так само, як у блоці SMS, у параметр автоматично підставляється змінна ${PhoneNumber}. У вашій події вона може називатися ${SMS}, ${PhoneNumber}, ${Phone}. Перевірте й запишіть точну назву для коректної роботи блоку. Знайти її можна в події, що запускає сценарій. Для цього зайдіть у Тригери → Історія подій та відкрийте необхідну подію.

Конкретний номер телефону прописується цифрами, наприклад 8 063 222 33 55, тільки для тестування.

Параметр подіїї

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

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

Картка контакту

Важливо!

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

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

JSON — у це поле можна вставити дані в форматі JSON для підстановки в повідомлення або вказати параметр із події, що містить такі дані. Не вводьте нічого, якщо не передаєте в події параметр із JSON-рядком.

Для сумісного використання поля JSON із блоком “Отримати контакт” знадобиться звернення до даних із цього поля через проміжний об'єкт jsonParam на прикладі масиву items, поле name першого елемента стане доступним за допомогою такої конструкції:

$!data.get('jsonParam').get('array').get(0).get('name')

 Якщо блок “Отримати контакт” не використовується, конструкція набуває такого вигляду:

$!data.get('array').get(0).get('name')

Приклад такого рядка:

{
"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\"}]}"
} 

Відправляти тільки вдень — щоб зробити налаштування активним, пересуньте перемикач. Принципи роботи налаштування детально описані в блоці Email.

Web push

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

Блок Web Push

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

  • Повідомлення — виберіть зі списку заздалегідь створене push-повідомлення.
  • Token — токен підписника. За замовчуванням у полі прописано змінну ${pushToken}.
  • Телефон — номер телефону підписника. Стандартно в полі прописано змінну ${PhoneNumber}.
  • Email контакту — email-адреса підписника. За замовчуванням в полі прописано змінну ${EmailAddress}.
  • Термін активності — час, протягом якого система намагатиметься доставити push-повідомлення підписнику. У випадаючому списку виберіть один із варіантів: 6 годин/12 годин/1 день/5 днів/10 днів.
  • ID контакту — ID контакту в системі. Стандартно в полі прописано змінну ${PushContactId}.
  • JSON — у це поле можна вставити дані у форматі JSON для підстановки в повідомлення або вказати параметр із події, що містить такі дані. Не вводьте нічого, якщо не передаєте в події параметр із JSON-рядком.

Для сумісного використання поля JSON із блоком “Отримати контакт” знадобиться звернення до даних із цього поля через проміжний об'єкт jsonParam на прикладі масиву items, поле name першого елемента стане доступним за допомогою такої конструкції:

$!data.get('jsonParam').get('array').get(0).get('name')

 Якщо блок “Отримати контакт” не використовується, конструкція набуває такого вигляду:

$!data.get('array').get(0).get('name')

Так само як у вищеописаних блоках, можна налаштувати відправлення повідомлень тільки вдень.

Важливо!

Щоб відправити push-повідомлення, системі необхідно знати токен підписника. Якщо дані в картці контакту об'єднані (email+телефон+ID+token), його можна знайти, вказавши інші параметри для відправлення, не обов'язково ${pushToken}. Система по черзі шукатиме, чи вказані у контакту email, телефон або ID токен

Mob push

Для відправлення мобільних пушів у вас має бути власний мобільний додаток, який треба підключити до eSputnik. Блок відправляє push-повідомлення на мобільний пристрій користувача за умови, що той попередньо погодився (підписався) на їхнє отримання.

Блок Mob Push

Параметри блоку:

  • Повідомлення — виберіть зі списку необхідне push-повідомлення.
  • Token — мобільний токен підписника, за замовчуванням у полі прописано змінну ${MobPushToken}.
  • Термін активності — час, протягом якого система намагатиметься доставити push-повідомлення підписнику. Залежно від терміну проведення акції ви можете вибрати час активності push: 6 годин/12 годин/1 день/5 днів/10 днів.
  • ID контакту — ID контакту в системі. За замовчуванням у полі прописано змінну $ {ContactId}.
  • JSON — у це поле можна вставити дані у форматі JSON для підстановки в повідомлення або вказати параметр із події, що містить такі дані. Не вводьте нічого, якщо не передаєте до події параметр із JSON-рядком.

Для сумісного використання поля JSON із блоком “Отримати контакт” знадобиться звернення до даних із цього поля через проміжний об'єкт jsonParam на прикладі масиву items, поле name першого елемента стане доступним за допомогою такої конструкції:

$!data.get('jsonParam').get('array').get(0).get('name')

 Якщо блок “Отримати контакт” не використовується, конструкція набуває такого вигляду:

$!data.get('array').get(0).get('name')

Так само як у попередніх блоках, можна налаштувати відправлення повідомлень тільки вдень.

Важливо!

Щоб відправити mob push, системі необхідно знати токен підписника. Якщо дані в картці контакту об'єднані (email+телефон+ID+token), його можна знайти, вказавши інші параметри для відправлення, не обов'язково ${pushToken}. Система по черзі шукатиме, чи вказані у контакту email, телефон або ID токен.

Email групи

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

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

Важливо!

Блок не годиться для тригерів. Якщо в події передається email-адреса контакту, треба використовувати звичайний блок Email.

Блок "Email групі" застосовується тільки для подій, в яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).

Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", в якому необхідно вибрати групу, вам все одно потрібний одиночний блок Email. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи й передає email та ID контакту під час кожного запуску.

Блок Email групі

Блок має два обов'язкових параметри: "Повідомлення" і "Група", а також опцію відправлення вдень.

  • Повідомлення — виберіть email, який треба надіслати групі.
  • Група — вкажіть групу, якій треба відправити повідомлення. Можна вибирати з випадаючого списку або прописати ID групи (для цього у випадаючому списку виберіть системну змінну ${GroupId} або натисніть коліщатко і введіть в обидва поля назву параметра, що містить ID групи у вашій події, без ${}).

Важливо!

Кожна наша група має свій ідентифікатор. Наприклад, якщо відправити подію та передати в ній у полі GroupId  певний ідентифікатор
{
"name":"GroupId", "value":167039898
}

то замість GroupId до сценарію буде підставлено 167039898 і відправлення відбудеться за цією групою.

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

SMS групи

Завдання блоку — відправити SMS певній групі абонентів.

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

Важливо!

Блок не годиться для тригерів. Якщо в події передається номер телефону контакту або ID контакту, треба використовувати одиночний блок SMS.

Блок "SMS групі" застосовується тільки для подій, у яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).

Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", у якому вибирається група, вам все одно треба використовувати одиночний блок SMS. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи і передає email та ID контакту під час кожного запуску.

Блок SMS групі

Блок має два обов'язкових параметри:

  • Повідомлення — виберіть SMS, яке треба надіслати групі.
  • Група — вкажіть групу, якій треба відправити повідомлення. Можна вибрати із випадаючого списку або прописати ID групи (для цього у випадаючому списку виберіть системну змінну ${GroupId} або натисніть коліщатко і введіть в обидва поля назву параметра, що містить ID групи у вашій події, без ${}).

Додатково можна налаштувати відправлення SMS удень; для цього активуйте перемикач під основними параметрами.

Viber групи

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

Важливо!

Блок не годиться для тригерів. Якщо в події передається номер телефону контакту або ID контакту, треба використовувати одиночний блок Viber.

Блок "Viber групі" застосовується тільки для подій, у яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).

Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", в якому вибирається група, вам все одно треба використовувати одиночний блок Viber. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи і передає email та ID контакту під час кожного запуску.

Блок Viber групі

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

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

Web Push групи

Завдання блоку — відправити веб-пуш-повідомлення певній групі абонентів.

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

Важливо!

Блок не годиться для тригерів. Якщо в події передається токен або ID контакту, треба використовувати одиночний блок Web Push.

Блок "Web Push групі" застосовується тільки для подій, у яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).

Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", в якому вибирається група, вам все одно треба використовувати одиночний блок Web Push. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи і передає email та ID контакту під час кожного запуску.

Web Push групі

Так само як у попередньому блоці, треба вказати повідомлення та групу для його відправлення. Вибрати їх можна з випадаючого списку або прописати ID (натиснути коліщатко й заповнити дані). У полі "Сайт" за замовчуванням вказано адресу сайту, на якому збираються токени. Якщо у вас кілька сайтів — виберіть потрібний зі списку.

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

Mob push групи

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

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

Важливо!

Блок не годиться для тригерів.

Блок "Mob Push групі" застосовується тільки для подій, у яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).

Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", у якому вибирається група, вам все одно треба використовувати одиночний блок Mob Push. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи і передає email та ID контакту під час кожного запуску.

Блок Mob Push групі

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

Додати до групи

Завдання цього блоку — додати користувача до тієї чи іншої статичної групи (списку). Наприклад, після його певної дії в листі або на сайті.

Блок Додати до групи

  • Група — виберіть зі списку групу, до якої треба додати контакт.
  • Укажіть один зі способів ідентифікації контакту: за Email, ID контакту, Телефоном.

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

Важливо!

Додати користувача можна тільки до статичної групи (списку). До динамічної або складеної групи додати користувача не можна.

Видалити з групи

Завдання блоку — видалити користувача з певної статичної групи (списку). У системі контакт залишиться.

Працює аналогічно блоку "Додати до групи", тільки не додає контакт, а видаляє з групи.

Блок Видалити з групи

  • Група — виберіть зі списку групу, до якої треба додати контакт.
  • Укажіть один зі способів ідентифікації контакту: за Email, ID контакту, Телефоном.

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

Важливо!

Видалити користувача можна тільки зі статичної групи (списку). Із динамічної або складеної групи видалити користувача не можна.

Точка перевірки

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

Блок Точка перевірки

Назва — обов'язковий блок.

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

Розпилювач

Блок створює події для кожного учасника вибраної групи.

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

Принцип його роботи такий:

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

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

Блок Розпилювач

Розпилювач має два параметри:

  • Група — вкажіть групу зі списку, для якої ви бажаєте створити одиночні події. Можна вибрати з випадаючого списку або прописати ID групи (для цього у випадаючому списку виберіть системну змінну ${GroupId} або натисніть коліщатко і введіть в обидва поля назву параметра, що містить ID групи у вашій події, без  {}). Якщо поле не заповнено, за замовчуванням використовується параметр GroupId.
  • Подія — виберіть тип подій, які бажаєте створювати. Тип події треба заздалегідь створити в розділі "Тригери" → "Типи подій".
Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email