Variables globales: contact, conversation, trigger, execution
Los datos que Omnifox inyecta en cada workflow, agrupados en $contact, $conversation, $trigger y $execution, con sus campos y ejemplos de uso.
Mira este paso en el video · Variables
Qué es y cuándo sirve
Las variables globales son los datos que Omnifox inyecta automáticamente en cada ejecución de un workflow, sin que tengas que definirlos. Vienen agrupadas por "espacios de nombre" según de qué hablan: el contacto, la conversación, el disparador y la propia ejecución. Las usas para personalizar mensajes y armar peticiones, y las encuentras listas en el panel Variables del editor.
Este artículo cubre los cuatro grupos principales: contact, conversation, trigger y execution. Recuerda la sintaxis: {{$grupo.campo}}.
$contact — el contacto
Datos de la persona con la que conversas:
{{$contact.id}}·{{$contact.first_name}}·{{$contact.last_name}}·{{$contact.display_name}}{{$contact.email}}·{{$contact.phone}}{{$contact.company}}·{{$contact.job_title}}{{$contact.city}}·{{$contact.country}}·{{$contact.language}}
Nota:
{{$contact.timezone}}existe pero hoy resuelve vacío (no hay una fuente fiable de zona horaria por contacto).
$conversation — la conversación
Datos del hilo que disparó (o que toca) el workflow:
{{$conversation.id}}·{{$conversation.status}}·{{$conversation.priority}}{{$conversation.channel_id}}·{{$conversation.channel_type}}·{{$conversation.channel_name}}{{$conversation.assignee}}(agente asignado) ·{{$conversation.assignee_team}}(equipo){{$conversation.unread_count}}·{{$conversation.last_customer_message_at}}·{{$conversation.last_agent_message_at}}
Cuando el disparador es el cierre de la conversación se suman métricas como {{$conversation.first_response_time}}, {{$conversation.resolution_time}}, {{$conversation.incoming_messages_count}} y {{$conversation.outgoing_messages_count}}.
$trigger — el disparador
Estas variables dependen del disparador que arranca el workflow: cada evento expone sus propios campos. Por eso el panel Variables muestra las del disparador que elegiste. Algunos ejemplos:
- Negocio ganado / estancado (CRM):
{{$trigger.title}},{{$trigger.amount}},{{$trigger.deal_id}},{{$trigger.days_inactive}}. - Cambio en una columna de un tablero:
{{$trigger.column_old}},{{$trigger.column_new}},{{$trigger.column_id}}. - Mención en el Team:
{{$trigger.text}},{{$trigger.by_user_name}}.
Consulta el panel para ver exactamente qué trae tu disparador antes de usarlas.
$execution — la ejecución
Identifica la corrida actual del workflow:
{{$execution.id}}— el ID de esta ejecución.
Es muy útil para correlacionar: por ejemplo, enviar workflow_execution_id: {{$execution.id}} en el cuerpo de un HTTP request para que el sistema externo sepa de qué corrida vino.
Otros grupos útiles
{{$now.hour}},{{$now.day_of_week}}(1=lunes … 7=domingo),{{$now.date}},{{$now.time}},{{$now.iso}},{{$now.is_weekend}},{{$now.is_business_hours}}.{{$user.name}},{{$user.email}}— el agente asignado.{{$workspace.name}},{{$organization.name}},{{$organization.plan}}.
Verificación
Haz una prueba (Test run) con una conversación real y revisa en la línea de tiempo el mensaje resultante: confirma que cada {{$...}} salga con su valor.
Si no funciona
- Una variable de
$triggersale vacía: ese campo no lo expone tu disparador. Abre el panel Variables y usa solo las que aparecen para ese trigger. $conversation.*sale vacío: el disparador no es de chat (por ejemplo un evento de CRM sin conversación asociada).$contact.timezonesiempre vacío: es esperado, no hay fuente de zona horaria hoy.
Tips
- Para webhooks,
{{$now.iso}}ya viene en formato ISO-8601 con Z (UTC), listo para incrustar. - Si necesitas
06en vez de6, usa las variantes con sufijo_padded(por ejemplo{{$now.hour_padded}}).
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.