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

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

Email

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

У блока есть 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.

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

• Сообщение – выберите из списка заранее созданное в системе 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/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-сообщение, которое будет отправлено, из предварительно созданных в редакторе.

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

Конкретный номер телефона цифрами, например 8 063 222 33 55, прописывается только для тестирования.

ID контакта – при отсутствии номера телефона в передаваемом событии можно сделать идентификацию клиента по его ID в системе. В данном случае переменная будет записана как ${ContactId}.

Если контакт в системе существует и у него заполнено поле “Телефон”, то сообщение контакту отправится. Если контакта в системе нет, то сценарий проигнорирует блок 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-уведомление подписчикам данного канала. После подписки система будет искать контакт среди существующих. Если удастся его определить, в карточку этого контакта добавится пуш-токен. Если нет, то автоматически создастся новый только с токеном.

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

• Сообщение – выберите из списка заранее созданное 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')

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

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

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

Email группе

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

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

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

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

{

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

}

SMS группе

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

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

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

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

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

Viber группе

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

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

Как и в предыдущем блоке, нужно указать сообщение и группу для его отправки. Выбрать их можно из выпадающего списка или прописать ID (нажать на шестеренку и заполнить данные).

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

Web Push группе

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

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

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

Чтобы пуши отправлялись только днем, сделайте активным переключатель под основными параметрами.

Mob push группе

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

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

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

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

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

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

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

Блок "Добавить в группу" создает контакт, если он не найден. Если сценарий содержит переменную externalCustomerId и ее значение не равно email или номеру телефона, то этот exId будет у созданного контакта.

Webhook

Задача данного блока – выполнить запрос на указанный URL (используйте только протокол https). Доступные типы запросов GET и POST. Формат данных JSON, XML, text.
Актуально использовать, когда нужно обратиться к источнику данных по ссылке, чтобы вернуть промокод или токен авторизации, а далее отобразить эти данные в сообщении в рамках сценария. С помощью этого блока вы также можете отдать на указанный адрес:

• параметры из события, которое запустило сценарий,
• поля и дополнительные поля контакта, на который сработал сценарий.

Для корректной настройки блока в одно из полей впишите название соответствующей переменной из события, по которой идентифицируется контакт. 

В таблице ниже приведен пример выражений, которые следует использовать в этих полях:

, где вместо parameter - должно быть вписано название параметра, содержащего значение ID контакта, телефона или емейла в таком виде, в каком вы передаете его в событии. Вписывайте его без пробелов и с сохранением регистра.

Читайте подробную инструкцию о настройке, тестировании и управлении вебхуками в сценариях.

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

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

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

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

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

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

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

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

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

Распылитель

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

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

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

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

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

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

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

Обновление дополнительных полей

Блок «Обновление дополнительных полей» обновляет статические данные в указанных полях. Вы также можете использовать динамические значения, но основная цель блока – упростить изменение определенного поля.

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

В блок входят следующие параметры:

• ID контакта. Идентификатор контакта в системе.
• Email контакта. Адрес электронной почты контакта.
• Телефон контакта. Номер телефона контакта.
• Обновление контакта. Указанные поля для обновления.

Чтобы настроить блок “Обновление дополнительных полей”:
1. В своем сценарии выберите блок "Обновление специальных полей". Справа откроется меню «Настройки» блока.
2. В разделе “Поиск контактов” введите значения в следующие поля:

• ID контакта
• Email контакта
• Телефон контакта

3. Чтобы добавить поля, которые необходимо обновить, в разделе “Обновление контакта” нажмите “+ Добавить поле”. 

4. В раскрывающемся меню “Обновление контакта”, разверните выпадающий список “Добавить поле” и выберите поле, которое необходимо обновить.

5. В строке “Значение” введите значение поля.

6. Чтобы добавить другие поля, повторите действия в пунктах 4 и 5.
7. Нажмите “Готово”.

После того как вы нажмете "Готово", система выполнит валидацию добавленных полей и их значений. Если валидация не будет пройдена, отобразится сообщение об ошибке.

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