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

Группа Условия состоит из блоков:

Email

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



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

  • Сообщение - выбираете из вписка заранее созданное в eSputnik письмо
  • Email контакта - указываете email-адрес контакта или параметр из события, содержащий email-адрес.
  • Контакт - вместо email можно указать id контакта в системе. Обычно не используется
  • JSON - в это можно вставить данные для подстановки в письмо в формате JSON. Либо указывается параметр из события, содержащий такие данные. Не вводите ничего в это поле если не передаете в событии параметр со строкой в формате JSON.
  • Язык сообщения - в поле вставляется идентификатор языка или параметр из события, содержащий его. Используется для мультиязычности в триггерных сообщениях. Не вводите в это ничего если не используете мультиязычность.

Обязательным является параметр Сообщение. Остальные параметры заполняются в зависимости от задач.

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


SMS

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



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

  • Сообщение - выбираете из списка заранее созданное в системе SMS-сообщение
  • Номер телефона контакта - номер телефона получателя или параметр из события, содержащий его
  • Контакт - вместо номера телефона можно использовать id контакта. Для этого надо нажать шестеренку и в оба поля ввести название параметра, содержащего id контакта. Для многих системных событий этот параметр называется ContactId. Заметьте, что в этих полях параметр записывается без ${}
  • JSON - в это можно вставить данные для подстановки в сообщение в формате JSON. Либо указывается параметр из события, содержащий такие данные. Не вводите ничего в это поле если не передаете в событии параметр со строкой в формате JSON.

Push

Блок отправляет Push-уведомление пользователю. Чтобы пользователь получил Push - он должен предварительно подписаться на получение push-уведомлений.

Блок работает аналогично блоку Email, но вместо письма отправляет Push-уведомление.



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

  • Сообщение - надо выбрать из списка заранее созданное push-сообщение
  • Token - токен подписчика
  • SMS - номер телефона подписчика
  • Email - email-адрес подписчика
  • Время активности Push - время в течение которого система будет пытаться доставить push-сообщение подписчику
  • Контакт - id контакта в системе

Важный момент! Push-сообщения отправляются с помощью токена (Token). То есть для отправки системе надо "знать" токен подписчика. Но если в системе токен привязан к контакту, то система может найти токен по другим каналам контакта (Email, SMS, id). В этом поле вы можете заполнить те поля для поска токена, которые у вас есть. Вы можете заполнить несколько полей. Система будет искать по ним по очереди.

Email группе

Отправляет письмо на группу контактов. То есть делает массовую рассылку. В этом блоке выбирается не один получатель, а группа.

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

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

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



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

  • Сообщение - выбираем сообщение, которое нужно отправить группе
  • Группа - выбираем группу, которой нужно отправить сообщение. Выбирать можно из выпадающего списка или прописать id группы (нажимаем на шестеренку и прописываем id группы). Если поле оставить пустым - по умолчанию будет использоваться параметр GroupId.

SMS группе

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

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

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

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




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

  • Сообщение - выбираем сообщение, которое нужно отправить группе
  • Группа - выбираем группу, которой нужно отправить сообщение. Выбирать можно из выпадающего списка или прописать id группы (нажимаем на шестеренку и прописываем id группы).  Если поле оставить пустым - по умолчанию будет использоваться параметр GroupId.

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

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


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

  • Группа - выбираем из списка группу, в которую надо добавить контакт
  • Email контакта
  • ID контакта

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

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

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

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

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



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

  • Группа - выбираем из списка группу, из которой надо удалить контакт
  • Email контакта
  • ID контакта

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

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

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

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



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

  • Название - Он обязательный. Название точки проверки. Помогает понять о какой точке проверки идет речь и проанализировать собранную информацию.

Распылитель

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



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

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

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

  • Группа - выбираем из списка группу для которой мы хотим создать одиночные события. Выбирать можно из выпадающего списка или прописать id группы (для этого нажимаем на шестеренку и прописываем id группы). Если поле не заполнено - по умолчанию используется параметр GroupId
  • Событие - выбираем тип события, которые мы хотим создавать. Тип события надо предварительно создать в разделе Триггеры - Типы событий

Предыдущие части

Часть 1. Описание блоков (группа Общие)

Часть 3. Описание блоков (группа Условия)