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.

Jun 26, 2026

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

  1. Abre Automatizaciones en el menú lateral y entra a tu workflow.
  2. En la barra superior del editor pulsa el botón Variables.
  3. Se abre un panel a la derecha con las tres secciones. Usa el buscador para filtrar por nombre.
  4. 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

  1. Inserta el token en un campo (por ejemplo, un mensaje de prueba: Hola {{$contact.first_name}}).
  2. Pulsa Probar en la barra superior y lanza una ejecución.
  3. 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_name inline. 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

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp