Расширенные параметры блоков сценариев
Расширенные параметры необходимо заполнять в таких случаях:
Использование нестандартных параметров событий
Отправка сообщений дополнительному контакту
Подстановка динамического контента
Перечень расширенных параметров:
Название параметра | Описание |
|---|---|
ID контакта | Идентификатор контакта в системе или параметр из события, содержащий его. |
Email-адрес контакта или параметр из события, содержащий email-адрес. | |
Номер телефона | Номер телефона получателя или параметр из события, содержащий его. |
Токен | Токен подписчика или параметр из события, содержащий его. |
Язык | Язык сообщения. Если вы используете в сценарии мультиязычное сообщение, оставьте поле пустым. |
JSON | Подстановка данных из события в сообщение. |
Далее подробно рассмотрим каждый случай заполнения параметров.
Использование нестандартных параметров событий
По умолчанию, для идентификации контакта при отправке сценария в событии должны передаваться стандартные параметры:
Параметр события | Идентификаторы |
|---|---|
ContactId Contact_id | ID контакта |
externalCustomerId | Внешний ID |
EmailAddress UserEmail ContactEmail | |
Phone SMS PhoneNumber | Номер телефона |
PushToken MobPushToken TelegramBotToken | Токен контакта |
Важно
Основным идентификатором является ContactId. Если он не указан, но передан хотя бы один из других идентификаторов, то ContactId будет автоматически добавлен в событие.
Для запуска сценариев система идентифицирует контакт, для которого поступило событие. Поиск контакта происходит по следующим правилам:
ID контакта имеет наивысший приоритет среди всех параметров.
Указанные в поле блока email контакта, номер телефона или токен используются для отправки.
Если указан externalCustomerId, отправка производится контакту, которому он принадлежит; среди тех, которые были найдены по email адресу, номеру телефона или токену.
Если externalCustomerId не указан, отправка производится контакту, найденному по email адресу, номеру телефона или токену.
Если контакт не найден, для отправки будет создан новый контакт.
Для согласованности данных передавайте названия параметров в соответствии с указанным перечнем.
Если в событии параметры не соответствуют стандартным значениям, например, вместо “EmailAddress” указан “PersonalEmail”.
В этом случае в поле “Email” укажите название соответствующей переменной.
Отправка сообщений дополнительному контакту
Например, сообщение, которое было отправлено пользователю, необходимо продублировать менеджеру. Для этого в сценарии скопируйте блок с выбранным сообщением и укажите контакты менеджера в расширенных параметрах.
Подстановка динамического контента
Используется в случае, когда необходимо вывести определённые данные из события в сообщении.
Например, если событие содержит JSON:
{ "name": "items", " value": { "array": [ { "name": "Суха дитяча молочна суміш HiPP Combiotic 2, 750 г", "price": "341.00", "url": "https://site.com/catalog/suha-dityacha-molochna-sumish-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/molochna-organichna-vivsyana-kasha-z-yablukom-hipp-na-dobranich-250-g", "imageUrl": "https://site.com/uploads/product/big/23112013/2125.jpg" } ] } }JSON
где:
name - название поля
value - значение, которое необходимо підставить в сообщение.
Вставьте в параметр JSON название поля в формате ${items}.
В сообщении необходимо указать переменные, которые будут отображать товары.
