Producto SaaS • GPS • WhatsApp
Cuentas Espejo GPS: Comparte tu Flota por WhatsApp sin Revelar Credenciales
Cómo construimos Cuentas Espejo GPS: una PWA respaldada por API Mirror Accounts que usa API Converse como canal de conversación para compartir seguimiento GPS desde WhatsApp o Telegram sin revelar credenciales. Compatible con Atlantida, Geotrucks y Zeekgps.
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.
Sin cuentas espejo
- Compartir usuario y contraseña de la cuenta principal
- El cliente ve toda la flota, no solo su vehículo
- Actualizaciones manuales que consumen tiempo operativo
- No hay forma de revocar el acceso fácilmente
Con cuentas espejo
- Enlace temporal y acotado a un solo vehículo
- Las credenciales originales nunca se comparten
- El cliente ve el seguimiento en tiempo real solo
- El acceso expira automáticamente
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.
Flujo completo en WhatsApp — menos de 2 minutos:
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
Gestiona el flujo conversacional en WhatsApp y Telegram. Recibe mensajes, ejecuta el FSM y delega acciones a API Mirror Accounts.
API Mirror Accounts
Lógica de negocio: crea cuentas espejo, valida vehículos en el GPS, emite tokens JWT y gestiona la expiración.
Integración GPS
Capa interna de API Mirror Accounts. Adaptadores para Atlantida, Geotrucks y Zeekgps con interfaz uniforme.
PWA de seguimiento
Interfaz optimizada para móvil. Consulta API Mirror Accounts con el token del enlace y muestra la posición en tiempo real.
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.
Atlantida
Integración completa con la plataforma Atlantida GPS
Geotrucks
Compatible con flotas que operan en Geotrucks
Zeekgps
Soporte para clientes de la plataforma Zeekgps
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.
Características de la PWA
- Mapa en tiempo real con actualización automática
- Diseño mobile-first responsive
- Acceso protegido por token con expiración
- Branding personalizado por empresa
- Sin necesidad de instalar app
- Funciona en iOS y Android
Próximamente
- ETA automático al destino configurado
- Panel web de administración de cuentas activas
El mapa se refresca solo cada 30 segundos —el TTL del caché de posiciones— sin 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.
Configurar alerta periódica desde el chatbot:
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
Diferencias entre APIs de proveedores GPS
Atlantida, Geotrucks y Zeekgps tienen formatos de respuesta, autenticación y límites de rate completamente distintos.
Solución: API Mirror Accounts implementa una capa de adaptadores con interfaz común (nombre del vehículo → {lat, lng, speed, timestamp}). Cada adaptador maneja los detalles de su proveedor. Ni el chatbot ni la PWA conocen estas diferencias.
Actualización del mapa sin sobrecargar la API GPS
Si la PWA consulta al proveedor GPS cada 5 segundos por cada sesión activa, el sistema se bloquea rápidamente por los rate limits de las plataformas GPS.
Solución: Caché de posiciones en API Mirror Accounts con TTL corto (30s). Múltiples sesiones del mismo vehículo comparten la misma consulta al GPS. La PWA consulta el caché de API Mirror Accounts, no el GPS directamente.
Alertas a WhatsApp sin sesión activa
WhatsApp Business API solo permite enviar mensajes activos a usuarios que hayan iniciado conversación previamente con el bot.
Solución: El chatbot valida este requisito antes de confirmar la activación de alertas. Si el destinatario no ha iniciado conversación, el bot lo indica y proporciona instrucciones claras.
Preguntas Frecuentes
¿Qué ve exactamente el cliente al que le comparto el enlace?
Solo el vehículo que le compartiste, con su posición en tiempo real sobre el mapa. No ve el resto de la flota, no entra a la plataforma GPS y nunca recibe usuario ni contraseña de la cuenta principal: el enlace lleva su propio token de acceso, acotado a ese vehículo.
¿Con qué plataformas GPS funciona?
Con Atlantida, Geotrucks y Zeekgps, que son las tres integraciones que ya están en producción. Cada una entra por un adaptador con interfaz común, así que sumar un proveedor nuevo es escribir su adaptador en API Mirror Accounts: ni el chatbot ni la PWA de seguimiento cambian.
¿Mi cliente necesita instalar una aplicación?
No. El enlace abre una PWA en el navegador, optimizada para móvil, y funciona en iOS y Android sin instalar nada. Si el destinatario quiere, puede añadirla a su pantalla de inicio, pero no es necesario para ver la ubicación.
¿Cuánto cuesta el servicio?
Hoy se prueba gratis durante un mes, con el producto completo y sin condiciones. Al terminar ese mes la cuenta se bloquea: el bot deja de sostener la conversación y ya no se pueden crear cuentas espejo nuevas. Todavía no fijamos precio al servicio, así que si al probarlo te resulta útil, lo platicamos contigo antes de que decidas nada.
¿Cuánto dura el acceso y cómo se corta?
Tú eliges la vigencia al crear la cuenta espejo desde el chatbot: 6 horas, 24 horas o 7 días. Al vencer, el acceso se desactiva solo y la PWA muestra un mensaje claro en lugar de un error técnico. No hay nada que cancelar a mano, y puedes exigir además una contraseña de acceso al abrir el enlace.
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.
¿Tienes una flota vehicular?
Si gestionas transporte y quieres darle a tus clientes seguimiento en tiempo real sin exponer tu cuenta GPS, podemos mostrarte cómo funciona.
