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.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.field_<id>}

Пример {contact.field_123}

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

Переменные, которые можно дополнительно использовать в CTA

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

Переменная	Значение
{first_name}	Имя с заявки
{last_name}	Фамилия с заявки
{name}	Полное имя с заявки
{email}	Email с заявки
{phone}	Телефон с заявки
{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.*}) - Если выбран вариант формы Доступ к продукту + По предложению

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