Solucao de Problemas

Este guia cobre problemas comuns que voce pode encontrar ao usar o Neotask e como resolve-los.

Licenca e Ativacao

"Chave de licenca invalida"

Verifique o formato da chave: SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX
Verifique se ha espacos extras ou caracteres faltando
Certifique-se de que voce tem uma conexao de internet ativa
Tente reinserir a chave com cuidado

"Licenca revogada"

Sua licenca foi revogada pelo servidor
Verifique seu status de cobranca em neotask.ai
Entre em contato com o suporte se voce acredita que isso e um erro

"Licenca expirada"

Sua assinatura venceu
Renove seu plano pelo portal de cobranca
O app entra em modo somente leitura quando expirado

"Periodo de graca offline expirado"

Voce ficou offline por mais de 72 horas
Conecte-se a internet para revalidacao automatica
O app retomara a operacao normal uma vez conectado

"Versao bloqueada"

Sua versao do app foi bloqueada por razoes de seguranca
Atualize para a versao mais recente imediatamente
A atualizacao automatica deve solicita-lo; caso contrario, baixe do site

Problemas do Gateway

"Falha ao iniciar o gateway"

Verifique se a porta 18789 esta disponivel (nao usada por outro app)
Tente reiniciar o app
Verifique a saude do gateway pelo dashboard
Se no macOS, certifique-se de que o app tem as permissoes necessarias em Preferencias do Sistema -> Privacidade e Seguranca

"Bloqueio por 3 tentativas"

Apos 3 falhas consecutivas do gateway, as operacoes sao bloqueadas
Reinicie o app para redefinir o contador de bloqueio
Se persistir, verifique os logs para o erro subjacente

"Gateway desconectado"

O runtime local perdeu a conexao
Clique em "Reconectar" no painel do gateway
Se continuar desconectando, reinicie o app
Verifique se nenhum firewall esta bloqueando conexoes localhost

Problemas de Voz

"Nenhuma entrada de audio detectada"

Conceda permissao de microfone:
- macOS: Preferencias do Sistema -> Privacidade e Seguranca -> Microfone -> Habilitar para Neotask
- Windows: Configuracoes -> Privacidade -> Microfone -> Permitir que apps acessem
Verifique se seu microfone nao esta mudo
Verifique se o dispositivo de entrada correto esta selecionado nas configuracoes do sistema

"Palavra de ativacao nao dispara"

Certifique-se de que a ativacao por voz esta habilitada em Configuracoes
Verifique se o modo de ativacao esta definido como "Porcupine" (nao "Atalho" ou "Desligado")
Diga a frase de ativacao claramente: "Hey Neotask"
Tente o atalho de teclado em vez disso (Cmd+Shift+Space / Ctrl+Shift+Space)
Verifique se outro app esta usando o microfone

"Audio TTS entrecortado ou atrasado"

Verifique sua conexao de internet (TTS requer API do ElevenLabs)
O ElevenLabs pode estar sofrendo limitacao de taxa
Tente uma voz diferente em Configuracoes
Reduza a atividade de rede em segundo plano

"Atalho de voz nao funciona"

Outro app pode ter reivindicado o mesmo atalho
Altere o atalho em Configuracoes -> Ativacao -> Atalho de Teclado
No macOS, verifique Preferencias do Sistema -> Teclado -> Atalhos para conflitos

Conexao e Rede

"Nao e possivel conectar ao servidor"

Verifique sua conexao de internet
Verifique se neotask.ai esta acessivel no seu navegador
Se estiver atras de um firewall corporativo, certifique-se de que trafego HTTPS e permitido
Tente desabilitar VPN temporariamente

"Requisicao de API falhou"

Verifique sua conexao de internet
Verifique se sua licenca esta ativa
Se usando BYOK, verifique se sua chave de API e valida e tem creditos
Tente atualizar o dashboard

Agentes e Sessoes

"Nao e possivel criar agente: limite atingido"

O numero de agentes nao e limitado por plano; a criacao de agentes personalizados exige um plano pago
Se voce ve isso no plano Free, faca upgrade para um plano pago para criar agentes personalizados
Exclua agentes nao utilizados para manter seu espaco de trabalho organizado

"Agente nao responde"

Verifique a saude do gateway (deve estar rodando)
Verifique se o modelo do agente esta acessivel (chave de API valida, provedor disponivel)
Verifique o orcamento diario -- se excedido, agentes sao pausados ate meia-noite UTC
Tente redefinir a sessao

"Mensagens da sessao nao carregam"

Atualize a pagina/app
Verifique o status da conexao do gateway
Se a sessao e muito longa, tente criar uma nova sessao

Cobranca e Pagamentos

"Pagamento falhou"

Verifique se os detalhes do seu cartao estao corretos
Verifique com seu banco se ha bloqueios em transacoes internacionais
Tente um metodo de pagamento diferente
Entre em contato com o suporte se o problema persistir

"Alocacao de uso excedida"

O consumo de tokens do seu agente excedeu a alocacao incluida na sua assinatura
O uso adicional e cobrado a taxas de uso. Verifique a pagina de Uso no seu dashboard para detalhes.
Mude para o modo BYOK (use suas proprias chaves de API) para rotear custos de tokens diretamente ao seu provedor
Defina limites de orcamento diario para prevenir excedentes inesperados

"Plano nao atualizado apos pagamento"

Webhooks do Stripe podem ter um leve atraso (geralmente menos de 1 minuto)
Atualize o dashboard
Se ainda nao atualizado apos 5 minutos, entre em contato com o suporte com sua confirmacao de pagamento

Desempenho

"App lento na inicializacao"

Validacao de licenca e inicializacao do gateway acontecem no lancamento -- isso e normal
Certifique-se de que seu sistema atende aos requisitos minimos
Feche apps desnecessarios em segundo plano

"Alto uso de CPU"

Se usando wake word sempre ativo (Porcupine), ele usa CPU minima mas pode ser desabilitado
Pause sessoes de voz quando nao estiver usando
Verifique processos de gateway travados no Monitor de Atividade / Gerenciador de Tarefas

"Alto uso de memoria"

Sessoes de chat longas acumulam memoria
Crie novas sessoes periodicamente
Reinicie o app para limpar estado acumulado

Obtendo Ajuda

Documentacao: Voce esta aqui -- navegue pela base de conhecimento
Suporte: Visite a pagina de Suporte em neotask.ai/support
Contato: Use o formulario de contato no site
Status: Verifique o status do servico em neotask.ai