Variables Globales - Referencia de Variables del Sistema para ChatMaxima

Referencia de las Variables Globales de ChatMaxima (campos del sistema sys_) para personalizar bots, difusiones y respuestas automáticas con datos de contacto y sesión.

Descripción general

Las Variables Globales, también llamadas Variables del Sistema, son marcadores de posición integrados que ChatMaxima resuelve automáticamente en tiempo de ejecución. Te dan acceso a información sobre el contacto actual, la conversación, el mensaje, la plataforma y los archivos multimedia sin ninguna configuración. Cada Variable Global comienza con el prefijo sys_ y va envuelta en llaves simples, como {sys_account_contact_name}.

Usa las Variables Globales en cualquier lugar donde necesites personalizar contenido, enrutar conversaciones o pasar contexto a las integraciones: bloques del constructor de bots, plantillas de difusión, respuestas automáticas, plantillas de mensajes y cargas útiles de API o webhook.

Cómo insertar una Variable Global

En cualquier campo de entrada compatible, simplemente escribe { y aparecerá un selector que lista todas las Variables Globales y Atributos Personalizados disponibles. Selecciona el que quieras y ChatMaxima lo insertará en el formato correcto.

Haz clic en el campo donde quieres insertar la variable
Escribe una sola llave de apertura {
Elige la variable del menú desplegable que aparece
El selector inserta el token completo, por ejemplo {sys_account_contact_name}

Nota: Los nombres de las variables distinguen entre mayúsculas y minúsculas. Usa siempre llaves simples alrededor del nombre de la variable.

Variables Globales compatibles

Variable	Description
`{sys_account_contact_name}`	Nombre del contacto asociado a la sesión del chatbot
`{sys_account_contact_email}`	Dirección de correo electrónico del contacto que interactúa con el chatbot
`{sys_account_contact_mobile}`	Número de móvil asociado a la cuenta del contacto
`{sys_contact_reference_id}`	Id de referencia de la conversación actual
`{sys_current_message}`	Mensaje actual que se está procesando en un bot
`{sys_account_platform}`	Plataforma actual procesada en un bot (por ejemplo, WhatsApp, Facebook, Telegram)
`{sys_current_date_time}`	Fecha y hora actuales en el momento de la ejecución
`{sys_current_page_url}`	URL de la página web donde el chatbot está actualmente activo
`{sys_current_conversation}`	Historial completo de la conversación, incluidos los mensajes y las marcas de tiempo
`{sys_ai_intent}`	Intención detectada a partir de la consulta del usuario en los bloques MaxIA (por ejemplo, `general_query`, `human_agent`, `booking_request`)
`{sys_current_media}`	URL, tipo y nombre de archivo del archivo multimedia más reciente (imagen, video, audio, documento) subido por el usuario, como objeto JSON. Usa `{sys_current_media.url}` o `{sys_current_media.type}` para campos específicos

Variables de contacto

Estas se resuelven a datos almacenados en el perfil del contacto.

{sys_account_contact_name} es la variable más común para la personalización. Úsala en saludos, plantillas de difusión y mensajes de confirmación.
{sys_account_contact_email} y {sys_account_contact_mobile} son útiles para pasar la identidad a webhooks, sincronización con CRM y flujos de verificación.
{sys_contact_reference_id} identifica de forma única el hilo de la conversación, útil para correlacionar eventos entre sistemas.

Variables de conversación

Estas describen el mensaje actual y el historial.

{sys_current_message} contiene el texto que el usuario acaba de enviar. Úsalo para reflejar la entrada de vuelta, registrarla o pasarla a un bloque de API.
{sys_current_conversation} contiene el historial completo del chat con marcas de tiempo, útil para la resumir con IA o el contexto de transferencia.

Variables de canal y contexto

{sys_account_platform} te permite ramificar la lógica por canal, por ejemplo enviando un mensaje diferente en WhatsApp que en el Widget Web.
{sys_current_page_url} captura dónde estaba el visitante en tu sitio cuando comenzó a chatear. Útil para enrutamiento o analítica.
{sys_current_date_time} marca el momento de la ejecución, útil para las marcas de tiempo en tickets o sistemas posteriores.

Variables de IA y multimedia

{sys_ai_intent} es completada por los bloques MaxIA después de la detección de intención. Ramifica tu bot en función de si el usuario quiere human_agent, booking_request, general_query, etc.
{sys_current_media} es un objeto JSON que describe el archivo más reciente que envió el usuario. Accede a campos individuales con notación de punto:

{sys_current_media.url}
{sys_current_media.type}
{sys_current_media.filename}

Variables Globales frente a Atributos Personalizados

ChatMaxima admite dos tipos de marcadores de posición dinámicos. Ambos aparecen en el mismo selector {.

	Variables Globales	Atributos Personalizados
Prefijo	`sys_`	Ninguno (tú eliges el nombre)
Creado por	ChatMaxima (integrado)	Tú, en la configuración de Contactos
Ejemplos	`{sys_account_contact_name}`, `{sys_current_message}`	`{company_name}`, `{order_id}`, `{plan_type}`
Origen del valor	Sesión, perfil de contacto, mensaje o contexto de la plataforma	Almacenado en cada contacto, completado manualmente, por importación CSV, por bloque del bot o por API
Úsalo cuando	El dato es algo que ChatMaxima ya conoce	El dato es específico de la lógica de tu negocio

Dónde usar las Variables Globales

Las Variables Globales funcionan en toda la plataforma dondequiera que esté disponible el selector {:

Bloques del Constructor de Bots: Enviar Mensaje, Enviar Correo, Bloque de API, Bloque de Webhook, Bloque Condicional, Bloque de Establecer Atributo y la mayoría de los demás bloques aceptan variables en sus campos de texto y parámetros.
Plantillas de difusión: Asigna los marcadores de posición de plantillas aprobadas de WhatsApp ({{1}}, {{2}}) a Variables Globales al crear una difusión.
Respuestas automáticas y respuestas predefinidas: Personaliza los mensajes de ausencia y las respuestas guardadas.
Indicaciones de IA de la Base de Conocimiento: Pasa el contexto de la sesión a la indicación del sistema de tu agente de IA.
Webhooks e integraciones: Incluye variables en las URL, encabezados y cuerpos de solicitud de los webhooks para reenviar contexto a sistemas externos.

Ejemplos de casos de uso

Personalizar una difusión de WhatsApp

Plantilla aprobada:

Hello {{1}}, your order {{2}} has been confirmed.

En el compositor de difusión, asigna {{1}} a {sys_account_contact_name} y {{2}} a tu atributo personalizado {order_id}. Cada destinatario recibe un mensaje como "Hello Priya, your order ORD-1042 has been confirmed."

Saludar por el nombre en un bot

Coloca un bloque de Enviar Mensaje al inicio de tu flujo con:

Hi {sys_account_contact_name}, how can we help you today?

Si el contacto no tiene un nombre registrado, el marcador de posición se resuelve como vacío, así que añade una rama de respaldo cuando sea necesario.

Enrutar por intención de IA

Usa {sys_ai_intent} en un Bloque Condicional después de un bloque MaxIA:

Si {sys_ai_intent} es igual a human_agent, enruta al chat en vivo
Si {sys_ai_intent} es igual a booking_request, salta a tu flujo de reservas
De lo contrario, continúa con el flujo de preguntas frecuentes

Pasar contexto a un webhook

En el cuerpo de un Bloque de Webhook:

{
  "name": "{sys_account_contact_name}",
  "phone": "{sys_account_contact_mobile}",
  "message": "{sys_current_message}",
  "platform": "{sys_account_platform}",
  "page": "{sys_current_page_url}"
}

ChatMaxima reemplaza cada variable con el valor en vivo antes de enviar la solicitud.

Reenviar un archivo subido a tu backend

Si un usuario envía una imagen y necesitas guardarla en el servidor, usa:

{
  "file_url": "{sys_current_media.url}",
  "file_type": "{sys_current_media.type}",
  "file_name": "{sys_current_media.filename}"
}

Mejores prácticas

Valida los datos de tus contactos: Si una Variable Global como {sys_account_contact_mobile} falta para un contacto, el marcador de posición se resuelve como vacío. Limpia los datos de tus contactos antes de difundir.
Combina con Atributos Personalizados: Usa las Variables Globales para los datos de identidad y de sesión, y los Atributos Personalizados para los campos específicos del negocio como números de pedido, tipos de plan o fechas de cita.
Prueba antes de enviar: Ejecuta una difusión o sesión de bot de prueba con tu propio registro de contacto para confirmar que todas las variables se resuelven correctamente.
Usa la notación de punto para variables JSON: {sys_current_media} devuelve un objeto JSON. Accede siempre a campos específicos como {sys_current_media.url} en lugar de usar el objeto completo en texto plano.
Evita codificar valores fijos: Donde de otro modo escribirías el nombre, móvil o correo de un contacto, usa una Variable Global en su lugar.

Solución de problemas

La variable se muestra como texto literal en la salida

Comprueba que la variable esté envuelta en llaves simples, no dobles: {sys_account_contact_name} es correcto, {{sys_account_contact_name}} no lo es (las llaves dobles son la sintaxis de marcador de posición de plantillas de Meta, usada solo dentro de plantillas aprobadas de WhatsApp).
Confirma que la ortografía coincide exactamente con el selector. Las variables distinguen entre mayúsculas y minúsculas.
Asegúrate de estar usando la variable en un campo compatible. Algunos campos de texto plano fuera de los editores de bots, difusiones y plantillas no analizan las variables.

La variable se resuelve como vacía

Comprueba que los datos subyacentes existen en el perfil del contacto (por ejemplo, que el contacto realmente tenga un nombre o móvil guardado).
Para {sys_ai_intent}, confirma que un bloque MaxIA se ejecutó antes del punto donde se usa la variable.
Para {sys_current_media}, confirma que el usuario ha enviado archivos multimedia en esta sesión.

Necesitas un valor que ChatMaxima no expone

Si el valor que necesitas no está en la lista de Variables Globales, crea un Atributo Personalizado y complétalo a través del perfil del contacto, una importación CSV, una llamada a la API o un bloque de bot de Establecer Atributo.