Descripción

La funcionalidad de monitoreo y alertas automáticas por desconexión física del cable de red asociada a la aplicación wolkvox_agent.

El objetivo es detectar comportamientos anómalos de conectividad que puedan afectar la operación del agente y permitir una atención oportuna por parte de supervisión o el área de TI.

Aplicación afectada

wolkvox_agent

Evento que dispara la alerta

La alerta se genera cuando el sistema detecta  desconexiones repetidas del cable de red físico en el equipo del agente durante el período de monitoreo.

🔄 Funcionamiento de la alerta por desconexión de red

El sistema monitorea continuamente el estado de la conexión de red del agente.

Cuando se registran 5 desconexiones, se envía automáticamente un correo de alerta a los usuarios previamente registrados.

Si el cable de red se vuelve a conectar:

El sistema espera 30 segundos Luego valida que el agente se registre nuevamente de forma correcta.

Si las desconexiones continúan, el contador sigue incrementando y se refleja en el mensaje de alerta.

Consulta por link de latencia

El link de latencia es una URL directa que permite visualizar un reporte TCP Delay de una operación específica. Este reporte consolida información técnica de red asociada a agentes, direcciones IP y extensiones PBX activas o recientes.

Mediante este enlace puedes validar, entre otros aspectos:

• Tiempo de respuesta de la red (latencia TCP).
• Jitter de transmisión y recepción.
• Pérdida de paquetes (TX / RX).
• Rechazos de red.
• Tipo de conexión (Ethernet o WiFi).
• Desconexiones del cable de red (solo en PC).
• Estado del agente (conectado o desconectado).

¿Cómo estructurar el Link de Latencia?

Para generar el enlace de monitoreo, debe construir la URL siguiendo esta estructura estándar, reemplazando los valores que están entre corchetes por los datos de su operación: 

Plantilla General: https://wv{SERVIDOR}.wolkvox.com/ipdialbox/latencia.php?id={OPERACIÓN} 

Explicación de los parámetros: 

• wv{SERVIDOR}: Corresponde al subdominio del servidor donde está alojada su operación. Este es el mismo prefijo que ve en la barra de direcciones cuando ingresa a wolkvox Manager o Agent en sus versiones web (ej. wv0001, wv0015, wv1002). 
• /ipdialbox/latencia.php?id=: Es la ruta fija del script de diagnóstico. Esta parte no debe modificarse. 
• {OPERACIÓN}: Debe escribir el nombre exacto de su operación tal cual como fue creada en el sistema (ej. wolkvoxstore). 
• Ejemplo completo: https://wv001.wolkvox.com/ipdialbox/latencia.php?id=wolkvoxstore

Información que muestra el reporte

Total TCP Delay by Agent

Esta sección presenta el detalle por agente, incluyendo:

• Total TCP Delay (ms): latencia acumulada.
• TX / RX Jitter: variación en el retardo de paquetes.
• TX / RX Ploss: pérdida de paquetes en envío y recepción.
• Network rejection (%): porcentaje de rechazos de red.
• Connection type: Ethernet, WiFi u otros estados detectados.
• Network cable disconnects: desconexiones físicas del cable (solo PC).
• Platform: app o web.
• Last date: última actualización del dato.

Ejemplo de mensaje de alerta

Asunto: Alerta – Desconexiones de red detectadas

Agente [Joe Doe] (ID: [12988] - OPER: [operacionx]) —
Se han detectado desconexiones de red repetidas (6)

¡Hola!
El sistema ha detectado que el Agente [Joe Doe] (ID: [12988] - OPER: [operacionx]) ha registrado 6 desconexiones de cable de red físico durante el período de monitoreo actual.

Por favor, revisa si esto es una práctica normal del agente o si existe un problema de red o hardware que requiera atención. 
En caso necesario, escala el incidente al departamento de TI.

✅ Acciones recomendadas

Validar con el agente si:

Está desconectando manualmente el cable presenta fallas físicas en el cable o puerto de red

Revisar:  Estado del cable de red, Puerto del switch o router, Configuración de red del equipo

Escalar al área de TI si el problema persiste o afecta la operación.

📝 Notas importantes

Las desconexiones frecuentes pueden generar:

• Cortes en llamadas
• Errores de registro
• Pérdida de estabilidad en la sesión del agente
• El monitoreo es automático y continuo mientras el agente esté activo.