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

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

Статті:

7 місяців тому • Оновлено

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

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

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

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. У посиланні редиректу успішної оплати пропозиції

У посиланні редиректу після успішної оплати пропозиції доступні змінні з блоків contact.*, order.* і payment.*

Приклад: https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

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

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

Звернення по імені: Привіт, {user.first_name}!
Виведення назви курсу, дати, статусу і т.д.
Дані контакту: {contact.name}, {contact.email} та інші поля
Умовні блоки @if/@endif: показувати різний контент залежно від того, чи має контакт тег, доступ до пропозиції тощо.

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

Як змінити значення змінної

Після змінної можна додати опції, щоб змінити її вигляд: дописати текст, зробити літери великими або відформатувати дату.

Загальний вигляд: {variable|option:value|option}. Наприклад: {order.id|prefix:ORDER-} або {payment.paid_at|format:DD.MM.YYYY}.

Що хочете отримати	Що написати
Додати текст перед значенням	`{order.id\|prefix:ORDER-}` -> вийде `ORDER-123`
Додати текст після значення	`{order.id\|suffix:-EU}` -> вийде `123-EU`
Зробити номер фіксованої довжини	`{payment.number\|pad:6}` -> вийде `000001`
Заповнювати не нулями, а своїм символом	`{payment.number\|pad:6\|padchar:_}` -> вийде `_____1`
Зробити всі літери великими	`{contact.city\|upper}` -> `KYIV`
Зробити всі літери малими	`{contact.city\|lower}` -> `kyiv`
Зробити великою тільки першу літеру	`{contact.city\|ucfirst}` -> `Kyiv`
Показати дату в потрібному вигляді	`{payment.paid_at\|format:DD.MM.YYYY}` -> вийде `24.12.2026`

Якщо хочете свій шаблон дати, можна подивитися готові позначення у відкритих довідках: для варіантів на кшталт DD.MM.YYYY, MMMM YYYY, dddd підійде довідка Carbon. Для варіантів на кшталт Y-m-d і H:i:s підійде офіційна довідка PHP.

Важливо: якщо використовується pad, спочатку значення доповнюється до потрібної довжини, і лише потім застосовуються інші опції.

Умовні блоки @if / @endif

Дозволяють показувати або приховувати частину тексту залежно від умови. Якщо умова — правда, блок відображається; якщо ні — повністю прибирається.

Синтаксис: @if(умова)...текст...@endif

Приклад:
@if({contact.has|offer:123})Отримайте доступ до матеріалів@endif

Умова всередині @if() — це будь-яка змінна, яка повертає true або false. Наразі підтримується {contact.has|...} (перевірка приналежності контакту).

Умова contact.has — перевірка контакту

Дозволяє перевірити, чи відповідає контакт певним умовам. Повертає true або false. Зазвичай використовується разом із умовними блоками @if/@endif.

Синтаксис: {contact.has|тип:значення}

Тип	Значення	Опис
`offer`	ID пропозиції	Контакт має доступ до пропозиції
`order`	ID замовлення	У контакту є замовлення з таким ID
`product`	ID продукту	Контакт має доступ до продукту
`tag`	ID або назва тегу	У контакту є тег (підтримуються кирилиця та пробіли в назві)
`list`	ID списку	Контакт входить до списку
`course`	ID курсу	Контакт записаний на курс
`marathon`	ID курсу	Псевдонім для course (марафон — підтип курсу)
`webinar`	ID вебінару	Контакт має доступ до вебінару
`closed_group`	ID закритої групи	Контакт має доступ до закритої групи

Можна вказати кілька умов через | — всі вони повинні виконатися одночасно (логіка AND). Наприклад: {contact.has|offer:123|tag:VIP}

Приклади використання:

{contact.has\|offer:123}	перевіряє наявність пропозиції з ID 123
{contact.has\|tag:VIP}	перевіряє тег за назвою
{contact.has\|tag:тест тег}	тег з пробілом і кирилицею
{contact.has\|offer:123\|tag:VIP}	обидві умови одночасно (AND)

Змінні, які можна додатково використовувати в 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, параметри, листи)