Solucion de Problemas

Esta guia cubre problemas comunes que puede encontrar al usar Neotask y como resolverlos.

Licencia y Activacion

"Clave de licencia invalida"

• Verifique el formato de la clave: SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX
• Compruebe si hay espacios adicionales o caracteres faltantes
• Asegurese de tener una conexion a internet activa
• Intente volver a ingresar la clave cuidadosamente

"Licencia revocada"

• Su licencia ha sido revocada por el servidor
• Verifique su estado de facturacion en neotask.ai
• Contacte soporte si cree que es un error

"Licencia expirada"

• Su suscripcion ha caducado
• Renueve su plan a traves del portal de facturacion
• La aplicacion entra en modo de solo lectura cuando expira

"Periodo de gracia offline expirado"

• Ha estado sin conexion por mas de 72 horas
• Conectese a internet para revalidacion automatica
• La aplicacion reanudara su operacion normal una vez conectada

"Version bloqueada"

• Su version de la aplicacion ha sido bloqueada por razones de seguridad
• Actualice a la ultima version inmediatamente
• La actualizacion automatica deberia solicitarselo; si no, descargue desde el sitio web

Problemas del Gateway

"El gateway no pudo iniciarse"

1. Verifique si el puerto 18789 esta disponible (no usado por otra aplicacion)
2. Intente reiniciar la aplicacion
3. Verifique la salud del gateway desde el panel
4. Si esta en macOS, asegurese de que la aplicacion tenga los permisos necesarios en Preferencias del Sistema -> Privacidad y Seguridad

"Bloqueo de 3 intentos"

• Despues de 3 fallos consecutivos del gateway, las operaciones se bloquean
• Reinicie la aplicacion para restablecer el contador de bloqueo
• Si persiste, revise los logs para el error subyacente

"Gateway desconectado"

• El runtime local perdio la conexion
• Haga clic en "Reconectar" en el panel del gateway
• Si sigue desconectandose, reinicie la aplicacion
• Verifique que ningun firewall este bloqueando conexiones localhost

Problemas de Voz

"No se detecto entrada de audio"

• Otorgue permiso de microfono:
  • macOS: Preferencias del Sistema -> Privacidad y Seguridad -> Microfono -> Habilitar para Neotask
  • Windows: Ajustes -> Privacidad -> Microfono -> Permitir acceso a las aplicaciones
• Verifique que su microfono no este silenciado
• Confirme que el dispositivo de entrada correcto este seleccionado en los ajustes del sistema

"La palabra de activacion no se activa"

1. Asegurese de que la activacion por voz este habilitada en Ajustes
2. Verifique que el modo de activacion este configurado en "Porcupine" (no "Atajo" u "Desactivado")
3. Diga la frase de activacion claramente: "Hey Neotask"
4. Intente el atajo de teclado en su lugar (Cmd+Shift+Space / Ctrl+Shift+Space)
5. Verifique si otra aplicacion esta usando el microfono

"Audio TTS entrecortado o retrasado"

• Verifique su conexion a internet (TTS requiere la API de ElevenLabs)
• ElevenLabs puede estar experimentando limites de tasa
• Intente una voz diferente desde Ajustes
• Reduzca la actividad de red en segundo plano

"Atajo de voz no funciona"

• Otra aplicacion puede haber reclamado el mismo atajo
• Cambie el atajo en Ajustes -> Activacion -> Atajo de Teclado
• En macOS, verifique Preferencias del Sistema -> Teclado -> Atajos para conflictos

Conexion y Red

"No se puede conectar al servidor"

• Verifique su conexion a internet
• Compruebe si neotask.ai es accesible en su navegador
• Si esta detras de un firewall corporativo, asegurese de que el trafico HTTPS este permitido
• Intente desactivar la VPN temporalmente

"Solicitud API fallida"

• Verifique su conexion a internet
• Confirme que su licencia esta activa
• Si usa BYOK, compruebe que su clave API sea valida y tenga creditos
• Intente actualizar el panel

Agentes y Sesiones

"No se puede crear agente: limite alcanzado"

• El numero de agentes no esta limitado por plan; la creacion de agentes personalizados requiere un plan de pago
• Si ve esto en el plan Free, actualice a un plan de pago para crear agentes personalizados
• Elimine agentes no utilizados para mantener ordenado su espacio de trabajo

"Agente no responde"

• Verifique la salud del gateway (debe estar ejecutandose)
• Confirme que el modelo del agente sea accesible (clave API valida, proveedor disponible)
• Verifique el presupuesto diario, porque si se excede, los agentes se pausan hasta medianoche UTC
• Intente reiniciar la sesion

"Los mensajes de la sesion no cargan"

• Actualice la pagina/aplicacion
• Verifique el estado de conexion del gateway
• Si la sesion es muy larga, intente crear una nueva sesion

Facturacion y Pagos

"Pago fallido"

• Verifique que los datos de su tarjeta sean correctos
• Consulte con su banco si hay bloqueos en transacciones internacionales
• Intente un metodo de pago diferente
• Contacte soporte si el problema persiste

"Asignacion de uso excedida"

• El consumo de tokens de su agente ha excedido la asignacion incluida en su suscripcion
• El uso adicional se factura a tarifas de uso. Consulte la pagina de Uso en su panel para detalles.
• Cambie al modo BYOK (use sus propias claves API) para dirigir los costos de tokens directamente a su proveedor
• Establezca limites de presupuesto diario para prevenir excedentes inesperados

"Plan no actualizado despues del pago"

• Los webhooks de Stripe pueden tener un ligero retraso (generalmente menos de 1 minuto)
• Actualice el panel
• Si aun no se ha actualizado despues de 5 minutos, contacte soporte con su confirmacion de pago

Rendimiento

"Aplicacion lenta al iniciar"

• La validacion de licencia y el inicio del gateway ocurren al lanzar, y esto es normal
• Asegurese de que su sistema cumpla con los requisitos minimos
• Cierre aplicaciones en segundo plano innecesarias

"Alto uso de CPU"

• Si usa la palabra de activacion siempre activa (Porcupine), usa CPU minima pero puede deshabilitarse
• Pause las sesiones de voz cuando no esten en uso
• Verifique si hay procesos del gateway atascados en Monitor de Actividad / Administrador de Tareas

"Alto uso de memoria"

• Las sesiones de chat largas acumulan memoria
• Cree nuevas sesiones periodicamente
• Reinicie la aplicacion para limpiar el estado acumulado

Obtener Ayuda

• Documentacion: Esta aqui. Explore la base de conocimiento.
• Soporte: Visite la pagina de Soporte en neotask.ai/support
• Contacto: Use el formulario de contacto en el sitio web
• Estado: Verifique el estado del servicio en neotask.ai