Група блоків “Повідомлення”

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

До групи входить шість блоків:

• Email

• SMS

• Viber

• Web Push

• Mobile Push

• App Inbox

Загальні параметри блоків

Кожен блок містить такі параметри:

• Повідомлення – обов'язковий параметр. З випадаючого списку можна вибрати необхідне повідомлення або вказати динамічну змінну ${emailMessageId}.

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

• Номер телефону (для блоків “SMS”,“Viber”,“Web Push”) — номер телефону одержувача або параметр із події, що містить його. Обов'язковий параметр. Автоматично до параметра підставляється змінна ${phoneNumber}. У вашій події вона може називатися ${SMS}, ${PhoneNumber}, ${Phone}. Перевірте й запишіть точну назву для коректної роботи блоку. Знайти її можна в події, що запускає сценарій. 

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

Номер телефону вказується цифрами, наприклад, 12018627991.

• ID контакту – ідентифікатор контакту в системі. Вказати ID можна замість email або номеру телефона. Для багатьох системних подій цей параметр має назву “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')

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

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

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

Більш детальну інформацію дивіться тут. 

Відповідні позначки на блоці показують, чи включений цей параметр для певного повідомлення:

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

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

Email

Блок відправляє одне email-повідомлення одному одержувачу.

Крім загальних, блок “Email” має ще такі параметри:

• Email – вкажіть email-адресу контакту або параметр із події, що містить email-адресу. За замовчуванням прописана змінна ${emailAddress}; якщо у вашій події цей параметр називається інакше, замініть його своєю назвою.

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

Приклад параметра мови:

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

• ru, uk, en

• RU, UK, EN

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

SMS

Завдання блоку  — відправити одне SMS-повідомлення одному одержувачу.

Viber

Завдання блоку  — відправити одне Viber-повідомлення одному одержувачу.

Крім загальних, блок “Viber” має параметр “Термін активності повідомлення” (TTL) – період, після якого повідомлення не буде показано, якщо до цього воно не було доставлено користувачеві.

Viber-повідомлення відправиться лише контакту с заповненим полем “Номер телефону” у його картці. Якщо поле порожнє – сценарій проігнорує блок “Viber” і не надішле контакту повідомлення.

Web Push

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

Крім загальних, блок “Web Push” має такі параметри:

• Токен –  токен підписника. За замовчуванням у полі прописано змінну ${pushToken}.

• Email – вкажіть email-адресу контакту або параметр із події, що містить email-адресу. За замовчуванням прописана змінна ${emailAddress}; якщо у вашій події цей параметр називається інакше, замініть його своєю назвою.

Mobile Push

Завдання блоку  — відправити одне Mobile Push-повідомлення одному одержувачу.

Крім загальних, блок “Mobile Push” має такі параметри:

• Token — мобільний токен підписника, за замовчуванням у полі прописано змінну ${mobPushToken}.

• Застосунок — ідентифікатор застосунку для акаунтів з більш ніж одним застосунком. Ви можете вибрати застосунок для надсилання повідомлень зі списку або вказати динамічний параметр ${appId}. Система отримує ідентифікатор застосунку з події, яка ініціювала сценарій. Під час надсилання подій через SDK цей параметр передається автоматично.

App Inbox

Завдання блоку  — відправити один App Inbox одному одержувачу.