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 ativa com a internet
• Tente digitar a chave novamente 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 acreditar que e um erro

"Licenca expirada"

• Sua assinatura expirou
• Renove seu plano pelo portal de cobranca
• O aplicativo 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 aplicativo retomara a operacao normal uma vez conectado

"Versao bloqueada"

• Sua versao do aplicativo foi bloqueada por motivos de seguranca
• Atualize para a versao mais recente imediatamente
• A atualizacao automatica deve solicitar; se nao, baixe do site

Problemas do Gateway

"Gateway falhou ao iniciar"

1. Verifique se a porta 18789 esta disponivel (nao usada por outro aplicativo)
2. Tente reiniciar o aplicativo
3. Verifique a saude do gateway pelo painel
4. Se estiver no macOS, certifique-se de que o aplicativo tem as permissoes necessarias em Preferencias do Sistema -> Privacidade e Seguranca

"Bloqueio de 3 tentativas"

• Apos 3 falhas consecutivas do gateway, as operacoes sao bloqueadas
• Reinicie o aplicativo 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 aplicativo
• 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 -> Ativar 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 funciona"

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

"Audio TTS entrecortado ou atrasado"

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

"Atalho de voz nao funciona"

• Outro aplicativo 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 com a 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 desativar a VPN temporariamente

"Requisicao de API falhou"

• Verifique sua conexao com a internet
• Verifique se sua licenca esta ativa
• Se estiver usando BYOK, verifique se sua chave de API e valida e tem creditos
• Tente atualizar o painel

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 em execucao)
• Verifique se o modelo do agente esta acessivel (chave de API valida, provedor disponivel)
• Verifique o orcamento diario, porque se excedido, agentes sao pausados ate meia-noite UTC
• Tente redefinir a sessao

"Mensagens da sessao nao carregam"

• Atualize a pagina/aplicativo
• Verifique o status de conexao do gateway
• Se a sessao for muito longa, tente criar uma nova sessao

Cobranca e Pagamentos

"Pagamento falhou"

• Verifique se os dados 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
• Uso adicional e cobrado a taxas de uso. Verifique a pagina de Uso no seu painel para detalhes.
• Mude para o modo BYOK (use suas proprias chaves de API) para direcionar custos de tokens diretamente ao seu provedor
• Defina limites de orcamento diario para evitar excedentes inesperados

"Plano nao atualizado apos pagamento"

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

Desempenho

"Aplicativo lento ao iniciar"

• A validacao de licenca e inicializacao do gateway acontecem ao abrir, e isso e normal
• Certifique-se de que seu sistema atende aos requisitos minimos
• Feche aplicativos desnecessarios em segundo plano

"Alto uso de CPU"

• Se estiver usando a palavra de ativacao sempre ativa (Porcupine), ela usa CPU minima mas pode ser desativada
• Pause sessoes de voz quando nao estiver em uso
• 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 aplicativo 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