Группа блоков “Популярные”

Популярные – чаще всего используемые блоки.

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

• Конец

• Таймер

• Задача

• Условие

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

Блок “Конец”

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

Блок “Таймер”

Более подробная информация >

Блок “Задача”

Назначение этого блока — решить одну из задач:

• Создать контакт;

• Обновить контакт;

• Получить контакт;

• Подтвердить контакт;

• Отправить обязательный (транзакционный) email;

• Отправить транзакционное Viber сообщение;

• Отправить транзакционное SMS сообщение;

• Получить заказ;

• Создать промокод;

• Получить промокод;

• Запустить событие.

Выбрать нужную задачу можно из выпадающего списка в меню справа.

Создать контакт

Задача используется для создания контакта в системе. Если профиль с таким email-адресом уже есть, он будет обновлен. Если нет, будет создан новый контакт.

У задачи есть три параметра:

• Email – обязательное поле для задачи, если нужно создать контакт по email. 

• Номер телефона – обязательное поле для задачи, если нужно создать контакт по номеру телефона.

• JSON – в этом поле прописывается строка или ставится переменная, содержащая строку в формате JSON, с данными для заполнения полей контакта (телефон, имя, фамилия, город, дополнительные поля). Если его не прописать, то запишется лишь email. При необходимости зафиксировать имя, фамилию, дату рождения и т.д., поле нужно заполнить обязательно. 

В поле JSON вы можете указать переменную contactJson. В таком случае на REST API будет выполнена валидация значений этого параметра. При передаче параметров контакта с ошибками, в сообщении об ошибке будут указаны параметры, содержащие ошибку, а также допустимые значения.

Пример данных для поля json:

{"firstname":"...","lastname":"...","sms":"...","town":"...","profileInputs":

[{"profileInputId":10001,"value":"..."}]}

Где: 

• profileInputs – массив дополнительных полей;

• profileInputId – ID дополнительного поля;

• value – значение дополнительного поля;

• confirmed – статус email-адреса контакта (подтвержден/не подтвержден).

В этом случае поле json будет иметь такую структуру:

{"firstname":"...","lastname":"...","sms":"...","town":"...","profileInputs":

[{"profileInputId":10001,"value":"..."}],"confirmed":false}

Если нужно создать контакт с некоторым значением поля типа дата со временем, тогда используйте формат вида: "YYYY-MM-DDThh:mm":

{"profileInputs": [{"profileInputId":10001,"value":"2023/11/06"}]}

Если нужно создать контакт с некоторым значением поля типа дата со временем, тогда используйте формат вида: "YYYY-MM-DDThh:mm":

{"profileInputs": [{"profileInputId":10001,"value":"2023/11/06 16:42"}]}

Обновить контакт

Задача используется для обновления информации о контакте в системе, работает по принципу задачи “Создать контакт”. Единственная разница: если контакт уже есть в системе, то он обновится, а если нет – система его не продублирует, а просто пропустит.

Задача актуальна, когда нужно обновить данные контакта из события, переданного API методом Generate event v2, или если надо в сценарии задавать фиксированное значение дополнительного поля.

У задачи есть четыре параметра:

• Contact ID – если вы хотите обновить контакт не по email, а по его ID в системе, то необходимо прописать название переменной, в которой содержится ID контакта. По умолчанию в системе она называется ${contactId}.

• Email – обязательное поле для задачи. Например, ${emailAddress} или  test@test.com. Если у вас в событии другое название переменной, необходимо вписать в поле именно это название. В наших системных событиях переменная называется EmailAddress. Системные события – это те, что генерируются внутри самой системы (клик по кнопке в письме, запуск регулярного сценария на группу, форма подписки, реактивация с помощью RFM-анализа). Для них в поле надо вписать ${EmailAddress}.

• Номер телефона – номер телефона контакта.

• JSON – в этом поле прописывается строка или ставится переменная, содержащая строку в формате JSON, с данными для заполнения полей контакта (телефон, имя, фамилия, город, дополнительные поля). Формат данных такой же, как и для задачи “Создать контакт”, но параметр confirmed игнорируется.

Получить контакт

Цель задачи – получить данные о контакте и передать их в письмо или для блока “Условие”. Например, мы хотим каждый раз запускать отправку письма-уведомления с контактными данными, когда в базе появляется новый подписчик. Второй вариант – мы хотим после регистрации прислать клиенту его регистрационные данные.

Задача работает следующим образом:

1. В системе создается (регистрируется) событие, которое содержит данные о контакте;

2. Блок вытягивает все имеющиеся данные по контакту, которые хранятся в базе;

3. Полученные данные передаются в письмо.

У задачи четыре параметра:

• Contact ID – ID контакта в системе eSputnik.

• Email – email-адрес контакта.

• Номер телефона – номер телефона контакта.

• Токен – мобильный токен контакта.

Параметры “Contact ID”, “Email”, “Номер телефона”, “Токен” используются для выбора способа идентификации контакта. Одно из этих полей должно быть обязательно заполнено соответствующими данными.

Например, если вы хотите идентифицировать человека не по email, а по его ID в системе, прописываете название переменной, в которой содержится ID контакта. По умолчанию в системе она называется ${contactId}.

В письме можно использовать такие переменные:

• $!data.get('firstName') – имя;

• $!data.get('lastName') – фамилия;

• $!data.get('email') – email-адрес;

• $!data.get('sms') – номер телефона;

• $!data.get('contactKey') – ключ контакта;

• $!data.get('id') – ID контакта в системе;

• $!data.get('createdDate') – дата создания;

• $!data.get('updatedDate') – дата последнего изменения контакта;

• $!data.get('confirmed') – статус email-адреса контакта (true – подтвержден, false – не подтвержден);

• $!data.get('fields').get('12345') – дополнительные поля. Вместо “12345” нужно подставить ID дополнительного поля.

Вы можете активировать флажок “Искать только ID контакта” для поиска контакта только по его ID.

Подтвердить контакт

Цель задачи – подтвердить email-адрес подписчика и сделать его активным в системе, чтобы ему приходили письма.

Например: когда человек заполняет форму подписки, контакт попадает в eSputnik с неподтвержденным email и ему на почту приходит уведомление с просьбой подтвердить подписку. Пока он не перейдет по ссылке подтверждения, контакт не будет получать рассылки. Когда человек подтверждает подписку, запускается сценарий, срабатывает задача “Подтвердить контакт” и он становится в системе активным.

У задачи есть расширенные параметры. 

Подробнее о расширенных параметрах блоков сценариев >

Отправить обязательный (транзакционный) email

Цель задачи – отправить письмо контакту, несмотря на его статус в системе. То есть вы сможете отправить письмо на любой email (подтвержденный, неподтвержденный, отписавшийся, с пометкой “жаловался на спам”), кроме контактов из черного списка.

Задача имеет один базовый (обязательный для настройки) параметр — "Сообщение". В этом поле выберите заранее созданное сообщение, которое будет отправлено пользователю. Также задача имеет расширенные параметры.

Подробнее о расширенных параметрах блоков сценариев >

Отправить транзакционное Viber сообщение

Цель задачи – отправить Viber сообщение контакту, несмотря на его статус в системе.

У задачи два базовых параметра:

• Сообщение.

• Время активности сообщения (TTL) –  установите период, после которого сообщение не будет показано, если оно не было доставлено пользователю. По умолчанию установлен 1 день. Минимальное значение — 2 минуты, максимальное — 28 дней.

Помимо базовых, задача содержит расширенные параметры.

Подробнее о расширенных параметрах блоков сценариев >

Отправить транзакционное SMS сообщение

Цель задачи – отправить SMS сообщение контакту, несмотря на его статус в системе.

Задача имеет один базовый (обязательный для настройки) параметр — "Сообщение", а также расширенные параметры.

Подробнее о расширенных параметрах блоков сценариев >

Получить заказ

Задача обеспечивает извлечение данных из заказа и передачу этих данных в письмо. Например,  статус заказа. 

Задача применяется только в сценариях, в которых события передаются API методом Add orders.

Чтобы настроить параметр задачи “Получить заказ”, разверните список “Получить заказ по” и выберите один из вариантов:

• ID заказа. Выбирайте этот вариант когда хотите получить данные заказа по ID, сформированному нашей системой.

• Внешний ID заказа. Выбирайте этот вариант когда хотите получить данные заказа по ID, который вы передаете в нашу систему.

Не обязательно заполнять поле “ID заказа/Внешний ID заказа”. Задача автоматически извлекает все параметры из события о заказе.

Задача работает следующим образом:

1. Система получает данные о заказе.

2. Блок “Задача” извлекает все данные, которые передаются вместе с заказом, и полученные данные передаются в письмо, где они прописаны в виде переменных.

Подробнее о работе блоке “Задача” с заказами читайте в статье Автоматизация работы с заказами.

Создать промокод

Цель задачи – создать (сгенерировать) промокод и передать его в письмо, которое идет следующим в цепочке. Если вы выбрали метод формирования промокодов через сценарий, промокод сгенерирует система eSputnik и передаст данные в письмо. Параметры будут зашифрованы по вашему ключу алгоритмом, а при вводе такого промокода на сайте его расшифрует обратный алгоритм. Подробнее.

У задачи четыре обязательных параметра:

• Дни — указывается количество дней до окончания действия промокода. Система их добавит к текущему числу и полученную дату окончания действия зашифрует в промокод. По умолчанию в это поле ставится параметр ${days}.

• Тип — тип промокода. У вас может быть 32 типа промокодов, которые вы задаете сами. Например: промокод за подписку – присвоен type 0, ко дню рождения – type 1, реактивация – type 3 и т.д. В переменной указывается число от 0 до 31, которое соответствует нужному типу. По умолчанию в это поле ставится параметр ${type}.

• Скидка — размер скидки. Используется для генерации промокода, когда скидка дается в процентах от суммы заказа. Это всегда двузначное число, поэтому скидки до 10% нужно дополнить нулем впереди. Например, указать 05 для подстановки в письмо 5% дисконта. По умолчанию в это поле ставится параметр ${discount}.

• Ключ — ключ шифрования. Можно не менять и оставить по умолчанию. По умолчанию в это поле ставится параметр ${tkey}.

За блоком “Создать промокод”, в сценарии ставится блок отправки сообщения (Email, SMS, Viber и др.). 

В письме на месте промокода надо использовать переменную $!data.get('promocode').

Получить промокод

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

У задачи 3 параметра (все обязательные):

• Дни – количество дней от текущей даты, в течение которых промокод еще должен быть действующим;

• Тип – заданный вами для сегментации тип промокода;

• Скидка – размер скидки от 01 до 99.

Согласно параметрам, система будет отбирать промокоды из загруженной базы. Принцип работы рассмотрим на примере. В параметрах отметим следующие значения: дни – 10, тип – newyear, скидка – 25.

Это означает, что сценарий вытянет из базы промокод со скидкой 25%, которому дан тип newyear и срок действия которого не менее 10 дней. Если заданным условиям соответствуют несколько промокодов, система сама выберет один из них.

За блоком “Получить промокод” в сценарии ставится блок отправки сообщения (Email, SMS, Viber и др.).

 В письме на место, где должен быть промокод, надо вписать переменную $!data.get('promocode').

Запустить событие

Цель задачи – запустить какое-либо событие из сценария. Например, чтобы из одного сценария инициировать старт другого. Для использования задачи предварительно нужно создать тип события, которое мы планируем запустить.

У задачи три параметра:

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

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

• Параметр – массив параметров, которые мы хотим передать в запускаемое событие. Если поле не заполнено, будут переданы параметры из события, запустившего текущий сценарий.

Формат параметров такой:

[{"name":"paramName","value":"значение параметра"}]

Блок “Условие”

Цель блока – проверить, соблюдаются определенные условия сценария или нет. В зависимости от этого дальнейший ход сценария разделяется на две отдельные ветки: “Да” или “Нет”.

Блок имеет один вход (блок “Старт”) и 2 выхода (“Конец”): для ветки “Да” и для ветки “Нет”.

У блока “Условие” есть семь задач:

• Проверить событие;

• Переменная соответствует регулярному выражению;

• Контакт подтвержден;

• Контакт существует;

• Проверить параметр по дате/времени;

• Проверить, что поле контакта соответствует параметру события;

• Проверьте поля списка чекбоксов.

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

Проверить событие

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

У задачи есть три  параметра:

• Ключ уникальности — какой ключ события искать. Например, в качестве ключей проверяемых событий используется email-адрес. Таким образом, в этом поле должен быть параметр, содержащий email-адрес. Это параметр из события, запустившего текущий сценарий. Если он называется “emailAddress”, то в поле надо написать ${emailAddress}.

• Событие – тип события, который нужно проверить. Обязательное поле, без заполнения которого сценарий не будет работать.

• Период — в этом поле можно задать время до старта сценария, в течение которого нужно учитывать случившееся  событие. По умолчанию блок проверяет события с момента активации сценария.

Переменная соответствует регулярному выражению

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

Например, мы можем проверить, кто наш пользователь: мужчина или женщина, и отправить им разные сообщения.

У задачи есть 2 параметра:

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

• Паттерн — регулярное выражение, на соответствие с которым проверяем данные. Например: хотим проверить, что параметр address из события содержит текст “Киев”. В этом случае в pattern прописываем Киев.

Пример работы и полной настройки такого блока.

Контакт подтвержден

Цель задачи – проверить, подтвержден ли email контакта, и в зависимости от этого скорректировать дальнейший ход сценария.

Например, человек зарегистрировался на сайте или подписался на вашу рассылку. Вы хотите отправить ему приветственное письмо.

В этом случае:

1. Контакт появляется в базе eSputnik, но находится в статусе неподтвержденного;

2. Человеку отправляется письмо с просьбой подтвердить регистрацию;

3. Задача проверяет подтвердил человек регистрацию или нет;

4. Если подтвердил, сценарий идет по ветке “Да” и отправляется приветственное письмо;

5. Если еще не подтвердил регистрацию, сценарий идет по ветке “Нет”.

У задачи есть два параметра:

• Email — email-адрес контакта.

• Contact ID — ID контакта в системе.

По умолчанию система проверят, подтвержден контакт или нет, по email. В поле “Email” необходимо  прописать название переменной или email-адрес. Например, ${emailAddress} или test@test.com.

Если вы хотите, чтобы идентификация проходила по ID контакта, необходимо в поле “Contact ID” вписать переменную ${contactId}.

Для задачи “Контакт подтвержден” в любом случае должен быть указан один из параметров.

Контакт существует

Цель задачи – проверить, существует контакт или нет, и в зависимости от этого скорректировать дальнейший ход сценария. Работает аналогично задаче “Контакт подтвержден”.

У данной задачи есть три  параметра:

• Email — email-адрес контакта.

• Номер телефона — номер телефона контакта.

• Contact ID — ID контакта в системе.

По умолчанию система проверяет, существует контакт или нет, по email. Если вы хотите, чтобы идентификация была по ID контакта, необходимо в поле ContactId вписать переменную ${contactId}. Для идентификации контакта по телефону укажите в поле “Номер телефона” переменную  ${phoneNumber}.

Проверить параметр по дате/времени

Цель задачи – проверить дату из параметра события.

При создании сценария учитывается часовой пояс пользователя, время будет сохранено в UTC.

Например, проверяем дату со временем 2020-07-30 13:00. Часовой пояс пользователя – (GMT +3) Europe/Kyiv, соответственно, в событии будет передано “2020-07-30T13:00+03:00”.

У задачи есть такие параметры:

• Параметр — необходимо указать значение параметра, которое передается в событии. Нужный формат передачи даты – ISO 8601.

• Дата — поле, где необходимо выбрать из списка конкретную дату или диапазон дат.

Выбор параметров даты и/или времени

Для выбора настройки даты и/или времени:

1. Кликните поле “Дата” и выберите один из следующих параметров:

• Дата

• Дата со временем

• Диапазон дат

• Диапазон времени

• Диапазон дат со временем

• Дата входит в период до

• Дата входит в период после

• Дата со временем больше текущего на

2. Установите нужные параметры даты и времени для выбранного варианта, как описано ниже.

Настройка параметра “Дата”

Когда вы выбираете “Lата”, блок "Условие" проверяет, совпадает ли дата события с выбранной датой для этого параметра.

Нажмите значок календаря, чтобы выбрать дату:

Настройка параметров “Дата со временем”

При выборе варианта “Дата со временем”, блок «Условие» проверяет, совпадает ли дата события с выбранной датой и временем для этого параметра.

Чтобы выбрать дату со временем:

1. Кликните на значке календаря и выберите дату в окне выбора даты.

2. В открывшемся окне выбора часов и минут выберите нужные значения.

Настройка параметров “Диапазон дат”

При выборе параметра “Диапазон дат”, блок “Условие” проверяет, входит ли дата события в выбранный диапазон дат для этого параметра.
Для выбора диапазона дат:

1. Нажмите на дату слева и выберите начальную дату диапазона.

2. Нажмите дату справа и выберите конечную дату.

Настройка параметров “Диапазон времени”

При выборе “Диапазона времени” блок “Условие” проверяет, совпадает ли диапазон времени события с выбранным диапазоном времени для этого параметра.

Для выбора диапазона времени:

1. Кликните время слева и выберите начальное время в окне выбора времени.

2. Кликните время справа и выберите время завершения в окне выбора времени.

Настройка параметров “Диапазон дат со временем”

При выборе “Диапазона дат со временем” блок “Условие” проверяет, соответствуют ли диапазон даты и времени события выбранному диапазону даты и времени для этого параметра.

Для выбора настройки диапазона даты/времени:

1. Кликните дату со временем слева и выберите начальную дату и время в окне выбора.

2. Кликните дату со временем справа и выберите дату и время завершения в окне выбора.

Настройка параметров “Дата входит в период до”

Когда вы выбираете “Дата входит в период до”, блок “Условие” проверяет, входит ли дата события, полученная в качестве параметра, в диапазон дат до выбранной даты.

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

Настройка параметра “Дата входит в период после”

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

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

Настройка параметра  “Дата со временем больше текущего на”

При выборе параметра “Дата со временем больше текущего на”, блок “Условие” проверяет, превышают ли дата и время события, полученные в качестве параметра, текущую дату и время на N минут/часов/дней.

Пример:

Вы организуете вебинар с датой и временем начала 2022-10-10 16:00.

Вы настроили отправку 3 сообщений участникам, прошедшим регистрацию: за 30, 10 и 5 минут до начала вебинара.

Дата и время регистрации участника - 2022-10-10 15:52 (текущая дата и время).

Блок “Условие” осуществляет сравнение текущего времени со временем из параметра события. В результате сравнения:

• Отправка первого сообщения отменяется, поскольку условие отправки сообщения (за 30 минут) не выполняется.

• Отправка второго сообщения отменяется, поскольку условие отправки сообщения (за 10 минут) не выполняется.

• Третье сообщение будет отправлено по расписанию, поскольку условие отправки сообщения (за 5 минут) выполняется.

Чтобы настроить условие “Дата и время больше текущего на”, введите значение в поле даты/времени и выберите его формат из списка: минуты, часы или дни.

Проверить, что поле контакта соответствует параметру события

Задача позволяет проверить соответствие поля контакта переданному значению в параметре события. Например, вы хотите проверить, соответствует ли город подписчика значению города, переданному в событии. Если нет – можно далее поставить блок обновления контакта.

У условия есть два базовых параметра:

• Поле контакта – поле из карточки контакта, соответствие которого нужно проверить. Можно выбрать из выпадающего списка или с помощью поиска в строке. Сравнению подлежат поля следующих типов: текстовое поле, текстовая область, число, дробное число, выпадающий список.

• Параметр – параметр события, на соответствие с которым проверяем поле контакта. Значение можно указать как переменную ${parameter} (название параметра в событии, например, ${city}) – в данном случае сравнивается поле контакта, указанное в ”Поле контакта”, со значением из указанного параметра в событии. Также можно задать строку в формате 123abc (например, Киев) – тогда происходит сравнение поля контакта с конкретным значением, указанным в параметре (то есть, равняется ли поле контакта 123abc?). 

Также условие имеет расширенные параметры.

Подробнее о расширенных параметрах блоков сценариев >

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

Проверьте поля списка чекбоксов

Цель задачи — проверить наличие пустых или конкретных чекбоксов в карточке контакта.

В списке чекбоксов отображаются чекбоксы, созданные в разделе “Дополнительные поля”.

Доступны такие опции проверки:

• Проверить наличие пустых полей в списке чекбоксов
• Проверить наличие конкретных полей списка чекбоксов
• Проверить наличие одного из конкретных полей списка чекбоксов

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

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

Название – единственный параметр блока.