KWIGA центр підтримки Сервіси, інтеграції, API, Налаштування кабінету Загальні налаштування Використання змінних на проекті, список доступних змінних

Використання змінних на проекті, список доступних змінних

Статті:

3 тижні тому • Оновлено

У цій статті пояснюється, як використовувати змінні у вашому проєкті — де їх застосовувати, які дані доступні та як використовувати їх для автоматизації й персоналізації. Містить список із описами та прикладами для листів, вебхуків, кнопок, уроків та інших елементів.

Загальна інформація про змінні

Змінні - це зручний спосіб підставляти персоналізовані дані в різні елементи вашого проєкту. Вони можуть використовуватися в таких місцях:

1. Вебхуки в автоматизаціях

Змінні можна підставляти:

в URL вебхука, наприклад:
https://example.com/hook?user={user.email}
в параметрах тіла запиту
в заголовках

Це дозволяє передавати персональні дані в сторонні сервіси автоматично.

2. CTA (Call to Action)

У кнопках і посиланнях змінні можна використовувати для:

персоналізації тексту кнопки
передачі даних через посилання, наприклад ID користувача або UTM-мітки

3. У параметрах

Змінні можна використовувати в параметрах форм або інших елементів:

email користувача
ID підписки
унікальні коди і теги
будь-яка інша змінна, доступна в контексті

4. У посиланні редиректу (якщо не використовується перехід на оплату)

Можна додати змінні вручну в посилання редиректу:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. В інфоблоках уроків

Змінні працюють всередині текстів інфоблоків. Наприклад:

Звернення по імені: Привіт, {user.first_name}!
Виведення назви курсу, дати, статусу і т.д.

6. У листах

Використання змінних у листах дозволяє зробити комунікацію більш персоналізованою та ефективною. За допомогою змінних, таких як {ім'я}, {дата} або {назва курсу} лист виглядає персонально адресованим для клієнта. Це підвищує довіру, залученість і ймовірність того, що користувач дочитає лист до кінця або виконає потрібну дію. Крім того, змінні спрощують автоматизацію масових розсилок без втрати індивідуального підходу.

Список доступних змінних

Список доступних змінних, які доступні у всіх місцях, де можна використовувати змінні.

Змінна	Значення
contact.id	ID контакту
contact.user_id	ID користувача
contact.first_name	Ім'я контакту
contact.last_name	Прізвище контакту
contact.middle_name	По батькові контакту
contact.name	Повне ім'я контакту
contact.email	Email контакту
contact.phone	Телефон контакту
contact.country	Країна контакту. Наприклад: Україна
contact.timezone	Часовий пояс контакту. Наприклад: Europe/Kyiv
contact.currency	Валюта контакту. Наприклад: USD
contact.city	Місто контакту
contact.utm_source	Список унікальних utm_source контакту (роздільник ", ")
contact.utm_medium	Список унікальних utm_medium контакту (роздільник ", ")
contact.utm_campaign	Список унікальних utm_campaign контакту (роздільник ", ")
contact.utm_term	Список унікальних utm_term контакту (роздільник ", ")
contact.utm_content	Список унікальних utm_content контакту (роздільник ", ")
contact.field_<id>	Кастомні поля (опис нижче)
datetime	Дата і час в UTC у форматі YYYY-MM-DD HH:mm:ss
contact.visit_source	Джерело відвідування

Кастомні поля

{contact.field_<id>}

Приклад {contact.field_123}

<id> - id поля, яке можна отримати в налаштуваннях полів контакту (приклад https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Змінні, які можна додатково використовувати в CTA

у параметрах
у посиланні редиректу (якщо не використовується перехід на оплату)

Змінна	Значення
first_name	Ім'я з заявки
last_name	Прізвище з заявки
middle_name	По батькові із заявки
name	Повне ім'я з заявки
email	Email з заявки
phone	Телефон з заявки
field_<id>	Кастомні поля Телефон із заявки (опис нижче)
utm_source	utm_source - конкретно того відвідування, з якого була залишена заявка
utm_medium	utm_medium - конкретно того відвідування, з якого була залишена заявка
utm_campaign	utm_campaign - конкретно того відвідування, з якого була залишена заявка
utm_term	utm_term - конкретно того відвідування, з якого була залишена заявка
utm_content	utm_content - конкретно того відвідування, з якого була залишена заявка
widget_landing	Url лендингу, з якого відправили заявку
widget_landign_referer	Referer, який був на лендингу, коли відправили заявку
Також у певних формах можуть бути доступні змінні, описані нижче у Змінних доступних у вебхуках автоматизації За замовленням ({order.}) - Якщо обрано варіант форми Доступ до продукту (Повний доступ/За пропозицією) За продуктом({product.}) - Якщо обрано варіант форми Доступ до продукту + Повний доступ За пропозицією ({offer.*}) - Якщо обрано варіант форми Доступ до продукту + За пропозицією

Кастомні поля

{field_<id>}

Приклад {contact.field_123}

<id> - id поля, яке можна отримати в налаштуваннях полів контакту (приклад https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Якщо на сторінці, де розміщено CTA або скрипт Kwiga для трекінгу відвідувань, були відвідування з utm мітками, і клієнт залишив заявку на лендінгу вже без utm міток, то в цих змінних вони будуть відсутні. Але вони будуть доступні у змінних {contact.utm_...}, які описані вище.

Змінні доступні у вебхуках автоматизації (url, параметри, листи)