Variables en workflows: personaliza cada mensaje con {{datos}}

Un mensaje que dice "Hola" convierte peor que uno que dice "Hola, Ana, vimos tu pedido #4821". La diferencia son las variables en workflows: pequenos marcadores como {{$contact.first_name}} que Omnifox reemplaza en tiempo de ejecucion por el dato real de cada contacto. En esta guia vas a ver que variables existen, como se insertan en los nodos y como encadenar la salida de un nodo con el siguiente para armar automatizaciones que se sienten escritas a mano.

Que es una variable y donde se usa

Una variable es un texto entre dobles llaves que el motor sustituye justo antes de enviar. La regla de oro de Omnifox: si la variable no existe o esta vacia, se reemplaza por cadena vacia y el mensaje no se rompe. Eso te deja escribir plantillas sin miedo a que aparezca un null feo.

Las variables funcionan en casi cualquier nodo que acepte texto: Enviar mensaje, Hacer pregunta, Enviar plantilla de WhatsApp, Enviar email al cliente, Anadir nota interna, Notificar al equipo por email y tambien en Actualizar contacto o Definir variable.

Las familias de variables

Omnifox agrupa las variables por origen. Estas son las que vas a usar todos los dias:

• Contacto: {{$contact.first_name}}, {{$contact.last_name}}, {{$contact.email}}, {{$contact.phone}}, {{$contact.company}}, {{$contact.tags}}.
• Conversacion: {{$conversation.status}}, {{$conversation.channel_name}}, {{$conversation.assignee}} (agente asignado) y {{$conversation.summary}}, que es un resumen generado por IA de la charla.
• Mensaje: {{$message.text}}, {{$message.type}}, {{$message.media_url}}.
• Llamada (si tienes el plan de llamadas): {{$call.from}}, {{$call.direction}}, {{$call.duration}}, {{$call.recording_url}}.
• IVR: {{$ivr.digit}} y {{$ivr.option_label}}.
• Deal / disparador: {{$trigger.title}}, {{$trigger.amount}}, {{$trigger.stage_name}} cuando el workflow arranca por un evento de CRM.

Un flujo real de bienvenida personalizada

Veamos como se combinan en un workflow concreto. El objetivo: saludar al primer mensaje usando el nombre y el canal.

1. Trigger Mensaje recibido con el filtro solo primero activado, para que dispare unicamente en el primer contacto.
2. Nodo Enviar mensaje con el texto: Hola {{$contact.first_name}}, gracias por escribirnos por {{$conversation.channel_name}}. En un momento te atendemos. Si el contacto todavia no tiene nombre cargado, {{$contact.first_name}} queda vacio y el saludo simplemente dice "Hola,".
3. Nodo Anadir etiqueta para marcarlo como lead nuevo.
4. Nodo Transferir a un agente para que un humano continue.

El orden queda: Mensaje recibido (solo primero) -> Enviar mensaje -> Anadir etiqueta -> Transferir a un agente.

Encadenar la salida de un nodo con {{steps.last}}

Aqui esta la parte potente. Algunos nodos producen un dato al ejecutarse, y ese dato queda disponible para los nodos que vienen despues. El caso tipico es {{steps.last.created_item_id}}: cuando un nodo Crear elemento (o Crear tarjeta desde la conversacion) crea un registro, deja el ID del elemento recien creado, y un nodo posterior lo puede reutilizar.

Ejemplo de un workflow de soporte que abre un ticket en un tablero y avisa al cliente con el numero:

1. Trigger Etiqueta anadida (por ejemplo la etiqueta "reclamo").
2. Nodo Crear elemento en el tablero de Soporte, usando {{$contact.first_name}} en el titulo.
3. Nodo Enviar mensaje: Abrimos tu caso con el numero {{steps.last.created_item_id}}. Te avisamos por aqui cuando avance.

El flujo: Etiqueta anadida -> Crear elemento -> Enviar mensaje. El segundo mensaje toma el ID que dejo el nodo anterior. Este patron sirve para cualquier cosa que genere un identificador: crear una oportunidad, una tarea o una tarjeta.

Definir tus propias variables

Cuando necesitas un valor calculado o quieres guardar algo para mas adelante, usa el nodo Definir variable. Por ejemplo, guardar el canal de origen en una variable propia al principio del flujo y reutilizarla en varios mensajes, o combinar {{$contact.first_name}} con un texto fijo para un saludo que uses en varios nodos. Tambien puedes capturar lo que respondio el cliente con Hacer pregunta y guardarlo para un nodo posterior.

Errores comunes que conviene evitar

• Escribir la variable con un espacio de mas, como {{ $contact.first_name }}, cuando el nombre correcto no lleva espacios internos. Copia siempre desde el selector de variables del editor para no equivocarte.
• Suponer que una variable de llamada existe en un flujo de chat: {{$call.duration}} solo tiene valor si el workflow arranco por un evento de llamada. En un flujo de mensajeria quedara vacio.
• Depender de {{$contact.first_name}} cuando muchos contactos no tienen nombre. Como queda vacio, tu frase debe seguir teniendo sentido sin el. Escribe "Hola" y no "Estimado Sr." seguido del apellido vacio.
• Olvidar que {{$conversation.summary}} lo genera la IA y puede tardar un instante; usalo cuando ya hay conversacion suficiente.

Variantes utiles

Con el mismo mecanismo puedes armar un aviso interno con contexto: un nodo Notificar al equipo por email que incluya {{$contact.phone}}, {{$conversation.channel_name}} y {{$conversation.summary}} para que el agente entre a la conversacion sabiendo de que va sin abrirla. O una confirmacion de cierre con Enviar mensaje que mencione {{$conversation.assignee}} para que el cliente sepa quien lo atendio.

En Omnifox el selector de variables aparece al escribir {{ dentro de cualquier campo de texto del editor de workflows, asi que no necesitas memorizar los nombres. Arranca por tu mensaje de bienvenida, agrega una variable y mira como cada contacto recibe algo distinto. Cuando lo domines, encadena la salida de un nodo con {{steps.last}} y tus automatizaciones daran un salto de calidad. Crea tu primer workflow con variables en Omnifox.