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.

Jun 26, 2026

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 $trigger sale 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.timezone siempre 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 06 en vez de 6, usa las variantes con sufijo _padded (por ejemplo {{$now.hour_padded}}).

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp