Розширені параметри блоків сценаріїв
Розширені параметри необхідно заповнювати в таких випадках:
- Використання нестандартних параметрів подій
- Відправлення повідомлень додатковому контакту
- Підстановка динамічного контенту
Перелік розширених параметрів:
| Назва параметра | Опис |
|---|---|
| ID контакту | Ідентифікатор контакту в системі, або параметр із події, що містить його. |
| Email-адреса контакту або параметр із події, що містить email-адресу. | |
| Номер телефону | Номер телефону одержувача або параметр із події, що містить його. |
| Токен | Токен підписника, або параметр із події, що містить його. |
| Мова | Мова повідомлення. Якщо ви використовуєте в сценарії мультимовне повідомлення залиште поле порожнім. Докладніше про налаштування мультимовних розсилок > |
Далі докладно розглянемо кожен випадок заповнення параметрів.
Зверніть увагуЯкщо поле Мова порожнє, мова мультимовного повідомлення визначається мовою з картки контакту: якщо для неї є мовна версія — надсилається вона, інакше основна версія. Мова, передана в параметрі події, автоматично не застосовується. Щоб використати мову з параметра події, вкажіть у полі Мова змінну в повному записі, наприклад
$data.get('attribution.lang')— скорочений запис${attribution.lang}не працює.
Використання нестандартних параметрів подій
За замовчуванням, щоб ідентифікувати контакт для відправцювання сценарію, в події мають передаватись стандартні параметри:
| Параметр події | Ідентифікатори |
|---|---|
| ContactId | ID контакту |
| externalCustomerId | Зовнішній ID |
| Email EmailAddress UserEmail ContactEmail | |
| Phone SMS PhoneNumber | Номер телефону |
| PushToken MobPushToken TelegramBotToken | Токен контакту |
Важливо
Основним ідентифікатором є ContactId. Якщо він не вказаний, але передається хоча б один з інших ідентифікаторів, то ContactId автоматично додасться в подію.
Для запуску сценаріїв система ідентифікує контакт для якого надійшла подія. Пошук контакту відбувається за такими правилами:
ID контакту має найвищий пріоритет серед усіх параметрів.
Вказані в полі блоку email контакту, номер телефону чи токен використовуються для відправлення повідомлень.
Якщо задано externalCustomerId, виконується відправлення контакту, якому він належить; серед тих, що були знайдені за email-адресою, номером телефону чи токеном.
Якщо externalCustomerId не задано, виконується відправлення контакту, знайденому за email адресою, номером телефону чи токеном.
Якщо контакт не знайдено, для відправлення буде створено новий контакт.
- Для узгодженості даних передавайте назву параметрів відповідно до вказаного переліку.
Якщо в події параметри не відповідають стандартним значенням, наприклад, замість EmailAddress вказано PersonalEmail.
В цьому випадку у полі Email вкажіть назву відповідної змінної.
Зверніть увагуEmailAddress дійсно входить до переліку стандартних назв параметрів, за якими система може зіставити подію з контактом (порівняння назв відбувається без урахування регістру). Але це не означає, що контакт створиться автоматично.
Навіть стандартний EmailAddress потрібно явно змапити в розширених параметрах блока: поле Email має містити саме ту змінну події, яка приходить у вашому payload, наприклад
${EmailAddress}або${emailAddress}.Для бекендової події, щоб дані прив'язалися до картки контакту, додатково потрібно ввімкнути сегментацію для цього типу події.
Помилка Empty contact media («Порожні медіа контакту») означає, що блок не отримав жодного дійсного значення email, номера телефону чи токена.
Зверніть увагуЯкщо в полі Email блока відправлення вказано стандартну змінну
${email}або${emailAddress}, а її значення в події порожнє, лист усе одно надсилається — на email-канал контакту з контексту сценарію. Пропуск відправлення при порожньому значенні змінної працює лише з нестандартним іменем змінної.
Відправлення повідомлень додатковому контакту
Наприклад, повідомлення, яке було відправлено користувачеві, необхідно продублювати менеджеру. Для цього в сценарії скопіюйте блок з вибраним повідомленням і вкажіть контакти менеджера в розширених параметрах.
Один блок повідомлення не надсилає лист на кілька адрес одночасно. Щоб надіслати копії листа на додаткові адреси, додайте окремий блок листа для кожної статичної адреси: у розширених параметрах блока вкажіть адресу в полі Email і очистіть поле ID контакту. Для відправлення самому контакту використовуйте ще один окремий блок повідомлення.
Updated 4 days ago