KWIGA справочный центр Сервисы, интеграции, API, Настройки проекта Глобальные настройки Использование переменных на проекте, список доступных переменных

Использование переменных на проекте, список доступных переменных

Статьи:

8 месяцев назад • Обновлено

В этой статье объясняется, как использовать переменные в вашем проекте — где их применять, какие данные доступны и как использовать их для автоматизации и персонализации. Включает список с описаниями и примерами для писем, вебхуков, кнопок, уроков и других элементов.

Общая информация о переменных

Переменные - это удобный способ подставлять персонализированные данные в различные элементы вашего проекта. Они могут использоваться в таких местах:

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}

6. В инфоблоках уроков

Переменные и условные блоки работают внутри текстов инфоблоков. Например:

Обращение по имени: Привет, {user.first_name}!
Вывод названия курса, даты, статуса и т.д.
Данные контакта: {contact.name}, {contact.email} и другие поля
Условные блоки @if/@endif: показать разный контент в зависимости от того, есть ли у контакта тег, доступ к предложению и т.д.

7. В письмах

Использование переменных в письмах позволяет сделать коммуникацию более персонализированной и эффективной. С помощью переменных, таких как {имя}, {дата} или {название курса} письмо выглядит персонально адресованным для клиента. Это повышает доверие, вовлеченность и вероятность того, что пользователь дочитает письмо до конца или выполнит нужное действие. Кроме того, переменные упрощают автоматизацию массовых рассылок без потери индивидуального подхода.

8. В уведомлениях

При настройке уведомлений в действиях автоматизации, переменные позволяют динамически вставлять информацию в уведомления, например, имя пользователя, номер заказа или название предложения. Это упрощает и ускоряет процесс создания уведомлений, делая их более интуитивными и адаптивными для разных сценариев.

Список доступных переменных

Список доступных переменных, которые доступны во всех местах, где можно использовать переменные.

Переменная	Значение
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>}

Пример {field_123}

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

Custom fields example

Если на странице, где размещен CTA или скрипт Kwiga для трекинга посещений, были посещения с utm метками, и клиент оставил заявку на лендинге уже без utm меток, то в этих переменных они будут отсутствовать. Но они будут доступны в переменных {contact.utm_...}, которые описаны выше.

Переменные доступные в вебхуках автоматизации (url, параметры, письма)