Conceptos básicos

Antes de usar el agente por WhatsApp, conviene alinear el vocabulario. Horizon usa los mismos términos que ya conoces en operación de flotillas, con algunas definiciones propias de la plataforma.

Unidad

Una unidad es un vehículo equipado con dispositivo GPS. En conversación con el agente, "unidad", "camión", "tracto" o "vehículo" suelen referirse a lo mismo.

Cada unidad pertenece a una flotilla (agrupación por geografía, ruta o tipo de vehículo) y a una empresa (end_client) en el árbol de organizaciones.

Identificadores de unidad

Para consultar una unidad por WhatsApp, puedes usar cualquiera de estos identificadores:

Identificador	Ejemplo	Cuándo usarlo
Código de unidad	`ECO-101`, `GTI`, `CAM-01`	El nombre operativo que usa tu despacho
Placa	`ABC-123`, `XYZ99A`	Cuando el operador piensa en placas
IMEI	`359000000000001`	Soporte técnico o diagnóstico del dispositivo

El agente resuelve la referencia con coincidencia exacta primero (nombre, placa o IMEI). Si hay ambigüedad — por ejemplo, varias unidades que contienen "ECO" — te pedirá el nombre o placa exacta antes de compartir datos operativos.

Estados de una unidad

Horizon sintetiza el estado a partir de la última posición y telemetría recibida del proveedor GPS:

Estado	Significado
En línea (online)	El dispositivo reportó recientemente (típicamente en los últimos minutos)
Sin reportar (offline)	No hay posición nueva; puede deberse a cobertura, batería baja o GPS apagado
En movimiento	Velocidad por encima del umbral de detención
Detenido	Velocidad cercana a cero con ignición encendida o apagada

Una unidad sin reportar más de cinco minutos es un evento operativo relevante. Horizon puede notificarte automáticamente cuando se cumpla esa condición.

Próximamente: reglas personalizadas del tipo "avísame de todas las unidades con más de cinco minutos sin reportar" con vigencia temporal y expiración automática.

Telemetría

Además de la ubicación, cada reporte GPS puede incluir:

Campo	Descripción
Velocidad	km/h en el momento del reporte
Dirección	Rumbo o sentido de marcha
Ignición	Encendida o apagada
Batería	Nivel de batería del dispositivo GPS (no del vehículo)
GSM	Intensidad de señal celular
Satélites	Cantidad de satélites visibles para el fix

Pregunta por telemetría en lenguaje natural:

¿A qué velocidad va ECO-101?

¿Tiene ignición encendida el GTI?

El agente responde con el estado consolidado de la unidad, no con un panel de sensores.

Viaje

Un viaje es el recorrido asignado de una unidad entre origen y destino. En el piloto actual, un viaje pasa por tres estados:

Asignado (AWAITING_START) — creado pero aún no inicia.
En tránsito (IN_TRANSIT) — la unidad reportó movimiento y el viaje quedó activo.
Completado (COMPLETED) — el operador o conductor confirma la llegada.

Puedes consultar viajes activos por WhatsApp o, si tu rol lo permite, crear uno adjuntando un documento PDF con los datos del recorrido.

Próximamente: estados intermedios como cerca del destino, en estancia o emergencia, con notificaciones automáticas por geocerca.

Alerta

Una alerta es un evento generado por el dispositivo GPS o por una regla de Horizon: botón de pánico, desconexión, exceso de velocidad, entrada o salida de geocerca, etc.

Las alertas críticas que Horizon notifica automáticamente por WhatsApp incluyen:

Botón de pánico — emergencia desde la unidad.
Desconexión — pérdida de señal del dispositivo.
Sin reportar — más de cinco minutos sin posición nueva.

También puedes consultar alertas recientes de forma activa:

¿Qué alertas tuvo ECO-101 hoy?

Empresa y tenancy

Horizon es multi-tenant: varias organizaciones comparten la plataforma con aislamiento total de datos.

El modelo es un árbol de organizaciones:

Distribuidor (ej. Lutrillo)
  └── Integrador (ej. Ooz)
        ├── Cliente final (ej. Capricornio)
        │     ├── Flotilla Monterrey-Norte
        │     │     ├── ECO-101
        │     │     └── ECO-102
        │     └── Flotilla Sonora
        └── Cliente final (ej. Quantum)

Reglas clave:

Cada nodo ve a todos sus descendientes; los hermanos no se ven entre sí.
Los clientes finales (end_client) tienen vista operativa detallada: flota, GPS, alertas, bitácora.
Los niveles superiores (integrador, distribuidor) ven métricas agregadas — cantidad de flotillas, alertas procesadas, uso del agente — no el detalle GPS unidad por unidad.

Tu usuario de WhatsApp está asociado a un nodo del árbol (típicamente un end_client). El agente filtra automáticamente las consultas a las unidades de tu alcance, sin que tengas que indicar la empresa en cada mensaje.

Dueño de carga (`cargo_owner`)

Algunos clientes del transportista — por ejemplo, gerentes de Elektra o Colgate — no son transportistas; son dueños de carga. Solo interactúan por WhatsApp (sin dashboard) y consultan únicamente las unidades que transportan su mercancía.

Glosario rápido

Término	Significado
Bitácora	Registro de viajes y eventos; segmentable por sub-cliente
Comandos a la programación	Instrucciones al agente para configurar reglas masivas con expiración
Proveedor GPS / incumbent	WebMaps, Wialon, RedGPS — la plataforma que ya usas
Tractocamión	Vehículo pesado; el ETA puede calcularse con perfil distinto al de un auto
Zona conflictiva	Geografía de alto riesgo; candidata a geocerca con alerta automática

Siguiente paso

Entra a la guía de WhatsApp para ver cómo aplicar estos conceptos en conversaciones reales.

On this page