Розширені параметри блоків сценаріїв
Розширені параметри необхідно заповнювати в таких випадках:
- Використання нестандартних параметрів подій
- Відправлення повідомлень додатковому контакту
- Підстановка динамічного контенту
Перелік розширених параметрів:
| Назва параметра | Опис |
|---|---|
| ID контакту | Ідентифікатор контакту в системі, або параметр із події, що містить його. |
| Email-адреса контакту або параметр із події, що містить email-адресу. | |
| Номер телефону | Номер телефону одержувача або параметр із події, що містить його. |
| Токен | Токен підписника, або параметр із події, що містить його. |
| Мова | Мова повідомлення. Якщо ви використовуєте в сценарії мультимовне повідомлення залиште поле порожнім. Докладніше про налаштування мультимовних розсилок > |
Далі докладно розглянемо кожен випадок заповнення параметрів.
Якщо поле Мова порожнє, мова мультимовного повідомлення визначається мовою з картки контакту: якщо для неї є мовна версія — надсилається вона, інакше основна версія. Мова, передана в параметрі події, автоматично не застосовується. Щоб використати мову з параметра події, вкажіть у полі Мова змінну в повному записі, наприклад
$data.get('attribution.lang')— скорочений запис${attribution.lang}не працює, сценарій завершується помилкоюattribution is required.
Ðлок відправлення надсилає на одну адресу: щоб надіслати те саме повідомлення на дві статичні адреси, додайте окремий блок для кожної. Коли заповнюєте Email, щоб надіслати на конкретну адресу, поле ID контакту лишайте порожнім — вказаний ID має вищий пріоритет, і повідомлення піде саме цьому контакту.
Використання нестандартних параметрів подій
За замовчуванням, щоб ідентифікувати контакт для відправцювання сценарію, в події мають передаватись стандартні параметри:
| Параметр події | Ідентифікатори |
|---|---|
| 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 вказано змінну з адресою, наприклад ${email}, а в події немає ID контакту чи External ID, лист отримує контакт, знайдений за цією адресою. Коли в базі кілька контактів з однаковою адресою, це може бути будь-який із них. Щоб лист отримав потрібний контакт, передавайте в події його ID або External ID. Якщо дублікати з'явилися випадково, знайдіть їх фільтром Пошук дублікатів.
Відправлення повідомлень додатковому контакту
Наприклад, повідомлення, яке було відправлено користувачеві, необхідно продублювати менеджеру. Для цього в сценарії скопіюйте блок з вибраним повідомленням і вкажіть контакти менеджера в розширених параметрах.
Один блок повідомлення не надсилає лист на кілька адрес одночасно. Щоб надіслати лист ще й на додаткові адреси, додайте окремий блок листа для кожної статичної адреси: у розширених параметрах блока вкажіть адресу в полі Email і очистіть поле ID контакту. Для відправлення самому контакту використовуйте ще один окремий блок повідомлення.
Замість статичної адреси в полі Email можна вказати змінну з події. Наприклад, контакт зареєструвався з однією адресою, а оплатив з іншою, і вона приходить у параметрі події paymentEmail. Щоб лист про оплату отримали обидві адреси, додайте в сценарій два блоки з цим листом:
- у першому залиште розширені параметри за замовчуванням — він надішле лист на адресу контакта;
- у другому вкажіть у полі Email
$paymentEmail, а поле ID контакту залиште порожнім — він надішле лист на адресу з параметра події.
Надіслати один лист кільком одержувачам, як через поля копії та прихованої копії в поштовій програмі, не можна: кожен лист має одного одержувача. Лист на додаткову адресу:
- містить персоналізацію для цієї адреси, а не дані основного контакта;
- рахується в статистиці як ще одне надсилання;
- відображається в активності контакта, якщо ця адреса є в його картці.
Updated 5 days ago