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

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

Email

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

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

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

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

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

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

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

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

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

  • Сообщение — обязательный параметр. 

Для его выбора:

  1. Нажмите кнопку “Выбрать сообщение” справа на панели настроек.

Выбрать сообщение

  1. Выберите сообщение из списка (по умолчанию выбирается последнее созданное) или укажите динамическую переменную ${emailMessageId} с помощью кнопки возле строки поиска.

Список сообщений

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

Также можно отсортировать сообщения по дате их обновления.

Поиск сообщений

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

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

В окне выбора сообщения доступны такие действия:

  • Создание копии сообщения.

  • Предпросмотр

Копирование и предпросмотр сообщения

  1. Нажмите кнопку  “Выбрать”.

Нажмите кнопку “Выбрать”

После того как вы выбрали сообщение в настройках блока, по клику на иконку три точки, вы можете:

  • Просмотреть сообщение

  • Заменить сообщение

  • Редактировать сообщение в новой вкладке.

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

Одно из многих

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

Одно из многих

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

  • Отправлять через — выбор медиаканала (можно выбрать любой).
  • Приложение – название мобильного приложения или Telegram-бота (опция выбора приложения отсутствует, если в аккаунте зарегистрировано только одно приложение или один бот – соответствующий параметр будет применен автоматически).
  • Добавить варианты с метками – выбор меток, которые должны иметь сообщения. Цифра возле меток обозначает количество сообщений с этими метками.
  • Исключить варианты с метками – выбор меток, которые не должны иметь сообщения.
  • Отправлять только в разрешенное время.

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

Предпросмотр

Подробнее о блоке >

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