Описание блоков (группа "Действия")

Группа ”Действия” состоит из блоков:

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

Email

Блок отправляет 1 письмо 1 получателю.

Блок Email

У блока есть 6 параметров:

  • Сообщение – заполнение этого параметра является обязательным, остальные заполняются в зависимости от задач. Нужное сообщение можно выбрать 2 способами:

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/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').

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

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

Параметр события с указанием языка сообщения

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

  • 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

У данного блока есть 5 параметров:

  • Сообщение – выберите из списка заранее созданное в системе SMS-сообщение (обязательное поле). Способы выбора такие же, как и для Email.
  • Телефон – номер телефона получателя или параметр из события, содержащий его. Автоматически в параметр подставляется переменная ${PhoneNumber}.
    В вашем событии она может называться ${SMS}, ${PhoneNumber}, ${Phone}. Проверьте и запишите точное название для корректной работы блока. Посмотреть его можно в событии, которое запускает сценарий. Для этого зайдите в Триггеры → История событий, откройте нужное событие.
  • ID контакта – вместо номера телефона можно использовать ID контакта, аналогично блоку Email.

ID контакта

  • 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').

  • Отправлять только днем – принцип работы такой же, как и в блоке Email.

Viber

Задача – отправить 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/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\"}]}"

}


 

Отправлять только днем – чтобы сделать настройку активной, передвиньте переключатель. Принципы работы настройки детально описаны в блоке Email.

Web push

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

Блок Web Push

У блока следующие параметры:

  • Сообщение – выберите из списка заранее созданное push-сообщение.
  • Token – токен подписчика. По умолчанию в поле прописана переменная ${pushToken}.
  • Телефон – номер телефона подписчика. Стандартно в поле прописана переменная ${PhoneNumber}.
  • Email контакта – email-адрес подписчика. По умолчанию в поле прописана переменная ${EmailAddress}.
  • Время активности – время, в течение которого система будет пытаться доставить push-сообщение подписчику. В выпадающем списке выберите один из вариантов: 6 часов/12 часов/1 день/5 дней/10 дней.
  • 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').

Как и в предыдущих блоках, можно настроить отправку уведомлений только днем.

Важно!

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

Mob push

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

Блок Mob Push

Параметры блока:

  • Сообщение – выберите из списка нужное push-сообщение.
  • Token – мобильный токен подписчика, по умолчанию в поле прописана переменная ${MobPushToken}.
  • Время активности – время, в течение которого система будет пытаться доставить push-сообщение подписчику. В зависимости от срока проведения акции вы можете выбрать время активности push: 6 часов/12 часов/1 день/5 дней/10 дней.
  • ID контакта – ID контакта в системе. По умолчанию в поле прописана переменная ${ContactId}.
  • JSON – в это поле можно вставить данные в формате JSON для подстановки в сообщение либо указать параметр из события, содержащий такие данные. Не вводите ничего, если не передаете в событии параметр с JSON-строкой. 

Совместное использование поля JSON с блоком получить контакт, потребует обращения к данным из этого поля через промежуточный объект jsonParam, на примере массива items, поле name первого элемента будет доступно при помощи такой конструкции: $!data.get('jsonParam').get('array').get(0).get('name'). Если же блок получить контакт не используется, конструкция примет вид: $!data.get('array').get(0).get('name').

Как и в предыдущих блоках можно настроить отправку уведомлений только днем. 

Важно!

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

Email группе

Отправляет письмо группе контактов – делает массовую рассылку. В этом блоке выбирается не один получатель, а группа. Используется в сценариях после импорта контактов, а также если нужно запустить небольшую цепочку. Например, отправить группе, а потом тем, кто не прочитал или не перешел, повторно отправить это или другое письмо.

Как правило, в сценарии используются либо только блоки отправки сообщений группе, либо только блоки одиночных сообщений.

Важно!

Блок не подходит для триггеров. Если в событии передается email-адрес контакта, то надо использовать обычный блок Email.

Блок “Email группе” используется только для событий, где передается ID группы или в самом сценарии выбрана конкретная группа (можно использовать условную).

Даже если вы используете условие запуска сценария “Регулярный”, в котором выбирается группа, вам все равно нужно использовать одиночный блок Email. Дело в том, что это условие запуска не передает в сценарий ID группы. Вместо этого оно запускает сценарий отдельно для каждого участника группы и при каждом запуске передает email и ID контакта.

Блок Email группе

У блока два обязательных параметра: “Сообщение” и “Группа”, а также опция отправки в дневное время.

  • Сообщение – выберите email, который нужно отправить группе.
  • Группа – укажите группу, которой нужно отправить сообщение. Можно выбирать из выпадающего списка или прописать ID группы (для этого в выпадающем списке выберите системную переменную ${GroupId} или нажмите на шестеренку и в оба поля введите название параметра, содержащего ID группы в вашем событии, без ${}).

Важно!

Каждая наша группа имеет свои идентификатор. Например, если отправить событие и в нем в поле GroupId передать некоторый идентификатор

{

"name":"GroupId", "value":167039898

}

то вместо GroupId в сценарии подставится 167039898, и отправка произойдет на эту группу.  

Это удобно, когда вы знаете, что скрывается за идентификатором. Таким способом можно управлять рассылкой, указывая, что и какому сегменту нужно отправить.

SMS группе

Задача блока – отправить SMS определенной группе контактов.

Как правило, в сценарии используются либо только блоки отправки сообщений группе, либо только блоки одиночных сообщений.

Важно!

Блок не подходит для триггеров. Если в событии передается номер телефона контакта или ID контакта, то надо использовать одиночный блок SMS.

Блок “SMS группе” используется только для событий, где передается ID группы или в самом сценарии выбрана конкретная группа (можно использовать условную).

Даже если вы используете условие запуска сценария “Регулярный”, в котором выбирается группа, вам все равно нужно использовать одиночный блок SMS. Дело в том, что это условие запуска не передает в сценарий ID группы. Вместо этого оно запускает сценарий отдельно для каждого участника группы и при каждом запуске передает email и ID контакта.

Блок SMS группе

У блока есть 2 обязательных параметра:

  • Сообщение – выберите SMS, которое нужно отправить группе.
  • Группа – укажите группу, которой нужно отправить сообщение. Можно выбрать из выпадающего списка или прописать ID группы (для этого в выпадающем списке выберите системную переменную ${GroupId} или нажмите на шестеренку и в оба поля введите название параметра, содержащего ID группы в вашем событии, без ${}).

Дополнительно можно настроить отправку SMS днем, активировав переключатель под основными параметрами.

Viber группе

Задача блока – отправить Viber-сообщение определенной группе контактов.

Как правило, в сценарии используются либо только блоки отправки сообщений группе, либо только блоки одиночных сообщений.

Важно!

Блок не подходит для триггеров. Если в событии передается номер телефона контакта или ID контакта, то надо использовать одиночный блок Viber.

Блок “Viber группе” используется только для событий, где передается ID группы или в самом сценарии выбрана конкретная группа (можно использовать условную).

Даже если вы используете условие запуска сценария “Регулярный”, в котором выбирается группа, вам все равно нужно использовать одиночный блок Viber. Дело в том, что это условие запуска не передает в сценарий ID группы. Вместо этого оно запускает сценарий отдельно для каждого участника группы и при каждом запуске передает email и ID контакта.

Блок Viber группе

Как и в предыдущем блоке, нужно указать сообщение и группу для его отправки. Выбрать их можно из выпадающего списка или прописать 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 контакта.

Блок Mob Push группе

Настройки аналогичны остальным блокам: укажите, какое push-уведомление будете отправлять, в поле “Сообщение”, и для какой группы – в поле “Группы”. Если время отправки пуша для подписчика не важно, то оставьте переключатель как есть, неактивным. Если нужно отправлять уведомления днем, то включите соответствующую опцию.

Добавить в группу

Задача данного блока – добавить пользователя в определенную статическую группу (список). Например, после того как он совершил определенное действие в письме или на сайте.

Блок Добавить в группу

  • Группа – выберите из списка группу, в которую нужно добавить контакт.
  • Укажите один из способов идентификации контакта: по Email, ID контакта, Телефону.

По умолчанию контакт идентифицируется по email. В этом поле уже прописано название переменной, которая содержит электронный адрес подписчика. Вы меняете ее, только если создаете свою переменную, в которой он передается.

Важно!

Добавить пользователя можно только в статическую группу (список). В динамическую или составную группу добавить пользователя нельзя.

Удалить из группы

Задача блока – удалить пользователя из определенной статической группы (списка). В системе контакт останется.

Работает аналогично блоку “Добавить в группу”, только не добавляет контакт, а удаляет из группы.

Блок Удалить из группы

  • Группа – выберите из списка группу, в которую нужно добавить контакт.
  • Укажите один из способов идентификации контакта: по Email, ID контакта, Телефону.

По умолчанию контакт идентифицируется по email. В этом поле уже прописано название переменной, которая содержит электронный адрес подписчика. Вы меняете ее, только если создаете свою переменную, в которой он передается.

Важно!

Удалить пользователя можно только из статической группы (списка). Из динамической или составной группы удалить пользователя нельзя.

Точка проверки

Блок не выполняет никаких действий, кроме того, что фиксирует в логе работы сценария срабатывание самого себя. Если у вас сложный сценарий с разветвлениями, то вы можете поставить в любом месте этот блок и затем в логе посмотреть, проходил ли сценарий по определенному пути. Также точка проверки подходит для того, чтобы свести несколько веток в одну точку. Не все блоки позволяют подключить к себе несколько веток, и данный блок решает этот вопрос.

Блок Точка проверки

Название – обязательный блок. 

В истории запуска сценария по названию точки проверки можно узнать, прошел сценарий эту точку или нет. Это помогает в отладке сценария.

Распылитель

Блок создает события для каждого участника выбранной группы.

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

Принцип его работы следующий:

  • запустился сценарий для групп (в событии передан ID группы или она выбрана в настройках распылителя);
  • сценарий доходит до блока “Распылитель”;
  • создается отдельное событие для каждого контакта (переход от групп к одиночным);
  • и теперь это событие запустит сценарий для одиночного контакта.

В созданных блоком событиях содержится email-адрес и ID контакта. Это и позволяет запускать этими событиями другой сценарий и использовать в нем блоки отправки одиночных сообщений.

Блок Распылитель

У распылителя есть 2 параметра:

  • Группа – укажите группу из списка, для которой вы хотите создать одиночные события. Можно выбрать из выпадающего списка или прописать ID группы (для этого в выпадающем списке выберите системную переменную ${GroupId} или нажмите на шестеренку и в оба поля введите название параметра, содержащего ID группы в вашем событии, без ${}). Если поле не заполнено, по умолчанию используется параметр GroupId.
  • Событие – выберите тип событий, которые вы хотите создавать. Тип события нужно предварительно создать в разделе “Триггеры” → “Типы событий”.
Остались вопросы?
Специалисты обязательно ответят и помогут решить вашу проблему!
Обратный звонок
Оставьте заявку – и наш специалист свяжется с вами в рабочее время.
Отправить заявку
Консультация в чате
Готовы к вашим вопросам!
Написать в чат
Электронная почта
Напишите в службу поддержки eSputnik.
Отправить email