Перші кроки
Дані користувача
- Огляд адаптивного email-редактора
- Cтворення оформлення для листа
- Створення синхронізованих модулів
- Налаштування адаптивності
- Налаштування Smart-елементів
- Оформлення промовкладки для Gmail
- Додавання Rolloverʼа
- Додавання фону до листа
- Додавання анкорних посилань
- Бібліотека блоків (Модулі)
- Додавання таблиці до листа
- Додавання кастомних шрифтів
- Додавання кастомних іконок соцмереж
- Створення кнопки СТA
- Робота з блоком "Зображення"
Омніканальність
- SDK для мобільних застосунків
- Керування ключами доступу до мобільного SDK
- Підключення мобільного застосунку
- Створення Google проекту для Mob Push
- Створення мобільних push-повідомлень
- Налаштування аналітики доставлень та кліків
- Планування мобільних push-повідомлень
- Налаштування універсальних посилань (deeplinks & Universal links)
- Надсилання тестових повідомлень із налагодження запитів
- Налаштування віджетів для сайту
- Виклик віджета
- Збереження даних із віджетів у поля контактів
- Захист від роздратування
- Дії після заповнення форми
- Розширення для тестування форм в Google Chrome
- Створення pop-up-форм за допомогою Google Tag Manager або WordPress
- Надсилання подій з віджетів eSputnik до Google Analytics
- Заміна системного сценарію Double Opt-In
- Налаштування геоданих для правил виклику віджетів
Автоматизація
- Подвійне підтвердження підписки
- Вітальна серія
- Вітальна серія із сегментацією за категоріями
- Запуск сценарію після імпорту контактів
- Регулярний сценарій для групи
- Вітання з днем народження
- Привʼязка сценарію до кнопки
- Реактивація клієнтів та підписників
- Відправка розсилки непрочитавшим
- Налаштування додаткових розсилок
Персоналізація
- Підстановка промокоду з файлу
- Підстановка промокоду з використанням API
- Принципи генерації промокодів за допомогою PHP/JAVA
- Підстановка промокоду за допомогою персоналізації
- Завантаження промокодів для використання в сценарії
- Генерація промокодів у сценарії
- Відправлення промокоду за допомогою передпроцесора
- HTTP-запит для передачі промокоду з повідомлення до картки контакту
Аналітика
- Звіт щодо email-розсилки
- Звіт щодо SMS-розсилки
- Звіт щодо розсилки Web Push
- Звіт щодо Viber-розсилки
- Звіт щодо розсилки Mob Push
- Звіт щодо розсилки App Inbox
- Звіт зі взаємодії з віджетами
- Звіт щодо тригерної розсилки
- Звіт щодо AMP-розсилки
- Звіт щодо мультимовної розсилки
- Налаштування передачі UTM-міток
- Візуалізація доходу
- Відстеження ефективності розсилок у Google Analytics
Мультимовність
Відстеження подій та поведінки
- Розгалуження сценарію в залежності від параметрів події
- Відстеження активності на сайті за допомогою Generate event
- Валідація параметрів подій
- Відстеження активності клієнтів у мобільних застосунках
- Підстановка даних з подій в повідомлення
- Події для запуску тригерних розсилок
- Вебхуки для відстеження активності
Товарні рекомендації
API
- Інтеграція з API — найчастіші питання
- API-ключі
- Ресурси API для додавання контактів
- Використання API-ресурсу Generate event
- Передача замовлень API-ресурсом Generate event
- Отримання рекомендацій щодо API ресурсом Contact recommendations based on web tracking
- Використання API-ресурсу Send prepared message
Зміна системи
Документи
Інтеграція
Група блоків "Дії"
Блоки групи "Дії" допомагають налаштувати дію в сценарії, яку система повинна виконати в певний момент або на одному з етапів роботи з контактом.
Блок відправляє один лист одному одержувачу.
Блок має шість параметрів:
- Повідомлення — заповнення цього параметра є обов'язковим, інші заповнюються залежно від завдань. Необхідне повідомлення можна вибрати у два способи:
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 і не надішле контакту повідомлення.
Важливо!
Сценарій, у якому 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')
Так само як у вищеописаних блоках, можна налаштувати відправлення повідомлень тільки вдень.
Важливо!
Щоб відправити push-повідомлення, системі необхідно знати токен підписника. Якщо дані в картці контакту об'єднані (email+телефон+ID+token), його можна знайти, вказавши інші параметри для відправлення, не обов'язково ${pushToken}. Система по черзі шукатиме, чи вказані у контакту email, телефон або ID токен
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')
Так само як у попередніх блоках, можна налаштувати відправлення повідомлень тільки вдень.
Важливо!
Щоб відправити mob push, системі необхідно знати токен підписника. Якщо дані в картці контакту об'єднані (email+телефон+ID+token), його можна знайти, вказавши інші параметри для відправлення, не обов'язково ${pushToken}. Система по черзі шукатиме, чи вказані у контакту email, телефон або ID токен.
Щоб побачити правила пошуку контактів, наведіть курсор до знаку питання на панелі налаштувань:
Важливо
Під час пошуку контактів для блоків “Email”, “SMS”, “VIber”, “Mob Push” та “Web Push” застосовуються такі правила:
- ID контакту має найвищий пріоритет серед усіх параметрів.
- Вказані в полі блоку email контакту, номер телефону чи токен використовуються для відправлення.
- Якщо задано externalCustomerId, виконується відправлення контакту, якому він належить; серед тих, що були знайдені за email адресою, номером телефону чи токеном.
- Якщо externalCustomerId не задано, виконується відправлення контакту, знайденому за email адресою, номером телефону чи токеном.
- Якщо контакт не знайдено, для відправлення буде створено новий контакт.
Email групі
Відправляє лист групі контактів, тобто здійснює масову розсилку. У цьому блоці вибирається не один одержувач, а група. Використовується в сценаріях після імпорту контактів, а також якщо треба запустити невеликий ланцюжок. Наприклад, зробити відправлення групі, а потім повторно надіслати цього або іншого листа тим, хто не прочитав або не перейшов за посиланням.
У сценарії зазвичай використовуються або тільки блоки відправлення повідомлень групі, або тільки блоки одиночних повідомлень.
Важливо!
Блок не годиться для тригерів. Якщо в події передається email-адреса контакту, треба використовувати звичайний блок Email.
Блок "Email групі" застосовується тільки для подій, в яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).
Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", в якому необхідно вибрати групу, вам все одно потрібний одиночний блок Email. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи й передає email та ID контакту під час кожного запуску.
Блок має два обов'язкових параметри: "Повідомлення" і "Група", а також опцію відправлення вдень.
- Повідомлення — виберіть email, який треба надіслати групі.
- Група — вкажіть групу, якій треба відправити повідомлення. Можна вибирати з випадаючого списку або прописати ID групи (для цього у випадаючому списку виберіть системну змінну ${GroupId} або натисніть коліщатко і введіть в обидва поля назву параметра, що містить ID групи у вашій події, без ${}).
Важливо!
Кожна наша група має свій ідентифікатор. Наприклад, якщо відправити подію та передати в ній у полі GroupId певний ідентифікатор
{
"name":"GroupId", "value":167039898
}
то замість GroupId до сценарію буде підставлено 167039898 і відправлення відбудеться за цією групою.
Це зручно, якщо ви знаєте, що приховано за ідентифікатором. У такий спосіб можна управляти розсилкою, вказуючи, що слід відправити і якому сегменту.
SMS групі
Завдання блоку — відправити SMS певній групі абонентів.
У сценарії зазвичай використовуються або тільки блоки відправлення повідомлень групі, або тільки блоки одиночних повідомлень.
Важливо!
Блок не годиться для тригерів. Якщо в події передається номер телефону контакту або ID контакту, треба використовувати одиночний блок SMS.
Блок "SMS групі" застосовується тільки для подій, у яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).
Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", у якому вибирається група, вам все одно треба використовувати одиночний блок SMS. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи і передає email та ID контакту під час кожного запуску.
Блок має два обов'язкових параметри:
- Повідомлення — виберіть SMS, яке треба надіслати групі.
- Група — вкажіть групу, якій треба відправити повідомлення. Можна вибрати із випадаючого списку або прописати ID групи (для цього у випадаючому списку виберіть системну змінну ${GroupId} або натисніть коліщатко і введіть в обидва поля назву параметра, що містить ID групи у вашій події, без ${}).
Додатково можна налаштувати відправлення SMS удень; для цього активуйте перемикач під основними параметрами.
Viber групі
Завдання блоку — відправити Viber-повідомлення певній групі абонентів. У сценарії зазвичай використовуються або тільки блоки відправлення повідомлень групі, або тільки блоки одиночних повідомлень.
Важливо!
Блок не годиться для тригерів. Якщо в події передається номер телефону контакту або ID контакту, треба використовувати одиночний блок Viber.
Блок "Viber групі" застосовується тільки для подій, у яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).
Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", в якому вибирається група, вам все одно треба використовувати одиночний блок Viber. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи і передає email та ID контакту під час кожного запуску.
Так само як у попередньому блоці, треба вказати повідомлення та групу для його відправлення. Вибрати їх можна з випадаючого списку або прописати ID (натиснути коліщатко й заповнити дані).
Щоб повідомлення відправлялися тільки вдень, активуйте перемикач під основними параметрами.
Web Push групі
Завдання блоку — відправити веб-пуш-повідомлення певній групі абонентів.
У сценарії зазвичай використовуються або тільки блоки відправлення повідомлень групі, або тільки блоки одиночних повідомлень.
Важливо!
Блок не годиться для тригерів. Якщо в події передається токен або ID контакту, треба використовувати одиночний блок Web Push.
Блок "Web Push групі" застосовується тільки для подій, у яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).
Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", в якому вибирається група, вам все одно треба використовувати одиночний блок Web Push. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи і передає email та ID контакту під час кожного запуску.
Так само як у попередньому блоці, треба вказати повідомлення та групу для його відправлення. Вибрати їх можна з випадаючого списку або прописати ID (натиснути коліщатко й заповнити дані). У полі "Сайт" за замовчуванням вказано адресу сайту, на якому збираються токени. Якщо у вас кілька сайтів — виберіть потрібний зі списку.
Щоб пуші відправлялися тільки вдень, активуйте перемикач під основними параметрами.
Mob push групі
Завдання блоку — відправити мобільний пуш групі абонентів.
У сценарії зазвичай використовуються або тільки блоки відправлення повідомлень групі, або тільки блоки одиночних повідомлень.
Важливо!
Блок не годиться для тригерів.
Блок "Mob Push групі" застосовується тільки для подій, у яких передається ID групи або в самому сценарії вибрано конкретну групу (можна використовувати умовну).
Навіть якщо ви застосовуєте умову запуску сценарію "Регулярний", у якому вибирається група, вам все одно треба використовувати одиночний блок Mob Push. Річ у тім, що ця умова запуску не передає до сценарію ID групи. Натомість вона запускає сценарій окремо для кожного учасника групи і передає email та ID контакту під час кожного запуску.
Налаштування аналогічні іншим блокам: в полі "Повідомлення" вкажіть, яке push-повідомлення надсилатимете, а в полі "Групи" — якій групі. Якщо підписнику байдуже, о котрій годині надсилати пуш, залиште перемикач неактивним. Якщо треба відправляти повідомлення вдень, увімкніть відповідну опцію.
Додати до групи
Завдання цього блоку — додати користувача до тієї чи іншої статичної групи (списку). Наприклад, після його певної дії в листі або на сайті.
- Група — виберіть зі списку групу, до якої треба додати контакт.
- Укажіть один зі способів ідентифікації контакту: за Email, ID контакту, Телефоном.
За замовчуванням контакт ідентифікується за email. У цьому полі вже прописано назву змінної, що містить електронну адресу підписника. Ви змінюєте її, тільки якщо створюєте власну змінну, в якій вона передається.
Блок "Додати до групи" створює контакт, якщо не знайшов його. Якщо сценарій містить змінну externalCustomerId і її значення не дорівнює email чи номеру телефону, то цей exId буде у створеного контакта.
Важливо!
Додати користувача можна тільки до статичної групи (списку). До динамічної або складеної групи додати користувача не можна.
Webhook
Задача цього блоку – виконати запит на вказаний URL (використовуйте тільки протокол https). Доступні типи запитів GET та POST. Формат даних JSON, XML, text.
Актуально використовувати, коли потрібно звернутися до джерела даних за посиланням, щоб повернути промокод або токен авторизації, а потім відобразити ці дані у повідомленні в рамках сценарію. За допомогою цього блоку ви також можете віддати на вказану адресу:
- параметри з події, яка запустила сценарій,
- поля та додаткові поля контакту, на який спрацював сценарій.
Для коректного налаштування блоку в одне з полів впишіть назву відповідної змінної з події за якою ідентифікується контакт.
У таблиці нижче наведено приклад виразів, які слід використовувати у цих полях:
Спосіб запуску / Поле в сценарії | ID контакту | Телефон | Email контакту |
За подією | ${parameter} | ${parameter} | ${parameter} |
На умовну групу | ${ContactId} | ${PhoneNumber} | ${EmailAddress} |
За зміною поля | ${ContactId} | ${PhoneNumber} | ${EmailAddress} |
, де замість parameter - має бути вказана назва параметру, що містить значення ID контакту, телефону або емейла в такому вигляді, в якому ви передає його в події. Вписуйте його без пробілів та зі збереженням регістру.
Важливо!
Блок Webhook використовується тільки в комбінації з блоком відправки одиночного повідомлення для будь-якого каналу, а також з блоком "Змінна відповідає регулярному виразу". Для сценаріїв із надсиланням повідомлення групі блок Webhook не застосовується.
Читайте детальніше в інструкції про налаштування, тестування та керування вебхуками в сценаріях.
Видалити з групи
Завдання блоку — видалити користувача з певної статичної групи (списку). У системі контакт залишиться.
Працює аналогічно блоку "Додати до групи", тільки не додає контакт, а видаляє з групи.
- Група — виберіть зі списку групу, до якої треба додати контакт.
- Укажіть один зі способів ідентифікації контакту: за Email, ID контакту, Телефоном.
Важливо!
Видалити користувача можна тільки зі статичної групи (списку). Із динамічної або складеної групи видалити користувача не можна.
За замовчуванням контакт ідентифікується за email. У цьому полі вже прописано назву змінної, що містить електронну адресу підписника. Ви змінюєте її, тільки якщо створюєте власну змінну, в якій вона передається.
Важливо
Під час пошуку контактів для блоків “Додати до групи” та “Видалити з групи” застосовуються такі правила:
- ID контакту має найвищий пріоритет серед усїх параметрів.
- Якщо задано externalCustomerId, пошук контакту буде виконуватись по externalCustomerId.
- Якщо externalCustomerId не задано, пошук контакту буде виконуватись по email адресі або по номеру телефону.
Точка перевірки
Блок не виконує жодних дій, окрім того, що фіксує в логу роботи сценарію спрацьовування самого себе. Якщо у вас складний сценарій із розгалуженнями, ви можете поставити цей блок у будь-якому місці й потім подивитися в логу, чи перебігав сценарій визначеним шляхом. Також точка перевірки придатна для зведення кількох гілок в одну точку. Не всі блоки дозволяють підключити до себе кілька гілок, і даний блок вирішує це питання.
Назва — обов'язковий блок.
В історії запуску сценарію за назвою точки перевірки можна дізнатися, пройшов сценарій певну точку чи ні. Це допомагає із налагодженням сценарію.
Розпилювач
Блок створює події для кожного учасника вибраної групи.
Якщо сценарій призначений для групи, ми не можемо використовувати в ньому блоки, призначені для одиночних контактів. Але "Розпилювач" надає таку можливість.
Принцип його роботи такий:
- запустився сценарій для груп (у події передано ID групи або її вибрано в налаштуваннях розпилювача);
- сценарій доходить до блоку "Розпилювач";
- створюється окрема подія для кожного контакту (перехід від груп до одиночних);
- і тепер ця подія запустить сценарій для одиночного контакту.
Створені блоком події містять email-адресу та ID контакту. Власне це й дозволяє запускати цими подіями інший сценарій та використовувати в ньому блоки відправлення одиночних повідомлень.
Розпилювач має два параметри:
- Група — вкажіть групу зі списку, для якої ви бажаєте створити одиночні події. Можна вибрати з випадаючого списку або прописати ID групи (для цього у випадаючому списку виберіть системну змінну ${GroupId} або натисніть коліщатко і введіть в обидва поля назву параметра, що містить ID групи у вашій події, без {}). Якщо поле не заповнено, за замовчуванням використовується параметр GroupId.
- Подія — виберіть тип подій, які бажаєте створювати. Тип події треба заздалегідь створити в розділі "Тригери" → "Типи подій".
Оновлення додаткових полів
Блок “Оновлення додаткових полів” оновлює статичні дані в тих полях, які ви вказуєте. Ви також можете використовувати динамічні значення, але основна мета блоку — спростити внесення змін до певного поля.
Необхідність оновлення додаткових полів контакту може виникнути як результат виконання попереднього блоку. Коли блок активується в сценарії, він шукає контакт у системі та оновлює вказані поля.
Зверніть увагу
В першу чергу, пошук виконується за ID контакту, якщо його не вказано то за externalCustomerId, якщо він є в параметрах події.
Блок містить наступні параметри:
- ID контакту. Ідентифікатор контакту в системі.
- Email контакту. Адреса електронної пошти контакту.
- Телефон контакту. Номер телефону контакту.
- Оновлення контакту. Вказані поля для оновлення.
Щоб налаштувати блок “Оновлення додаткових полів”:
1. У своєму сценарії виберіть блок “Оновити додаткові поля”. Праворуч відкриється меню «Налаштування» блоку.
2. У розділі “Пошук контактів” введіть значення в наступні поля:
- ID контакту
- Email контакту
- Телефон контакту
3. Щоб додати поля, які потрібно оновити, у розділі “Оновлення контакту” натисніть “+ Додати поле”.
4. У розкривному меню “Оновлення контакту” розгорніть випадний список “Додати поле” та виберіть поле, яке потрібно оновити.
Зверніть увагу
Додаткові поля згруповані у створених вами списках.
5. У рядку “Значення” введіть значення поля.
6. Щоб додати інші поля, повторіть кроки 4 та 5.
7. Натисніть “Готово”.
Після того як ви натиснете «Готово», система виконає валідацію доданих полів та їхніх значень. Якщо валідацію не буде пройдено, буде відображено повідомлення про помилку.
Якщо вам потрібно відредагувати додані поля, натисніть кнопку «Редагувати поля» в розділі «Оновлення контакту», після чого відредагуйте поля або значення в розкривному меню.