Centro de ayuda de Kwiga Servicios, integraciones, API, Configuración Configuración general Uso de variables en el proyecto, lista de variables disponibles

Uso de variables en el proyecto, lista de variables disponibles

Artículos:

hace 3 semanas • Actualizado

Este artículo explica cómo usar variables en tu proyecto: dónde aplicarlas, qué datos están disponibles y cómo utilizarlas para automatización y personalización. Incluye una lista con descripciones y ejemplos para correos electrónicos, webhooks, botones, lecciones y más.

Información general sobre variables

Las variables son una forma conveniente de insertar datos personalizados en varios elementos de tu proyecto. Pueden usarse en los siguientes lugares:

1. Webhooks en automatizaciones

Las variables se pueden insertar:

en la URL del webhook, por ejemplo:
https://example.com/hook?user={user.email}
en los parámetros del cuerpo de la solicitud
en los encabezados

Esto permite transmitir datos personales a servicios externos automáticamente.

2. CTA (Llamada a la acción)

En botones y enlaces, las variables se pueden usar para:

personalizar el texto del botón
transmitir datos a través de enlaces, como el ID de usuario o etiquetas UTM

3. En parámetros

Las variables se pueden usar en parámetros de formularios u otros elementos:

email del usuario
ID de suscripción
códigos únicos y etiquetas
cualquier otra variable disponible en el contexto

4. En el enlace de redirección (si no se utiliza el paso de pago)

Se pueden agregar variables manualmente en el enlace de redirección:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. En infobloques de lecciones

Las variables funcionan dentro de los textos de infobloques. Por ejemplo:

Saludo por nombre: ¡Hola, {user.first_name}!
Mostrar el nombre del curso, fecha, estado, etc.

6. En correos electrónicos

El uso de variables en correos electrónicos permite que la comunicación sea más personalizada y efectiva. Con variables como {nombre}, {fecha} o {nombre del curso}, el correo parece dirigido personalmente al cliente. Esto aumenta la confianza, el compromiso y la probabilidad de que el usuario lea el correo hasta el final o realice la acción deseada. Además, las variables facilitan la automatización de envíos masivos sin perder el enfoque individual.

Lista de variables disponibles

Lista de variables disponibles que están disponibles en todos los lugares donde se pueden usar variables.

Variable	Valor
contact.id	ID de contacto
contact.user_id	ID de usuario
contact.first_name	Nombre del contacto
contact.last_name	Apellido del contacto
contact.middle_name	Segundo nombre del contacto
contact.name	Nombre completo del contacto
contact.email	Email del contacto
contact.phone	Teléfono del contacto
contact.country	País del contacto. Por ejemplo: Ucrania
contact.timezone	Zona horaria del contacto. Por ejemplo: Europe/Kyiv
contact.currency	Moneda del contacto. Por ejemplo: USD
contact.city	Ciudad del contacto
contact.utm_source	Lista de utm_source únicos del contacto (separador ", ")
contact.utm_medium	Lista de utm_medium únicos del contacto (separador ", ")
contact.utm_campaign	Lista de utm_campaign únicos del contacto (separador ", ")
contact.utm_term	Lista de utm_term únicos del contacto (separador ", ")
contact.utm_content	Lista de utm_content únicos del contacto (separador ", ")
contact.field_<id>	Campos personalizados (descripción abajo)
datetime	Fecha y hora en UTC en formato YYYY-MM-DD HH:mm:ss
contact.visit_source	Fuente de visita

Campos personalizados

{contact.field_<id>}

Ejemplo {contact.field_123}

<id> - id del campo que se puede obtener en la configuración de campos de contacto (ejemplo https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Variables que se pueden usar adicionalmente en CTA

en parámetros
en el enlace de redirección (si no se utiliza el paso de pago)

Variable	Valor
first_name	Nombre de la solicitud
last_name	Apellido de la solicitud
middle_name	Segundo nombre de la solicitud
name	Nombre completo de la solicitud
email	Email de la solicitud
phone	Teléfono de la solicitud
field_<id>	Campos personalizados Teléfono de la solicitud (descripción abajo)
utm_source	utm_source - específicamente de la visita desde la cual se dejó la solicitud
utm_medium	utm_medium - específicamente de la visita desde la cual se dejó la solicitud
utm_campaign	utm_campaign - específicamente de la visita desde la cual se dejó la solicitud
utm_term	utm_term - específicamente de la visita desde la cual se dejó la solicitud
utm_content	utm_content - específicamente de la visita desde la cual se dejó la solicitud
widget_landing	Url de la landing desde la cual se envió la solicitud
widget_landign_referer	Referer que estaba en la landing cuando se envió la solicitud
También en ciertos formularios pueden estar disponibles las variables descritas a continuación en Variables disponibles en webhooks de automatización Por pedido ({order.}) - Si se selecciona la opción de formulario Acceso al producto (Acceso completo/Por oferta) Por producto({product.}) - Si se selecciona la opción de formulario Acceso al producto + Acceso completo Por oferta ({offer.*}) - Si se selecciona la opción de formulario Acceso al producto + Por oferta

Campos personalizados

{field_<id>}

Ejemplo {contact.field_123}

<id> - id del campo que se puede obtener en la configuración de campos de contacto (ejemplo https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Si en la página donde se coloca el CTA o el script de Kwiga para el seguimiento de visitas hubo visitas con etiquetas utm, y el cliente dejó una solicitud en la landing ya sin etiquetas utm, entonces en estas variables estarán ausentes. Pero estarán disponibles en las variables {contact.utm_...}, que se describen arriba.

Variables disponibles en los webhooks de automatización (url, parámetros, correos)