Група блоків "Дії"

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

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

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

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

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

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

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

Viber

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

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

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

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

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

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

Якщо контакт у системі існує і в нього заповнене поле "Телефон", то повідомлення буде відправлено контакту. Якщо контакту в системі немає, сценарій проігнорує блок 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-повідомлення підписникам даного каналу. Після підписки система шукатиме контакт серед існуючих. Якщо вдасться його визначити, до картки цього контакту буде додано пуш-токен. Якщо ні, автоматично створюється новий тільки з токеном.

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

• Повідомлення — виберіть зі списку заздалегідь створене push-повідомлення.
• Token — токен підписника. За замовчуванням у полі прописано змінну ${pushToken}.
• Телефон — номер телефону підписника. Стандартно в полі прописано змінну ${PhoneNumber}.
• Email контакту — email-адреса підписника. За замовчуванням в полі прописано змінну ${EmailAddress}.
• 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')

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

Mob push

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

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

• Повідомлення — виберіть зі списку необхідне push-повідомлення.
• Token — мобільний токен підписника, за замовчуванням у полі прописано змінну ${MobPushToken}.
• ID контакту — ID контакту в системі. За замовчуванням у полі прописано змінну $ {ContactId}.
• Застосунок: ідентифікатор застосунка для акаунтів з більш ніж одним застосунком. Ви можете вибрати застосунок для надсилання повідомлень зі списку або вказати динамічний параметр ${AppId}. Система отримує ідентифікатор застосунка з події, яка ініціювала сценарій. Під час надсилання подій через SDK цей параметр передається автоматично.
• JSON — у це поле можна вставити дані у форматі JSON для підстановки в повідомлення або вказати параметр із події, що містить такі дані. Не вводьте нічого, якщо не передаєте до події параметр із JSON-рядком.

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

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

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

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

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

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

Email групі

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

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

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

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

SMS групі

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

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

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

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

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

Viber групі

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

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

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

Web Push групі

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

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

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

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

Mob push групі

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

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

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

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

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

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

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

Блок "Додати до групи" створює контакт, якщо не знайшов його. Якщо сценарій містить змінну externalCustomerId і її значення не дорівнює email чи номеру телефону, то цей exId буде у створеного контакта.

Webhook

Задача цього блоку – виконати запит на вказаний URL (використовуйте тільки протокол https). Доступні типи запитів GET та POST. Формат даних JSON, XML, text.

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

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

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

, де замість parameter - має бути вказана назва параметру, що містить значення ID контакту, телефону або емейла в такому вигляді, в якому ви передає його в події. Вписуйте його без пробілів та зі збереженням регістру.

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

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

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

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

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

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

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

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

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

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

Розпилювач

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

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

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

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

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

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

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

Оновлення додаткових полів

Блок “Оновлення додаткових полів” оновлює статичні дані в тих полях, які ви вказуєте. Ви також можете використовувати динамічні значення, але основна мета блоку — спростити внесення змін до певного поля.

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

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

• ID контакту. Ідентифікатор контакту в системі.
• Email контакту. Адреса електронної пошти контакту.
• Телефон контакту. Номер телефону контакту.
• Оновлення контакту. Вказані поля для оновлення.

Щоб налаштувати блок “Оновлення додаткових полів”:
1. У своєму сценарії виберіть блок “Оновити додаткові поля”. Праворуч відкриється меню «Налаштування» блоку.
2. У розділі “Пошук контактів” введіть значення в наступні поля:

• ID контакту
• Email контакту
• Телефон контакту

3. Щоб додати поля, які потрібно оновити, у розділі “Оновлення контакту” натисніть “+ Додати поле”. 

4. У розкривному меню “Оновлення контакту” розгорніть випадний список “Додати поле” та виберіть поле, яке потрібно оновити.

5. У рядку “Значення” введіть значення поля.

6. Щоб додати інші поля, повторіть кроки 4 та 5.

7. Натисніть “Готово”.

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

Якщо вам потрібно відредагувати додані поля, натисніть кнопку «Редагувати поля» в розділі «Оновлення контакту», після чого відредагуйте поля або значення в розкривному меню.