Um bot do Discord fica offline por um de alguns motivos previsíveis: um token redefinido, um intent privilegiado desativado, uma janela de voto expirada em um bot hospedado, ou o bot ter sido removido do servidor do qual ele depende. O gateway do Discord informa qual é com um código de fechamento; os códigos 4004 e 4013/4014 são os dois que você vai ver com mais frequência, e cada um tem uma correção específica e mecânica, em vez de um "reinicie e torça".
Comece aqui: a causa mais provável primeiro
Em ordem de frequência com que cada uma realmente acontece:
- O token foi redefinido. Alguém clicou em Redefinir Token no Portal de Desenvolvedores, de propósito ou por acidente, e o token antigo que o bot usava agora está inválido.
- Um intent privilegiado foi desativado. O Server Members Intent ou o Message Content Intent foi desligado depois que o bot já estava configurado.
- Uma janela de voto ou assinatura expirou. Em um bot hospedado como o Bot Personalizado da Noxyr, o tempo de execução está atrelado a um voto no Top.gg, e a janela somada ao seu período de tolerância acabou.
- O bot foi removido do servidor, ou um bot do qual ele depende foi removido. O Bot Personalizado depende especificamente da presença da própria Noxyr; expulsar a Noxyr interrompe o bot personalizado naquele servidor.
- Uma queda real. O próprio Discord está tendo um dia ruim. Raro, mas verifique em discordstatus.com antes de presumir que o problema está na sua configuração.
O que os códigos de fechamento do gateway realmente significam
| Código | Significado | Causa típica |
|---|---|---|
| 4004 | Falha na autenticação | O token está errado ou foi redefinido no Portal de Desenvolvedores |
| 4013 | Intent(s) inválido(s) | O código do bot solicitou um intent que não existe, ou uma combinação que o Discord rejeita |
| 4014 | Intent(s) não permitido(s) | O bot solicitou um intent privilegiado (Membros do Servidor ou Conteúdo de Mensagens) que não está ativado para a aplicação |
Na prática, 4013 e 4014 aparecem pelo mesmo motivo de fundo na maioria dos bots: um intent privilegiado que o código precisa está desligado no portal. A discord.js e bibliotecas semelhantes às vezes reportam isso como um erro de "intents não permitidos" nos logs, em vez do código numérico bruto, mas é o mesmo problema. Nosso guia de intents privilegiados do gateway explica com mais profundidade o que cada intent controla e o que quebra sem ele.
Como corrigir cada um no Bot Personalizado da Noxyr
Gateway 4004, ou "o Discord rejeitou este token"
O token com o qual o bot fez login por último não existe mais. Isso acontece quando o token é redefinido no Portal de Desenvolvedores, seja de propósito (para trocá-lo por segurança) ou por engano (clicar em Redefinir Token enquanto apenas olhava a aba Bot).
- Abra o Portal de Desenvolvedores do Discord, selecione a aplicação e vá até a aba Bot.
- Pressione Redefinir Token de novo: isso gera um novo; copie-o imediatamente, já que o Discord só o mostra uma vez.
- Abra a página do Bot Personalizado no painel da Noxyr e cole o novo token.
- Ligue o bot novamente. Os nós da Noxyr desligam automaticamente um bot com token inválido para que ele não fique preso em um loop de reconexão morto; colar um token válido e ligar o bot é o que o reinicia.
Gateway 4013/4014, ou "o Discord recusou a conexão"
Um intent privilegiado que estava ativo durante a configuração foi desligado depois, geralmente enquanto alguém clicava pela aba Bot por outro motivo.
- No Portal de Desenvolvedores, vá em Bot → Privileged Gateway Intents (Intents Privilegiados do Gateway).
- Ligue de novo o Server Members Intent e o Message Content Intent. Ambos são obrigatórios; o conjunto de recursos da Noxyr (mensagens de boas-vindas, contagem de membros, chat com IA, auto-responders, transcrições de tickets) precisa dos dois.
- Salve e ligue o bot novamente pela página do Bot Personalizado no painel. Como o Discord só aplica mudanças de intents no próximo login, simplesmente reativar a chave não basta por si só; o bot precisa se reconectar.
Janela de voto e período de tolerância expirados
O Bot Personalizado funciona com um voto no Top.gg. Um voto o libera por 12 horas; depois disso, um período de tolerância de 74 horas mantém o bot em funcionamento enquanto a página do painel fica bloqueada. Se os dois acabarem, o bot fica offline, embora nada na sua configuração seja apagado.
- Vote na Noxyr no Top.gg.
- Volte à página do Bot Personalizado; ela é desbloqueada logo após o voto ser registrado.
- O bot reinicia sozinho, usando o mesmo token e as mesmas configurações que tinha antes.
Um DM de lembrete é enviado 24 horas após o seu último voto (12 horas dentro do período de tolerância) justamente para evitar isso. Se o status do bot mostrar "suspenso", a própria página dirá se o motivo é o voto, o período de tolerância ou o próximo problema abaixo.
A Noxyr foi removida do servidor
O Bot Personalizado funciona com as configurações e o banco de dados da Noxyr para aquele servidor, então depende de a Noxyr continuar sendo membro. Se a Noxyr for expulsa, o bot personalizado deixa de atender aquele servidor em cerca de um minuto, e envia um DM para quem removeu a Noxyr (e para o dono do bot, se for outra pessoa) com um link de convite.
- Convide a Noxyr novamente usando o link do DM ou da página inicial da Noxyr.
- O bot personalizado volta a funcionar sozinho assim que a Noxyr estiver de volta ao servidor; não é preciso mexer no token nem nos intents.
Enquanto estiver parado por este motivo específico, a janela de voto fica pausada em vez de ser consumida, então convidar a Noxyr de novo logo não faz você perder tempo do relógio.
Se nada acima resolver
Verifique primeiro a mensagem de status na página do Bot Personalizado; os nós da Noxyr escrevem um motivo em linguagem simples (token inválido, intents inválidos, suspenso, ou uma mensagem genérica de nova tentativa para qualquer outra coisa) em vez de apenas um código de erro. Se a mensagem de status não corresponder a nenhum dos casos acima, ou se o bot continuar offline depois de uma correção que deveria ter funcionado, a Central de Suporte é a forma mais rápida de alguém olhar o servidor específico. A configuração completa e os passos de solução de problemas também estão na documentação do Bot Personalizado.
Perguntas frequentes
Por que o meu bot ficou offline logo depois de eu não ter feito nada? "Nada" normalmente significa que outra pessoa com acesso ao portal ou ao servidor mudou algo: uma redefinição de token, uma troca de intent, uma expulsão. Verifique primeiro a mensagem de status da página do Bot Personalizado; ela informa a causa.
Perco dados se o bot ficar offline? Não. Tokens, configurações, tickets, produtos, faturas e transcrições são mantidos independentemente do motivo da parada. Corrigir a causa traz tudo de volta exatamente como estava.
Consigo evitar totalmente o caso de offline por causa do voto? Vote aproximadamente a cada três dias e meio (antes de a janela de 12 horas somada às 74 horas de tolerância acabar), e o bot nunca cai por esse motivo.
Preciso reativar os intents toda vez que reinicio o bot? Não. Os intents são uma configuração da própria aplicação do Discord, não algo que se redefine. Uma vez que ambos estejam ligados e salvos, permanecem assim até que alguém os desligue.
Pronto para colocá-lo de volta online? Corrija a causa acima e inicie o bot pela página do Bot Personalizado, ou adicione a Noxyr grátis se estiver configurando um pela primeira vez.