Problemas comunes
Soluciones frecuentes para operadores e integradores
Guía de troubleshooting orientada al cliente final y al integrador. Sigue los pasos en orden; la mayoría de incidencias se resuelven sin escalar a soporte de plataforma.
Antes de escalar, revisa Limitaciones actuales y el Changelog — puede que la función esté planeada pero aún no desplegada en tu tenant.
Acceso al dashboard
No recibo el correo de invitación
- Revisa spam y filtros corporativos.
- Pide al administrador que confirme el correo capturado en Configuración → Usuarios.
- Si el toast dice “creado pero no enviado”, reintenta o usa otro correo — el enlace puede regenerarse.
Entro pero no veo menús (Dispositivos, Uso, Integraciones)
| Causa probable | Solución |
|---|---|
| Rol insuficiente | Necesitas client_admin, integrator_admin o equivalente |
| Nodo activo incorrecto | Cierra sesión y elige la empresa correcta al entrar |
| Endpoint no habilitado en tu entorno | Algunas pantallas muestran error 501 — contacta a tu integrador |
Tengo varias empresas y veo datos de otra
Cambia el nodo activo desde el selector de tenant en la barra superior. Cada request usa ese contexto; hermanos en el árbol nunca comparten flota.
“No tienes permisos” al escribir al agente
- Tu número debe estar registrado en tu usuario por un
client_admin. - Ruta: Configuración → Usuarios → [tu usuario] → WhatsApp.
- Usa el mismo número desde el que escribes (incluye lada país).
El agente no encuentra mi unidad
- Prueba con código exacto, placa o IMEI — evita abreviaturas ambiguas.
- Confirma que la unidad pertenece a tu empresa en el árbol.
- Si eres dueño de carga, solo verás unidades asignadas a tu mercancía.
Respuestas desactualizadas
Horizon muestra la última posición recibida por ingestión. Si el dato es viejo en WhatsApp, casi siempre también lo está en tu plataforma GPS original — no es un retraso del chat.
GPS sin señal o sin posiciones en Horizon
Horizon no consulta directamente al hardware. El flujo es:
Proveedor GPS → Meridian Gateway → HorizonRevisa en cadena:
1. ¿Hay posición en el incumbent?
Abre WebMaps, Wialon, RedGPS u otra plataforma que ya uses. Si ahí tampoco hay señal, el problema es de dispositivo, SIM o cobertura — Horizon no puede inventar coordenadas.
2. ¿Está bien configurada la integración?
Configuración → Integraciones
- Estado activo y sync reciente.
- Credenciales del proveedor vigentes (token expirado es frecuente).
- Cliente (
end_client) correcto en la integración.
Ejecuta Sincronizar ahora tras dar de alta unidades nuevas en el GPS original.
3. ¿Coincide el IMEI?
En Dispositivos, busca el IMEI reportado por el proveedor. Debe existir y estar asignado a la unidad correcta. Conflictos cross-tenant aparecen como errores en la sync.
4. ¿Vigente el token de ingestión?
Configuración → API — token no revocado y copiado en Meridian Gateway. Tras rotación, actualiza ambos lados el mismo día.
Alertas
No llegan alertas al WhatsApp
- Confirma reglas en Alertas → Configuración y severidades en Configuración → Severidades.
- Revisa preferencias de notificación del usuario.
- Verifica que la unidad esté en línea y generando eventos en el proveedor.
Recibo demasiadas alertas
Ajusta umbrales, geocercas o consolidación con tu client_admin. El agente puede ayudarte a consultar alertas recientes, pero la política se configura en dashboard.
Consumo y facturación
No veo la pantalla Uso
Solo roles administrativos y de integrador tienen acceso. Operadores de piso usan WhatsApp; el consumo lo revisa quien administra contrato.
El costo subió sin más unidades
Revisa el desglose por métrica en Uso: consultas al bot, alertas evaluadas y viajes monitoreados generan overage independiente del parque. Picos de consultas masivas en WhatsApp son la causa más común.
Cuándo escalar
| Síntoma | Escala a |
|---|---|
| Un cliente no ve su flota tras sync correcta | integrator_admin |
| Varios clientes sin ingestión simultánea | Soporte plataforma Horizon |
| Error 500 persistente en dashboard | Soporte plataforma con hora UTC y captura |
| Dudas de contrato o overage | billing_owner de tu subtree |
Detalle de canales en Contacto.
Funcionalidad no disponible
Si tu equipo espera una capacidad que no aparece en el dashboard o en WhatsApp:
- Consulta Limitaciones actuales.
- Revisa Próximas capacidades para ver si está en el roadmap.
- Confirma con tu integrador si forma parte de tu contrato v1.