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

Пример {field_123}

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

Custom fields example

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

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