Група блоків Повідомлення | Support eSputnik

Дані користувача

Email

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

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

Відстеження подій та поведінки

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

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

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

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

  • Email

  • SMS

  • Viber

  • Web Push

  • Mobile Push

  • App Inbox

  • Telegram

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

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

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

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

Повідомлення

Після вибору повідомлення ви можете перейти до його попереднього перегляду або скопіювати його ID. Для цього натисніть на три крапки у параметрах блоку та виберіть потрібну опцію.

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

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

Пов'язані сценарії

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

Номер телефону

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

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

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

  • ID контакту – ідентифікатор контакту в системі. Вказати ID можна замість email або номеру телефона. Для багатьох системних подій цей параметр має назву “ContactId”.

ID контакту

  • JSON – сюди можна вставити дані у форматі 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, і відправити його.

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

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

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

Попередній перегляд

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

Важливо

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

Email

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

Email

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

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

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

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

Мова

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

  • ru, uk, en

  • RU, UK, EN

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

Формат мови

SMS

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

SMS

Viber

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

Viber

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

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

Номер телефону у картці контакту

Важливо

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

Web Push

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

Web Push

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

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

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

Важливо

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

Mobile Push

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

Важливо

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

Mobile Push

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

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

Важливо

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

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

Важливо

Під час пошуку контактів для блоків “Email”, “SMS”, “VIber”, “Mobile Push” та “Web Push” застосовуються такі правила: 

  • ID контакту має найвищий пріоритет серед усіх параметрів.
  • Вказані в полі блоку email контакту, номер телефону чи токен використовуються для відправлення.
  • Якщо задано externalCustomerId, виконується відправлення контакту, якому він належить; серед тих, що були знайдені за email-адресою, номером телефону чи токеном.
  • Якщо externalCustomerId не задано, виконується відправлення контакту, знайденому за email адресою, номером телефону чи токеном.
  • Якщо контакт не знайдено, для відправлення буде створено новий контакт.

App Inbox

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

Важливо

Щоб надсилати клієнтам App Inbox, спочатку необхідно одержати токен аутентифікації та налаштувати App Inbox для веб-сайтів або мобільних застосунків

App Inboxм

Telegram

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

Важливо

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

Telegram

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

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

Важливо

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

  • Telegram bot — ідентифікатор боту для акаунтів з більш ніж одним ботом. Ви можете вибрати бот для надсилання повідомлень зі списку або вказати динамічний параметр ${appId}. Система отримує ідентифікатор боту з події, яка ініціювала сценарій.
Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email