Introducción

Las funciones remotas de Level (control remoto, terminal, servicios, procesos, etc.) utilizan una conexión basada en WebRTC entre tu navegador y el dispositivo de destino. Cuando esa conexión no puede ser directa, recurre a servidores de retransmisión. Si las sesiones remotas son lentas, no logran conectarse o ves «conectando...» indefinidamente, esta guía te ayuda a identificar dónde está el problema.

Cómo Level establece las conexiones remotas

Level intenta conectarse en este orden, deteniéndose en cuanto uno tiene éxito:

P2P directo — tu navegador se conecta directamente al dispositivo. La menor latencia, sin intermediarios.
STUN — usa global.stun.twilio.com para atravesar NAT y descubrir una ruta directa.
TURN sobre UDP (puerto 3478) — el tráfico se retransmite a través de global.turn.twilio.com.
TURN sobre TCP (puerto 3478) — la misma retransmisión, TCP en lugar de UDP para cortafuegos más estrictos.
TURN sobre TLS (puerto 5349) — último recurso; retransmisión cifrada para los entornos más restrictivos.

Todas las conexiones se inician de forma saliente tanto desde el navegador como desde el agente. No deberías necesitar reglas de cortafuegos entrantes.

ℹ️ NOTA: Las conexiones de retransmisión (TURN) añaden latencia en comparación con P2P. Si estás usando retransmisión de forma constante, la sesión funcionará pero puede sentirse más lenta. El objetivo de esta guía es llevarte a P2P o al menos confirmar que la retransmisión está funcionando correctamente.

Prueba tu conexión

Prueba de red de Twilio

Ejecuta esto desde el navegador en la máquina que usas para acceder a Level (el lado del técnico, no el endpoint): Prueba de red de Twilio

Esto comprueba si tu navegador puede llegar a los servidores STUN y TURN que usa Level. Si las pruebas de TURN fallan aquí, las sesiones remotas fallarán o se agotarán desde tu ubicación.

Prueba Trickle ICE

La herramienta Trickle ICE comprueba si se pueden reunir candidatos ICE válidos para una conexión WebRTC: Trickle ICE

Usa estos valores:

Servidor STUN: stun:global.stun.twilio.com:3478
Servidor TURN: turn:global.turn.twilio.com:3478

Si no aparecen candidatos srflx candidatos aparecen, STUN está bloqueado. Si no aparecen candidatos relay candidatos aparecen, TURN está bloqueado. Cualquiera de los dos resultados significa que se necesitan cambios en el cortafuegos del lado del técnico.

Causas comunes y soluciones

Las sesiones remotas no logran conectarse en absoluto:

El navegador del lado del técnico no puede llegar a los servidores TURN. Ejecuta la prueba de red de Twilio desde tu navegador para confirmarlo. Si falla, tu red corporativa o VPN puede estar bloqueando UDP 3478 o TCP 3478 saliente.
La red del lado del agente está bloqueando lo mismo. Revisa los requisitos de red en Solución de problemas sin conexión y confirma que el dispositivo puede llegar a global.turn.twilio.com saliente en el puerto 3478.

Las sesiones remotas se conectan pero son lentas o se desconectan con frecuencia:

La conexión está en modo retransmisión (TURN) en lugar de P2P. Esto es esperable en redes con NAT o cortafuegos muy estrictos. La retransmisión añade latencia de ida y vuelta; si ambos lados tienen acceso a internet, la retransmisión TURN debería seguir siendo utilizable.
Comprueba si hay pérdida de paquetes entre el agente y global.turn.twilio.com usando un traceroute o ping.

Las sesiones funcionan desde algunas redes pero no desde otras:

El problema es específico de la configuración del cortafuegos de esa red. Usa Trickle ICE desde esa red para confirmar qué candidatos están bloqueados.

Acceso de red requerido

Para que las conexiones remotas funcionen, tanto tu navegador como el dispositivo de destino necesitan acceso saliente a:

Endpoint	Puerto	Protocolo	Propósito
`global.stun.twilio.com`	3478	UDP	STUN — traversal de NAT
`global.turn.twilio.com`	3478	TCP & UDP	Retransmisión TURN
`global.turn.twilio.com`	5349	TCP	TURN TLS (último recurso)

💡 CONSEJO: Comienza con UDP 3478 saliente. La mayoría de las redes que necesitan TURN pueden usarlo en UDP 3478 sin abrir nada más. Solo pasa a TCP 3478 o 5349 si UDP está bloqueado.

Cómo verificar si una sesión es P2P o de retransmisión

Level muestra el tipo de conexión directamente en la interfaz — no se necesita captura de paquetes.

Control remoto — busca el indicador de conexión en la parte superior izquierda de la barra de herramientas de la sesión. Muestra P2P o Relay.
Gestión en segundo plano (Terminal, Explorador de archivos, Procesos, Servicios) — busca el indicador en la parte superior derecha de la barra de herramientas de la sesión. Muestra Conectado: P2P o Conectado: Relay.

Pasa el cursor sobre el indicador para ver qué lado está en retransmisión — indicará si el problema está del lado del técnico (tu navegador), del lado del dispositivo (el agente) o en ambos. Eso te dirá exactamente dónde enfocar la investigación de red.

Preguntas frecuentes

El control remoto se conecta pero se siente lento. ¿Es un problema de retransmisión? Podría serlo, pero hay muchos factores que afectan el rendimiento de la sesión. Empieza revisando el indicador de conexión — si muestra P2P, el tipo de conexión no es el problema y algo más está causando la lentitud. Si muestra Relay, pasa el cursor sobre el indicador para ver qué lado está en retransmisión y luego revisa los requisitos de red para ese lado.
La prueba de red de Twilio pasa pero las sesiones remotas siguen fallando. La prueba se ejecuta desde tu navegador. El lado del dispositivo también necesita acceso saliente a los mismos endpoints TURN. Ejecuta --check en el dispositivo (consulta Solución de problemas del agente) y busca fallos relacionados con TURN. Si el dispositivo está en una red más restrictiva que tu navegador, puede que no pueda llegar a global.turn.twilio.com.
¿Necesito abrir puertos de cortafuegos entrantes para el acceso remoto de Level? No. Todas las conexiones se originan de forma saliente tanto desde el navegador como desde el agente. No necesitas reglas entrantes.
El indicador dice Relay. ¿Cómo consigo que funcione P2P? Pasa el cursor sobre el indicador primero — te dirá qué lado está en retransmisión. Si es el lado del dispositivo, comprueba que el dispositivo puede llegar a global.stun.twilio.com y global.turn.twilio.com saliente en UDP 3478. Si es del lado del técnico (tu navegador), ejecuta la prueba de red de Twilio desde esa red. Si ambos lados muestran retransmisión, comprueba ambos. En entornos muy restringidos (filtrado de salida estricto, NAT de grado operador), la retransmisión puede ser simplemente el modo permanente — las sesiones seguirán funcionando, solo con latencia adicional.

Solución de problemas de Relay/P2P