🔧 Troubleshooting — síntomas, diagnóstico y solución
Tabla de los problemas más frecuentes con causa raíz y comando para validar.
1. Estación no sube online en el dashboard
| Verificá | Cómo | Si falla |
|---|---|---|
| Ping a IP NovaMic | ping 198.51.100.X | Tu Internet está caído o la IP está mal copiada. |
| UDP saliente permitido | nc -u -v ip-novamic 5004 | Firewall corporativo bloquea UDP. Hablá con IT. |
| Token correcto | Revisá email de bienvenida | Regenerá desde el dashboard. |
| Codec / latency soportados | Manual de tu interface | Usá Standard (Opus 320 / 120ms) que es universal. |
2. Audio sale pero con cortes / dropouts
Síntoma típico: la voz «pixela» cada 5-15 segundos como mensajero de WhatsApp con mala señal.
| Causa probable | Verificación | Acción |
|---|---|---|
| Jitter alto | mtr -c 50 ip-novamic | Subí latency a 200ms en la interface. |
| Ancho de banda compartido | speedtest cuando hay dropout | Activá QoS DSCP EF en tu router. |
| Wi-Fi en el path | Trazá el cable | Pasá a ethernet cableado entre interface y router. |
| Pérdida de paquetes ISP | ping -c 1000 ip-novamic | Reportá al ISP. Si persiste >0.5% considerá backup ISP. |
3. Latencia perceptible (delay incómodo en aire)
Síntoma: el reportero o estación remota responde con retraso > 200ms y la conversación pierde fluidez.
- Verificá tu tier: si estás en Standard (objetivo ≤150ms) y necesitás conversación en vivo, cambiá a Ultra (objetivo ≤100ms).
- Bajá el buffer/latency de la interface al mínimo estable (80-100 ms).
- Validá que tu región esté optimizada: dashboard → estación → región asignada. Si la IP NovaMic no es la regional óptima, escribinos.
- Cable directo a router (sin Wi-Fi, sin powerline adapters).
4. Audio metálico / con eco
- Verificá nivel: si entra saturado (>-3 dBFS) el codec introduce artefactos. Mantené -12 a -6 dBFS pico.
- Si hay eco en la mesa receptora, alguien tiene mic abierto + monitor en el mismo bus → loop. Mute mic del lado que solo escucha.
- Codec Opus a <128 kbps suena «artificial» con música. Usá 320+ para emisión musical (default en Standard).
5. Reportero web (browser) no entra al stream
- Browser debe ser Chrome, Edge o Firefox últimas 2 versiones. Safari iOS tiene limitaciones WebRTC documentadas.
- TURN bloqueado por firewall: el reportero está en red corporativa que filtra UDP 3478. Pedile que pruebe con datos móviles.
- Click en «Allow microphone» del browser. Si negó la primera vez, hay que ir a permisos del sitio y resetear.
Cuándo escalarnos un caso
Si seguiste los pasos y no resolviste en 30 minutos: respondé el email de bienvenida con (1) el problema observable, (2) qué probaste, (3) capturas del dashboard / logs de la interface. Te respondemos en <24h hábiles.