Группа блоков “Сообщения” | Support eSputnik

Пользовательские данные

Email

Омниканальность

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

Отслеживание событий и поведения

Группа блоков “Сообщения”

Блоки отправляют одно сообщение одному получателю.

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

  • Email

  • SMS

  • Viber

  • Web Push

  • Mobile Push

  • App Inbox

  • Telegram

Группа блоков “Сообщение”

Общие параметры блоков

Каждый блок имеет такие параметры:

  • Сообщение — обязательный параметр. Из выпадающего списка можно выбрать необходимое сообщение или указать динамическую переменную  ${emailMessageId}.

Сообщение

После выбора сообщения вы можете перейти к его предварительному просмотру или скопировать его ID. Для этого нажмите на три точки в параметрах блока и выберите нужное действие.

Предварительный просмотр сообщения

В списке сообщений отображаются связанные с ними сценарии. Чтобы открыть предварительный просмотр сценария, наведите курсор на название сценария и нажмите соответствующую иконку.

Связанные сценарии

  • Номер телефона (для блоков “SMS”,“Viber”,“Web Push”) — номер телефона получателя или параметр из события, содержащий его. Автоматически в параметр подставляется переменная ${phoneNumber}.

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

В вашем событии она может называться ${SMS}, ${PhoneNumber}, ${Phone}. Проверьте и запишите точное название для корректной работы блока. 

Посмотреть переменную можно в событии, которое запускает сценарий. Для этого зайдите в “Триггеры” → “История событий”, откройте нужное событие.

Параметры события

  • Contact ID – идентификатор контакта в системе. Указать ID можно вместо email или номера телефона. Для многих системных событий этот параметр называется “ContactId”.

Contact ID

  • JSON – сюда можно вставить данные в формате JSON для подстановки в сообщение либо указать параметр из события, содержащий такие данные. Не вводите ничего в это поле, если не передаете в событии параметр с JSON-строкой. 

JSON

Пример такой строки:

{

"name": "items",

"value": "{\"array\":[{\"name\":\"Сухая детская молочная смесь HiPP Combiotic 2, 750 г\",\"price\":\"341.00\",\"url\":\"https://site.com/catalog/suhaya-detskaya-molochnaya-smes-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/molochnaya-organicheskaya-ovsyanaya-kasha-s-yablokom-hipp-spokojnoj-nochi-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-адрес контакта или параметр из события, содержащий email-адрес. По умолчанию прописана переменная ${emailAddress}, если в вашем событии этот параметр называется по другому, замените на свое название.

  • Язык – язык сообщения. В поле вставляется идентификатор языка или параметр из события, содержащий его. Нужен для создания мультиязычных сообщений. Оставьте поле пустым, если не используете мультиязычность или контактам уже присвоен язык в их карточках.

Пример параметра языка:

Язык

Идентификатор языка можно записать в таких форматах:

  • ru, uk, en

  • RU, UK, EN

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

Формат языка

SMS

Задача блока — отправить одно SMS-сообщение одному получателю

SMS

Viber

Задача блока — отправить одно Viber-сообщение одному получателю.

Viber

Кроме общих, у блока “Viber” есть параметр “Время активности сообщения” () — период, после которого сообщение не будет показано, если до этого оно не было доставлено пользователю. 

Viber-сообщение отправится только контакту с заполненным полем “Номер телефона” в его карточке. Если поле пустое – сценарий проигнорирует блок  “Viber” и не отправит сообщение контакту. 

Номер телефона в карточке контакта

Важно

Для контакта не запустится сценарий, где Viber – один из множества блоков, если в качестве переменной указан номер телефона, а в событии и в системе у контакта его нет.

Web Push

Задача блока — отправить одно Web Push-сообщение одному получателю. После подписки система будет искать контакт среди существующих. Если удастся его определить, в карточку этого контакта добавится push-токен. Если нет, то автоматически создастся новый только с токеном. 

Web Push

Кроме общих, блок  “Web Push” содержит такие параметры:

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

  • Email – email-адрес подписчика. По умолчанию в поле прописана переменная ${emailAddress}.

Важно

Для отправки системе необходимо знать токен подписчика. Если в карточке контакта данные объединены (токен+номер телефона+ email+contact ID), то его можно найти, указав для отправки другие параметры, не обязательно ${pushToken}. Система будет искать по очереди, есть ли у контакта с указанным email, телефоном или ID токен.

Mobile Push

Задача блока — отправить одно Mobile Push-сообщение одному получателю.

Важно

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

Web Push

Кроме общих, блок  “Mobile Push” содержит такие параметры:

  • Токен – токен подписчика. По умолчанию в поле прописана переменная ${mobPushToken}.

Важно

Для отправки системе необходимо знать токен подписчика. Если в карточке контакта данные объединены (токен+номер телефона+email+contact ID), то токен можно найти, указав для отправки другие параметры, не обязательно ${mobPushToken}. Система будет искать по очереди, есть ли у контакта с указанным email, телефоном или ID токен.

  • Приложение – идентификатор приложения для аккаунтов с более чем одним приложением. Вы можете выбрать приложение для отправки уведомлений из выпадающего списка или указать динамический параметр ${appId}. Система извлекает идентификатор приложения из события, которое инициировало сценарий. При отправке событий через SDK этот параметр передается автоматически.

Важно

При поиске контактов для блоков “Email”, “SMS“, “Viber“, Web push”, “Mobile 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