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

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

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

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

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

• Повідомлення – обов'язковий параметр. 

Для його вибору:

1. Натисніть кнопку “Вибрати повідомлення” праворуч на панелі налаштувань.

2. Оберіть повідомлення зі списку (за замовчуванням вибране останнє створене) або вкажіть динамічну змінну ${emailMessageId} за допомогою кнопки поруч з рядком пошуку.

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

Також можна відсортувати повідомлення за датою оновлення. 

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

У вікні вибору повідомлення доступні такі дії:

• Створення копії повідомлення.

• Попередній перегляд повідомлення.

3. Натисніть кнопку “Вибрати”.

Після того я ви обрали повідомлення у налаштуваннях блоку, за кліком на іконку три крапки, ви можете:

• Переглянути повідомлення.

• Замінити повідомлення.

• Редагувати повідомлення в новій вкладці.

• Копіювати 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. Іконка блоку з годинником свідчить, що повідомлення буде відправлене тільки в дозволений час 

Одне з багатьох

Завдання блоку — вибрати з кількох повідомлень з певними мітками те, яке з великою ймовірністю матиме найкращий CTR, і відправити його.

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

• Надсилати через — вибір медіаканалу (можна вибрати будь-який).
• Застосунок — назва мобільного застосунку або Telegram-бота (опція вибору застосунку відсутня, якщо в обліковому записі зареєстровано лише один додаток або бот, – відповідний параметр буде застосовано автоматично).
• Додати варіанти з мітками — вибір міток, які повинне мати повідомлення. Цифра біля міток позначає наявну кількість повідомлень з цими мітками.
• Виключити варіанти з мітками — вибір міток, яких не повинне мати повідомлення.
• Відправляти тільки в дозволений час.

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

Докладніше про блок >

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 одному одержувачу.

Telegram

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

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

• Token — Telegram-токен підписника, за замовчуванням у полі прописано змінну ${telegramBotToken}.

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