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>}

Пример {field_123}

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

Custom fields example

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

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