Cuentas Espejo: Comparte tu Flota por WhatsApp sin Revelar tus Credenciales

Las empresas de transporte enfrentan un problema cotidiano: el cliente quiere saber dónde está su carga, pero compartir las credenciales de la plataforma GPS es un riesgo de seguridad. La solución obvia —crear usuarios de solo lectura— suele ser cara o directamente no existe en los planes básicos de los proveedores GPS de la región.

Cuentas Espejo GPS resuelve exactamente ese problema. Es un sistema compuesto por dos APIs y una PWA: API Converse gestiona el flujo conversacional en WhatsApp y Telegram, mientras que API Mirror Accounts es quien ejecuta la lógica de negocio —crear la cuenta espejo, validar el vehículo en el GPS, emitir el token de acceso y gestionar la expiración.

1. El Problema Real del Transporte

Cuando una empresa de transporte tiene 10 clientes activos con envíos simultáneos, el volumen de mensajes con la pregunta "¿dónde está mi camión?" es insostenible. El operador abre la plataforma GPS, busca el vehículo, toma un screenshot o copia el enlace, y lo manda por WhatsApp. Eso multiplica por 10 el trabajo operativo para cada actualización.

La alternativa —darle acceso directo al cliente— implica compartir usuario y contraseña de la cuenta principal, lo que expone toda la flota, no solo el vehículo de ese cliente. Con proveedores como Atlantida, Geotrucks o Zeekgps, no siempre existe la opción de crear usuarios de vista parcial en planes estándar.

2. La Solución: Una Cuenta Espejo por Chatbot

El flujo completo ocurre dentro de WhatsApp o Telegram. El operador de la empresa de transporte inicia una conversación con el chatbot, indica qué vehículo quiere compartir, y en segundos recibe un enlace único. Ese enlace abre la PWA de seguimiento con acceso únicamente a ese vehículo, sin credenciales de la cuenta principal.

Operador → Bot: "Crear cuenta espejo para RXD-482"
Bot → Operador: "¿Por cuánto tiempo? (6h / 24h / 7 días)"
Operador → Bot: "24h"
Bot → Operador: "¿Requiere contraseña de acceso?"
Operador → Bot: "No"
Bot → Operador: ✅ Cuenta creada
                 🔗 https://tu-empresa.com/v/abc123
                 ⏰ Válida hasta: mañana 14:30 hrs
                 📍 Vehículo: RXD-482

El enlace generado apunta a la PWA donde el destinatario puede ver la ubicación en tiempo real. La cuenta espejo se desactiva automáticamente al vencer el tiempo configurado. No hay nada que cancelar manualmente.

3. Arquitectura: Capas del Sistema

El sistema tiene cuatro capas bien diferenciadas que se comunican entre sí pero que pueden escalar de forma independiente:

API Converse recibe el mensaje del transportista, administra el flujo conversacional (qué preguntar, qué validar, cuándo responder) y delega la acción concreta a API Mirror Accounts. Es API Mirror Accounts quien crea la cuenta espejo, valida el vehículo contra el proveedor GPS, genera el token de acceso y gestiona la expiración. La PWA solo habla con API Mirror Accounts para obtener la posición; nunca interactúa con API Converse ni con el proveedor GPS directamente.

4. Integración con Proveedores GPS

Cada proveedor GPS tiene su propia API o protocolo de acceso. API Mirror Accounts abstrae esas diferencias detrás de una interfaz uniforme: dado un identificador de vehículo, devuelve latitud, longitud, velocidad y timestamp de la última lectura. API Converse no conoce los detalles de ningún proveedor GPS.

Agregar soporte para un nuevo proveedor requiere implementar un adaptador en API Mirror Accounts que cumpla la interfaz. Ni el chatbot ni la PWA saben qué proveedor usa cada cliente: eso es responsabilidad exclusiva de API Mirror Accounts, que selecciona el adaptador correcto al momento de configurar la cuenta de la empresa.

5. La PWA de Seguimiento

La interfaz que ve el cliente final es una Progressive Web App construida con Quasar Framework. Está optimizada para móvil —que es desde donde el destinatario suele abrir el enlace— y carga rápido incluso con conexiones lentas.

El mapa se actualiza automáticamente cada cierto intervalo sin necesidad de recargar la página. Si la cuenta espejo ya venció, la PWA muestra un mensaje claro en lugar de un error técnico.

6. Alertas Automáticas de Ubicación

Además del enlace de seguimiento, la plataforma permite programar notificaciones periódicas de ubicación al número del destinatario. Esto es especialmente útil cuando el cliente no quiere estar pendiente del mapa sino simplemente recibir actualizaciones cada cierto tiempo.

Operador → Bot: "Activar alertas para cuenta abc123"
Bot → Operador: "¿Cada cuánto tiempo? (30min / 1h / 2h)"
Operador → Bot: "1h"
Bot → Operador: "¿A qué número de WhatsApp?"
Operador → Bot: "+52 55 1234 5678"
Bot → Operador: ✅ Alertas activadas
                 📨 El destinatario recibirá la ubicación
                    de RXD-482 cada hora hasta mañana 14:30

7. Retos Técnicos Resueltos

8. Estado Actual y Próximos Pasos

El producto está en desarrollo activo. La versión actual soporta los tres proveedores GPS mencionados, permite crear y gestionar cuentas espejo desde el chatbot, y la PWA de seguimiento está funcional en móvil y escritorio.

Lo que viene en las próximas iteraciones incluye el cálculo automático de ETA a destino y un panel web de administración para que las empresas puedan ver todas las cuentas espejo activas sin usar el chatbot. El chatbot seguirá siendo el canal principal para crear cuentas desde el campo.