Variables de trigger y de nodo (resultado de acciones previas)
Aprende a usar las variables que trae el trigger y las que generan tus nodos para personalizar mensajes y acciones en tus workflows.
Mira este paso en el video · Variables
Qué son las variables en un workflow
Cada vez que un workflow se ejecuta, el motor arma un contexto con datos del evento que lo disparó (el contacto, la conversación, el canal) y va guardando los resultados de cada nodo que corre. Esos datos se llaman variables y los puedes insertar en casi cualquier campo de texto usando la sintaxis {{$nombre}}.
Hay tres orígenes de variables, y así aparecen agrupadas en el panel Variables del editor:
- Del trigger — las que el evento disparador trae consigo (datos del contacto y de la conversación).
- Del workflow — las que generan tus propios nodos al ejecutarse (resultado de acciones previas).
- Built-in — siempre disponibles, sin importar el trigger (
{{$now}},{{$today}},{{$workflow.name}}, etc.).
Abrir el panel de variables
- Abre Automatizaciones en el menú lateral y entra a tu workflow.
- En la barra superior del editor pulsa el botón Variables.
- Se abre un panel a la derecha con las tres secciones. Usa el buscador para filtrar por nombre.
- Pulsa Copiar en cualquier variable para llevar el token
{{$variable}}al portapapeles y pégalo en el campo del nodo que estés configurando.
Variables del trigger
Dependen del evento que elegiste como disparador. Los triggers de conversación exponen, entre otras:
{{$contact.first_name}},{{$contact.last_name}},{{$contact.display_name}},{{$contact.email}},{{$contact.phone}},{{$contact.company}},{{$contact.tags}}{{$conversation.id}},{{$conversation.status}},{{$conversation.channel_name}},{{$conversation.assignee}},{{$conversation.assignee_team}}
Algunos triggers añaden variables propias. Por ejemplo, Conversación cerrada expone datos del cierre, y Cierre automático por inactividad expone {{$last_responder}} y {{$days_inactive}}. El panel siempre muestra exactamente las que aplican al trigger seleccionado, con una breve descripción de cada una.
Variables de nodo (resultado de acciones previas)
Estas se van creando a medida que añades nodos. Las más comunes:
- Set variable — cada fila de asignación crea una variable con el nombre que escribes.
- Ask question (preguntar al cliente) — guarda la respuesta en la variable que indicas en Guardar en variable.
- HTTP request — guarda la respuesta de la API (como JSON) en la variable que definas.
- Loop — dentro del bucle expone
{{$_index}}(posición) y{{$_item}}(elemento actual).
Un nodo solo puede leer variables de nodos que se ejecutaron antes que él en el flujo. Por eso el orden importa: si quieres usar la respuesta de un Ask question en un Send message, el mensaje debe ir después de la pregunta.
Verificar que una variable se resuelve
- Inserta el token en un campo (por ejemplo, un mensaje de prueba:
Hola {{$contact.first_name}}). - Pulsa Probar en la barra superior y lanza una ejecución.
- Abre el panel Timeline al pie del lienzo y revisa el resultado del nodo: verás el texto ya con la variable reemplazada.
Si no funciona
- El mensaje muestra el texto literal
{{$...}}: el nombre no coincide con ninguna variable disponible. Cópialo siempre desde el panel Variables para evitar erratas. - La variable sale vacía: el campo de origen no tenía valor (por ejemplo un contacto sin apellido). El motor reemplaza los valores nulos por texto vacío, no por el token.
- No aparece la variable de un nodo: confirma que ese nodo está conectado antes en el flujo y que guardaste el workflow.
Consejo: puedes escribir el token en tres formatos equivalentes —
{{$contact.first_name}},{{contact.first_name}}o$contact.first_nameinline. Usa siempre el primero para mayor claridad.
Consejo: los nombres distinguen entre datos del contacto (
contact.*) y de la conversación (conversation.*). Si un dato existe en ambos, prefiere el más específico al contexto de tu flujo.
Artículos relacionados
Artículos relacionados
-
Catálogo de disparadores (triggers) de los workflows
Conoce los eventos que pueden iniciar un workflow automáticamente en Omnifox.
-
Crear tu primera automatizacion (workflow)
Los workflows de Omnifox automatizan tu operacion: un disparador inicia la automatizacion y los nodos de accion hacen el trabajo. Crea un mensaje de bienvenida en minutos.
-
Guía completa de los flujos de trabajo (Workflows)
Los Workflows a fondo, en 54 capítulos: disparadores, nodos, variables, probar, historial, plantillas, importar y exportar, con cada opción explicada y un flujo real de punta a punta.
-
Nodos de acción disponibles en los workflows
Descubre las acciones que un workflow puede ejecutar de forma automática.
-
Condiciones y ramificaciones (si/entonces) en un workflow
Haz que tus flujos tomen decisiones y sigan caminos distintos según los datos de cada contacto.