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. У листах

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

7. В сповіщеннях

При налаштуванні сповіщень у діях автоматизації, змінні дозволяють динамічно вставляти інформацію в сповіщення, наприклад, ім'я користувача, номер замовлення або назву пропозиції. Це спрощує і прискорює процес створення сповіщень, роблячи їх більш інтуїтивними та адаптивними для різних сценаріїв.

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

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

Змінна	Значення
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, параметри, листи)