Qué son las variables y su sintaxis ({{$...}})
Las variables reemplazan marcadores como {{$contact.first_name}} por valores reales al ejecutarse el workflow. Aprende la sintaxis y cómo insertarlas.
Mira este paso en el video · Variables
Qué es y cuándo sirve
Una variable es un marcador de posición que el workflow reemplaza por un valor real en el momento de ejecutarse. En lugar de escribir un nombre fijo, escribes {{$contact.first_name}} y, al correr el workflow, Omnifox lo cambia por el nombre del contacto. Así un mismo mensaje sirve para todos.
Sirven para personalizar mensajes y correos, armar el cuerpo de una petición HTTP a otro sistema, o tomar decisiones en una condición.
La sintaxis: {{$...}}
La forma recomendada es encerrar el nombre entre dobles llaves con un signo $:
{{$contact.first_name}}
Omnifox también acepta otras dos formas equivalentes:
- Sin el signo
$:{{contact.first_name}} - En línea, sin llaves:
$contact.first_name(seguido de un espacio o signo de puntuación)
Importante: si una variable está vacía (por ejemplo un contacto sin apellido) o no existe, se reemplaza por texto vacío. Nunca verás el
{{...}}crudo en el mensaje enviado.
Dónde se pueden usar
Puedes escribir variables en casi cualquier campo de texto de los nodos de acción:
- El texto de un mensaje (Enviar mensaje).
- El asunto y el cuerpo de un correo (Enviar correo).
- El cuerpo y los encabezados de una petición HTTP (HTTP request).
- El título de una tarea, una nota interna, etc.
Pasos para insertar una variable
- Abre el workflow desde Automatizaciones y selecciona un nodo de acción.
- Abre el panel Variables del editor.
- Busca la variable que quieres (por ejemplo
contact.first_name). - Toca Copiar: se copia el token
{{$contact.first_name}}. - Pégalo dentro del campo de texto, donde quieras que aparezca el valor.
Crear tus propias variables
Además de las que vienen por defecto, puedes definir las tuyas con el nodo Definir variable (set variable). Cada asignación tiene:
- nombre — sin el
$, por ejemplointentos. - valor — un texto fijo o que a su vez use otras variables.
- operación —
set(asignar),append(concatenar) oincrement(sumar, ideal para contadores de reintentos).
Después la referencias más abajo en el flujo como {{$intentos}}.
Verificación
Usa el botón de prueba (Test run) del editor con un contacto real y abre la línea de tiempo: vas a ver el mensaje ya con los valores reemplazados. Si ves el token sin reemplazar es que el nombre no coincide.
Si no funciona
- Sale el texto vacío donde esperabas un valor: ese campo del contacto está vacío, o escribiste mal el nombre de la variable.
- Aparece
{{$algo}}literal en el mensaje: revisa las llaves (deben ser dobles) y el nombre exacto; copia la variable desde el panel Variables para evitar errores de tipeo. - Una variable propia sale vacía: asegúrate de que el nodo Definir variable se ejecute antes del nodo que la usa.
Tips
- Copia siempre las variables desde el panel Variables; así evitas errores de nombre.
- Para contar reintentos usa
increment: empieza en vacío y suma 1 en cada vuelta.
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.