Cómo se conecta
Checklist de alto nivel para integrar tu plataforma GPS con Horizon
Esta guía describe el flujo de conexión desde la perspectiva del integrador o administrador técnico. No cubre detalles internos de implementación — solo lo necesario para que datos del GPS incumbent aparezcan en Horizon y en WhatsApp.
Requisitos previos
Antes de empezar, confirma:
- Existe un nodo
end_clienten el árbol para la flota a conectar. - Tienes rol
integrator_admin(o permisos equivalentes) en ese subtree. - Dispones de credenciales válidas del proveedor GPS (usuario, token API o clave según la plataforma).
- Meridian Gateway está desplegado y puede alcanzar tanto al proveedor como a Horizon.
Paso 1 — Crear la integración en Horizon
Dashboard → Configuración → Integraciones → Nueva integración
| Campo | Qué capturar |
|---|---|
| Cliente | El end_client dueño de la flota |
| Proveedor | Wialon, RedGPS u otro disponible en el selector |
| Etiqueta | Nombre reconocible (Capricornio Wialon prod) |
| Zona horaria | Horario operativo del cliente |
| Credenciales | Datos que Meridian usará contra el incumbent |
Al guardar, Horizon registra la integración. Si el flujo lo requiere, copia el webhook de alertas que Meridian configurará en el proveedor.
Paso 2 — Emitir token de ingestión
Dashboard → Configuración → API → Crear credencial
- Nombra el token (
Meridian Capricornio). - Copia el valor una sola vez.
- Pégalo en la configuración de Meridian Gateway como bearer hacia Horizon.
Horizon emite el token; el integrador lo configura en el webservice externo. Rotación: crea el nuevo, actualiza Meridian, revoca el anterior.
Paso 3 — Sincronizar flota
En el detalle de la integración:
- Pulsa Sincronizar ahora (sync manual).
- Espera estado completado y revisa errores por IMEI duplicado o unidad sin mapeo.
- Verifica en Dispositivos que los IMEI importados coinciden con el incumbent.
Programa syncs periódicos según acuerdo operativo cuando agregues unidades en el GPS original.
Paso 4 — Validar ingestión en vivo
- Elige una unidad en movimiento en el proveedor GPS.
- Confirma posición reciente en Dispositivos o mapa de Horizon (mismo orden de magnitud de minutos).
- Prueba una consulta WhatsApp: "¿Dónde está [código de unidad]?"
Si el incumbent tiene dato fresco pero Horizon no, revisa token de ingestión y logs de Meridian antes de escalar a soporte de plataforma.
Paso 5 — Operación continua
| Evento | Acción |
|---|---|
| Alta de unidad en GPS original | Sync de integración + verificar IMEI en Horizon |
| Cambio de token del proveedor | Actualizar credenciales en Integraciones |
| Rotación token Horizon | API → nuevo token → Meridian → revocar viejo |
| Nuevo cliente final | Integración dedicada por end_client — no compartir filas |
Lo que el cliente final NO debe hacer
- No necesita credenciales del proveedor GPS si el integrador opera el servicio.
- No migra hardware ni desinstala apps del incumbent.
- No configura Meridian directamente salvo acuerdo explícito — es infraestructura del integrador.
Problemas frecuentes de conexión
| Síntoma | Revisar |
|---|---|
| Sync OK pero sin posiciones | Token ingestión en Meridian |
| IMEI en error | Duplicado en otro tenant o typo |
| Alertas no llegan | Webhook de alertas en proveedor + reglas Horizon |
| Retraso constante | Latencia del proveedor, no “polling” de Horizon |
Más escenarios en Problemas comunes.
Ver también
- Plataformas GPS compatibles — visión general
- Credenciales — tokens API e integraciones