Artículos:
- Control de acceso
- Cómo deshabilitar el inicio de sesión a través de redes sociales
- Cómo establecer el logo (vista previa) de tu proyecto para mensajeros
- Cambio del nombre del proyecto (cabinete) y otros ajustes públicos
- Agregar tu oferta a la plataforma Kwiga
- Cómo conectar un proyecto adicional
- Cómo establecer un idioma específico para una página en Kwiga
- Notificaciones recibidas por los estudiantes
- Cambio de contraseña y configuración de acceso
- Cambio de información personal
- Configuración del remitente y dirección de respuesta
- Ajustes importantes
- Cómo eliminar una cuenta de usuario
- Página de presentación del proyecto (escuela)
- Cómo vincular tu propio dominio o subdominio
- Uso de variables en el proyecto, lista de variables disponibles
- Conexión de un dominio (subdominio) personalizado para el envío de correos electrónicos
- Cómo agregar información pública del proyecto y canales de contacto
- Configuración del perfil del estudiante
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)
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 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
¿No encontró la respuesta? Póngase en contacto con el servicio de soporte a través de chat en línea or Telegram