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

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

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

• Email

• SMS

• Viber

• Web Push

• Mobile Push

• App Inbox

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

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

• Сообщение — обязательный параметр. Из выпадающего списка можно выбрать необходимое сообщение или указать динамическую переменную  ${emailMessageId}.

Чтобы скопировать ID сообщения, нажмите значок копирования рядом с ним.

• Номер телефона (для блоков “SMS”,“Viber”,“Web Push”) — номер телефона получателя или параметр из события, содержащий его. Автоматически в параметр подставляется переменная ${phoneNumber}.

В вашем событии она может называться ${SMS}, ${PhoneNumber}, ${Phone}. Проверьте и запишите точное название для корректной работы блока. 

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

• Contact ID – идентификатор контакта в системе. Указать ID можно вместо email или номера телефона. Для многих системных событий этот параметр называется “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')

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

По умолчанию для всех организаций установлено дневное время с 8:00 до 20:00. Это дает возможность не раздражать пользователя письмами в личное время и отложить отправку до разрешенного периода. 

Чтобы изменить данный временной промежуток или задать для каждого дня разное время можно, в личном кабинете перейдите в “Настройки” → “Сценарии”.

Более подробную информацию читайте здесь.

Соответствующие значки на блоке показывают, включен ли этот параметр для определенного сообщения:

1. Обычная иконка блока свидетельствует, что сообщение может быть отправлено в любое время суток.

2. Икона блока с часами свидетельствует, что сообщение будет отправлено только в разрешенное время.

Email

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

Кроме общих, блок  “Email” содержит такие параметры:

• Email – укажите email-адрес контакта или параметр из события, содержащий email-адрес. По умолчанию прописана переменная ${emailAddress}, если в вашем событии этот параметр называется по другому, замените на свое название.

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

Пример параметра языка:

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

• ru, uk, en

• RU, UK, EN

• ru-RU, uk-UA, en-US

SMS

Задача блока — отправить одно SMS-сообщение одному получателю

Viber

Задача блока — отправить одно Viber-сообщение одному получателю.

Кроме общих, у блока “Viber” есть параметр “Время активности сообщения” () — период, после которого сообщение не будет показано, если до этого оно не было доставлено пользователю. 

Viber-сообщение отправится только контакту с заполненным полем “Номер телефона” в его карточке. Если поле пустое – сценарий проигнорирует блок  “Viber” и не отправит сообщение контакту. 

Web Push

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

Кроме общих, блок  “Web Push” содержит такие параметры:

• Токен – токен подписчика. По умолчанию в поле прописана переменная ${pushToken}.

• Email – email-адрес подписчика. По умолчанию в поле прописана переменная ${emailAddress}.

Mobile Push

Задача блока — отправить одно Mobile Push-сообщение одному получателю.

Кроме общих, блок  “Mobile Push” содержит такие параметры:

• Токен – токен подписчика. По умолчанию в поле прописана переменная ${mobPushToken}.

• Приложение – идентификатор приложения для аккаунтов с более чем одним приложением. Вы можете выбрать приложение для отправки уведомлений из выпадающего списка или указать динамический параметр ${appId}. Система извлекает идентификатор приложения из события, которое инициировало сценарий. При отправке событий через SDK этот параметр передается автоматически.

App Inbox

Задача блока — отправить одно App Inbox-сообщение одному получателю.