Integraciones CRM/NMS

Propósito de esta página

Use esta página para elegir y configurar integraciones CRM/NMS soportadas. Use las páginas por integración para detalles específicos.

¿Necesita definiciones de términos comunes? Vea el Glosario.

La mayoría de operadores usan las integraciones incluidas. Si todavía no eligió ruta de despliegue, empiece por Quickstart.

Elegir ruta de integración

Ruta	Mejor para	Dónde deben hacerse los cambios permanentes
Integración incluida	La mayoría de operadores con sistemas soportados	CRM/NMS por jobs de integración de LibreQoS
Fuente de verdad personalizada	Operadores con sincronización propia de CRM/NMS	Archivos externos generados (`network.json`, `ShapedDevices.csv`)

Dónde en la WebUI

Comportamiento común de integración: Configuration -> Integrations
Campos por integración: Configuration -> Integrations
Validación de salud tras cambios: WebUI -> Scheduler Status y WebUI -> Urgent Issues
Validación de resultados/topología: WebUI -> Network Tree Overview y Flow Globe

Integraciones incluidas

Comportamiento importante de refresco

Cuando hay integraciones habilitadas:

La sincronización de la integración refresca los datos de topología y shaping que LibreQoS usa.
Las integraciones incluidas no usan network.json ni ShapedDevices.csv como sus archivos normales de salida.
Si trabaja en modo DIY o manual, network.json y ShapedDevices.csv siguen siendo los archivos que usted mantiene.
Las ediciones directas sobre datos gestionados por la integración pueden sobrescribirse en el siguiente ciclo.

Soporte para IDs de nodos de topología

LibreQoS soporta un campo genérico opcional "id" en los nodos de network.json. Este campo está pensado para transportar identificadores estables del sistema de integración cuando sea posible. En la versión actual, el campo es informativo y todavía no es la clave autoritativa para shaping u overrides.

Integración	Soporte de ID de nodo en `network.json`	Notas
UISP	Sí	Sitios/dispositivos reales de UISP exportan `id` genérico más la metadata existente `uisp_site` / `uisp_device`. Los nodos sintéticos de LibreQoS usan IDs generados estables.
Splynx	Sí	Los nodos de topología de network sites y AP/site exportan `id` genérico.
Sonar	Sí	Los nodos de topología de sitios y AP exportan `id` genérico.
Netzur	Parcial	Se exporta solo cuando los datos upstream de zonas incluyen un ID de zona estable.
VISP	Parcial	Importa topología de sitio/upstream e IDs genéricos estables cuando VISP IRM tiene pobladas esas relaciones; los suscriptores sin mapeo usable siguen cayendo en adjunto plano.
Powercode	No	El importador actual no construye nodos de topología en `network.json`.
WISPGate	No	El importador actual no construye nodos de topología a partir de identificadores estables upstream.

Manejo común de velocidades de cliente

Para las integraciones incluidas que importan velocidades brutas de plan de suscriptor, LibreQoS aplica la misma regla compartida antes de escribir ShapedDevices.csv:

velocidad máxima efectiva del cliente = max(plan_rate * bandwidth_overhead_factor, plan_rate * client_bandwidth_multiplier)

Las integraciones que ya consumen velocidades efectivas de shaping conservan esos valores tal como llegan, sin volver a aplicar el multiplicador.