Comandos de seguridad

Algunas acciones sobre el dispositivo GPS son sensibles: pueden inmovilizar un vehículo en ruta o reiniciar el rastreador. Horizon las protege con permisos de rol y, para las más críticas, aprobación de un supervisor.

Tipos de comando

Comando	Efecto	¿Requiere aprobación?
Paro de motor (`engine_off`)	Inmoviliza el vehículo (si el dispositivo lo soporta)	Sí — supervisor
Encendido de motor (`engine_on`)	Libera inmovilización previa	Sí — supervisor
Reinicio GPS (`reset`)	Reinicia el módulo rastreador; no corta el motor	No — envío directo con permiso

Importante: el reinicio (reset) solo reinicia el dispositivo GPS. No es lo mismo que el paro de motor. Horizon distingue ambos explícitamente.

Cómo solicitar un comando

Escribe en lenguaje natural:

Apaga el motor de ECO-101

Reinicia el GPS de CAM-01

Desbloquea el motor de ABC-123

El agente identifica la unidad, verifica que tengas permiso (devices:command) y determina el tipo de comando.

Flujo de aprobación de supervisor

Los comandos de paro y encendido de motor requieren un segundo humano autorizado. No se ejecutan con un solo mensaje.

Paso a paso

1. Operador escribe: "Apaga el motor de ECO-101"
2. El agente crea una solicitud de aprobación (vigencia: 15 minutos por defecto)
3. El agente responde al operador:
   "Solicitud enviada. Espera aprobación de un supervisor."
4. Los supervisores de tu organización reciben notificación
   (WhatsApp, push en dashboard o correo si no responden en 5 minutos)
5. Un supervisor aprueba o rechaza
6. Si se aprueba: el comando se envía al dispositivo vía SMS
7. El operador recibe confirmación del resultado

Aprobación por WhatsApp

Un supervisor puede responder en el mismo chat o en un hilo vinculado:

Supervisor: sí

Supervisor: no, el vehículo está en zona segura

El sistema valida que el supervisor no sea la misma persona que solicitó el comando (no auto-aprobación).

Si no hay supervisor configurado

Si tu organización no tiene al menos un usuario con rol supervisor, la solicitud falla de inmediato:

No hay supervisor configurado para aprobar este comando.
Contacta a tu administrador.

Reinicio GPS (sin aprobación)

El reinicio del rastreador es un comando no destructivo: reinicia el módulo GPS para recuperar señal. Si tienes permiso, el agente lo envía directamente:

Usuario: Reinicia el GPS de CAM-01
Agente: Comando de reinicio enviado a CAM-01.
        El dispositivo debería reconectarse en 2-5 minutos.

Condiciones para el envío directo:

Tu rol incluye permiso devices:command.
La unidad tiene un dispositivo activo con SIM.
El dispositivo tiene contraseña configurada (requerida por el catálogo de comandos).

Si falta la contraseña del dispositivo, el comando queda en cuarentena y no se envía.

Dispositivo sin plantilla de comando

Si el dispositivo es compatible con comandos pero Horizon no tiene la plantilla SMS para ese modelo, el agente pide el comando exacto:

Agente: Puedo enviar un comando a ECO-101, pero necesito el SMS exacto
        para este modelo. Escríbelo en tu siguiente mensaje.
Usuario: reset123456
Agente: Solicitud registrada. Espera aprobación de un supervisor.

Los comandos capturados manualmente siempre requieren aprobación de supervisor, aunque sean reinicios.

Quién puede solicitar y quién puede aprobar

Acción	Rol requerido
Solicitar paro / reinicio	Operador con `devices:command`
Aprobar o rechazar	`client_supervisor` (supervisor)
Consultar ubicación / estado	Operador, supervisor o cliente final (según alcance)

Los dueños de carga y clientes finales de consulta no pueden ejecutar comandos remotos.

Seguridad y auditoría

El cuerpo del SMS y la contraseña del dispositivo nunca aparecen en el chat ni en logs visibles.
Cada solicitud, aprobación y envío queda en la bitácora de auditoría.
Las solicitudes no respondidas expiran automáticamente (15 minutos por defecto).
Un supervisor no puede aprobar su propia solicitud.

Disponibilidad

Los comandos sensibles requieren que tu tenant tenga la funcionalidad activada y los permisos correspondientes. Si solicitas paro de motor y el agente indica que no puede ejecutarlo, confirma con tu administrador que tu rol y alcance lo permiten.

El reinicio directo (reset) y la captura de comandos SMS personalizados están disponibles para tenants con la funcionalidad activada.

Ejemplo completo (flujo futuro)

Operador: Apaga el motor de ECO-101, está en zona de riesgo

Agente: Solicitud de paro de motor para ECO-101 enviada.
        Espera aprobación de un supervisor. Vigencia: 15 minutos.

Supervisor (por WhatsApp): sí

Agente (al operador): Comando aprobado y enviado a ECO-101.
        El supervisor Juan García autorizó la acción a las 14:35.

Siguiente paso

Consulta Ejemplos de conversación para ver diálogos completos que incluyen comandos y alertas.

On this page