Notificaciones
Cómo recibir alertas y eventos de viaje por WhatsApp y Telegram
Horizon entrega información por WhatsApp y Telegram según tu rol, tus preferencias y los protocolos configurados. Esta guía cubre las preferencias de eventos de viaje; las alertas GPS críticas también pueden llegar por protocolos y por el agente conversacional.
Preferencias de notificación
Ruta: Agente → Notificaciones (/agent/notifications)
La pantalla muestra una matriz de entrega: cada fila es un tipo de evento y cada columna un canal (WhatsApp, Telegram).
Eventos configurables
| Evento | Descripción |
|---|---|
| Sin movimiento | Unidad detenida fuera del comportamiento esperado |
| ETA vencida | El viaje rebasó su hora estimada de llegada |
| Check-in pendiente | Seguimiento programado que requiere confirmación |
| Viaje asignado | Nueva asignación operativa para la unidad |
| Asignación actualizada | Cambio de operador o supervisor responsable |
| Viaje iniciado | Inicio confirmado de un viaje monitoreado |
| Viaje completado | Cierre de viaje y entrega terminada |
| Emergencia | Evento crítico de viaje; puede omitir horarios silenciosos |
| Cerca del destino | La unidad entró al radio configurado del destino |
Canales
| Canal | Uso |
|---|---|
| Canal principal de Horizon para operadores y contactos autorizados | |
| Telegram | Paridad funcional; requiere chat_id registrado por tu integrador |
Cada celda tiene un interruptor Activo / Pausado. Por defecto los eventos llegan activos (opt-in implícito) hasta que guardes una preferencia explícita.
Horarios silenciosos (quiet-hours)
Si ya tenías quiet-hours configurados, se conservan al activar o desactivar un evento. La matriz muestra el rango horario cuando existe (por ejemplo, 22:00-06:00 America/Mexico_City).
Los eventos de Emergencia pueden omitir quiet-hours según la política del backend — no dependas del silencio nocturno para ignorar emergencias reales.
Alertas GPS por WhatsApp
Además de la matriz de viajes, las alertas críticas pueden llegarte por:
- Protocolos de respuesta — nodo de acción Notificar con canal WhatsApp, Telegram o voz.
- Agente conversacional — consultas como "¿Hubo alertas hoy en ECO-101?".
- Push proactivo — para contactos con alcance restringido (dueños de carga vinculados por número autorizado).
Los contactos con alcance limitado solo reciben alertas de su flotilla o unidades asignadas, no de toda la empresa.
Tipos que suelen notificarse de inmediato
| Tipo | Motivo |
|---|---|
| Botón de pánico / SOS | Emergencia humana |
| Manipulación / desconexión | Posible robo, sabotaje o unidad sin señal |
| Remolque detectado | Riesgo de hurto del vehículo |
La severidad personalizada en Configurar no cambia si un protocolo se dispara, pero sí la prioridad visual en dashboard y chat.
Canales en protocolos vs preferencias personales
| Mecanismo | Alcance | Quién configura |
|---|---|---|
| Preferencias de notificación | Eventos de viaje para tu usuario | Cada operador en /agent/notifications |
| Nodo Notificar en protocolo | Alertas GPS que coinciden con el disparador | Administrador de cliente en /agent/protocols |
| Identidad de mensajería | Vinculación del número o chat a una membresía | Administrador de cliente al invitar usuarios |
Los protocolos usan canales de notificación al usuario (whatsapp, telegram, voice). El SMS queda reservado para comandos al dispositivo GPS, no para nodos de notificación de protocolo.
Buenas prácticas
- Activa Emergencia en al menos un canal si operas viajes monitoreados.
- Configura quiet-hours solo para eventos informativos (viaje completado, cerca del destino).
- Coordina con tu integrador la vinculación del número antes de esperar mensajes.
- Para dueños de carga, confirma el filtro de unidades — solo ven su mercancía.
Más contexto del agente en WhatsApp y Alertas por WhatsApp.