Credenciales

Horizon usa dos tipos de credenciales distintas. Confundirlas es la causa más común de “no llegan posiciones”. Esta guía las separa en lenguaje operativo.

Resumen rápido

Horizon no hace polling a proveedores GPS. Meridian Gateway se conecta al proveedor que ya usas y empuja lotes normalizados hacia Horizon.

1. Token de ingestión (Horizon → Meridian)

Dashboard → Configuración → API → Credenciales

Desde ahí un integrator_admin (o rol con permiso api_keys:create):

1. Crea una credencial de API con nombre descriptivo (por ejemplo, Meridian producción Ooz).
2. Copia el token en el momento de creación — solo se muestra una vez.
3. Configura ese token en el Meridian Gateway (webservice externo) como bearer de ingestión hacia Horizon.

Ese token identifica desde qué integración del árbol llegan los datos. Horizon valida cada lote entrante antes de publicarlo a tu flota.

Rotación y revocación

• Genera un token nuevo antes de revocar el anterior para evitar cortes.
• Revoca credenciales comprometidas desde la misma pantalla.
• Cada acción queda en la bitácora de auditoría.

Nota: las credenciales de Configuración → API también pueden usarse para integraciones propias (lectura de alertas, unidades, webhooks salientes). Para ingestión GPS, el caso principal es el token que Meridian presenta al recibir posiciones.

2. Integración con el proveedor GPS (Meridian → incumbent)

Dashboard → Configuración → Integraciones

Aquí el integrador registra cómo Meridian se conecta a la plataforma GPS del cliente:

1. Nueva integración y selección del cliente (end_client) dueño de la flota.
2. Elección del proveedor soportado (por ejemplo Wialon o RedGPS en el dashboard actual).
3. Captura de los campos que pide el formulario (usuario, token o clave API del incumbent — varían por proveedor).
4. Zona horaria operativa del cliente.
5. Guardado y, si aplica, copia del webhook de alertas que Meridian usará con el proveedor.

Horizon guarda la integración y metadatos de custodia; los secretos sensibles del proveedor los administra Meridian Gateway, no el dashboard de Horizon en claro.

Sincronización de flota

En el detalle de cada integración puedes:

• Ver estado y hora de la última sincronización.
• Ejecutar Sincronizar ahora para importar unidades/dispositivos nuevos.
• Revisar historial de corridas (manual, scheduled) y errores por IMEI duplicado entre tenants.

Si la sync falla, corrige credenciales del incumbent o conflictos de IMEI antes de escalar.

Flujo completo (alto nivel)

Plataforma GPS del cliente (Wialon, RedGPS, WebMaps, …)
        │
        │  Meridian Gateway lee flota y posiciones
        ▼
Meridian Gateway (webservice externo)
        │
        │  POST autenticado con token emitido por Horizon
        ▼
Horizon (ingestión → flota, alertas, agente WhatsApp)

Webhooks salientes (opcional)

En Configuración → API → Webhooks puedes suscribir URLs propias a eventos como alert.created o device.updated. Es independiente de la ingestión GPS y lo usan equipos que quieren automatizar sistemas internos.

Buenas prácticas

1. Un token de ingestión por entorno (producción / pruebas).
2. Integración por end_client — no mezcles flotas de clientes distintos en la misma fila.
3. Tras rotar token, reinicia o recarga la configuración en Meridian.
4. Verifica que el IMEI en Horizon coincida con el del proveedor después de cada sync.

Para plataformas soportadas y requisitos generales, ve Integraciones.