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:

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.


En este articulo:


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 o 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.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
name Nombre completo de la solicitud
email Email de la solicitud
phone Teléfono de la solicitud
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

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 de CTA del formulario

Variable Valor
cta.id ID de CTA del formulario
cta.uuid UUID de CTA del formulario
cta.title Nombre de CTA del formulario
cta_request.form_data Lista de datos ingresados por el usuario (separados por saltos de línea)
La lista puede ampliarse.

Disponibles al activarse los siguientes eventos:

  • Solicitud de CTA dejada

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

Variable Valor
referrer Referer de la primera visita conocida del contacto (Kwiga / landing con CTA)
initial_page Url de la primera visita conocida del contacto (Kwiga / landing con CTA)
reg_from Url de la página desde la cual se realizó el registro (Kwiga / landing con CTA)
tags Etiquetas del contacto (separador ", ")
description Descripción del evento que activó la automatización. Por ejemplo: Se añadió la etiqueta test_tag al contacto

Variables de producto

Variable Valor
product.id ID del producto
product.title Nombre del producto
product.productable_type Tipo de producto. Pueden ser las siguientes opciones: course, webinar, closed_group, custom_product
product.productable_id ID del curso/webinar/grupo cerrado/producto personalizado

Disponibles al activarse los siguientes eventos:

  • Acceso al producto abierto
  • Acceso al producto cerrado
  • Registrado en el webinar
  • Curso completado
  • Realización del quiz
  • Anulación del resultado anterior del quiz
  • El quiz cambió de estado
  • Inicio del acceso por suscripción
  • Fin del acceso por suscripción
  • Comenzó a ver la lección
  • Vio la lección
  • Acceso a la lección abierto
  • Práctica en la lección completada

Variables de pedido

Variable Valor
order.id ID del pedido
order.price Precio final. Ejemplo 10.99
order.currency_code Moneda del pedido en formato de código. Ejemplo: USD
order.currency_symbol Moneda del pedido en formato de símbolo. Ejemplo: $
order.currency_short_title Moneda del pedido en nombre abreviado. Ejemplo: usd
order.order_stage_id ID del estado del embudo
order.order_stage_title Nombre del estado del embudo
order.funnel_id ID del embudo
order.funnel_title Nombre del embudo
order.paid_status Estado de pago del pedido not_paid / partial_paid / paid
order.paid_status_title Estado de pago en palabras en inglés
La lista puede ampliarse.

Disponibles al activarse los siguientes eventos:

  • Suscripción iniciada
  • Suscripción renovada
  • Pago exitoso del pedido
  • Nuevo pedido
  • Pago exitoso de la oferta
  • Reembolso del pago de la oferta
  • Acceso al producto abierto
  • Inicio del acceso por suscripción
  • Fin del acceso por suscripción

Variables de pago

Variable Valor
payment.id ID del pago
payment.price Precio del pago
payment.currency_code Moneda del pago en formato de código. Ejemplo: USD
payment.currency_symbol Moneda del pago en formato de símbolo. Ejemplo: $
payment.currency_short_title Moneda del pago en nombre abreviado. Ejemplo: usd
payment.created_at Fecha de creación del pago. Formato YYYY-MM-DD HH:mm:ss
payment.paid_at Fecha de pago. Formato YYYY-MM-DD HH:mm:ss
payment.schedule_payment_at Fecha de pago programada. Formato YYYY-MM-DD HH:mm:ss
платіж.номер Número de orden del pago en el pedido
La lista puede ampliarse.

Disponibles al activarse los siguientes eventos:

  • Pago exitoso de la oferta
  • Reembolso del pago de la oferta

Variables de oferta

Variable Valor
offer.id ID de la oferta
offer.title Nombre de la oferta
La lista puede ampliarse.

Disponibles al activarse los siguientes eventos:

  • Pago exitoso de la oferta
  • Reembolso del pago de la oferta
  • Oferta gratuita aceptada
  • Suscripción iniciada
  • Suscripción renovada
  • Pago exitoso del pedido
  • Nuevo pedido
  • Acceso al producto abierto
  • Inicio del acceso por suscripción
  • Fin del acceso por suscripción

Variables de suscripción a producto

Variable Valor
subscription.id ID de suscripción del producto
subscription.start_at Fecha de inicio de la suscripción. YYYY-MM-DD HH:mm:ss
subscription.end_at Fecha final de término de la suscripción. YYYY-MM-DD HH:mm:ss
subscription.order_end_at Fecha de término de la suscripción, considerando solo los pagos realizados. YYYY-MM-DD HH:mm:ss
subscription.paid_at Fecha del primer pago de la suscripción. YYYY-MM-DD HH:mm:ss
La lista puede ampliarse.

Disponibles al activarse los siguientes eventos:

  • Acceso al producto abierto
  • Inicio del acceso por suscripción
  • Fin del acceso por suscripción

Variables de intento de cuestionario

Variable Valor
quiz_attempt.id ID del intento
quiz_attempt.number_version Número de versión del intento
quiz_attempt.quiz_id ID del quiz
quiz_attempt.course_id ID del curso
quiz_attempt.course_lesson_id ID de la lección
quiz_attempt.status_id ID del estado
quiz_attempt.status Estado en texto
quiz_attempt.scores Puntos obtenidos
quiz_attempt.created_at Inicio del intento. Formato YYYY-MM-DD HH:mm:ss
quiz_attempt.finished_at Fin del intento. Formato YYYY-MM-DD HH:mm:ss
quiz_attempt.count_questions Cantidad de preguntas en el quiz
quiz_attempt.count_questions_incorrect Cantidad de preguntas respondidas incorrectamente
quiz_attempt.count_questions_correct Cantidad de preguntas respondidas correctamente
quiz.title Nombre del quiz
La lista puede ampliarse.

Disponibles al activarse los siguientes eventos:

  • Realización del quiz
  • Anulación del resultado anterior del quiz
  • El quiz cambió de estado

Variables de lección

Variable Valor
lesson.id ID de la lección
lesson.title Nombre de la lección
La lista puede ampliarse.

Disponibles al activarse los siguientes eventos:

  • Realización del quiz
  • Anulación del resultado anterior del quiz
  • El quiz cambió de estado
  • Comenzó a ver la lección
  • Vio la lección
  • Acceso a la lección abierto
  • Práctica en la lección completada