Розширені параметри блоків сценаріїв
Розширені параметри необхідно заповнювати в таких випадках:
- Використання нестандартних параметрів подій
- Відправлення повідомлень додатковому контакту
- Підстановка динамічного контенту
Перелік розширених параметрів:
Назва параметра | Опис |
|---|---|
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}.
У повідомленні вкажіть змінні, які будуть відображати товари.
