Bot de Discord offline ou sem responder
O bot sumiu ou ignora os comandos. Antes de reescrever código, siga uma ordem de diagnóstico: o processo está rodando, o token é válido, as intents e permissões estão certas.
Ordem de diagnóstico
Diagnosticar na ordem certa economiza horas. A maioria das pessoas começa mexendo no código, quando o problema é o processo parado ou uma permissão faltando. Vá do mais provável ao mais raro e leia sempre os logs, que contam a história real do que aconteceu.
| Sintoma | Causa provável | Onde olhar |
|---|---|---|
| Offline na lista | Processo parado | Logs e gerenciador de processo |
| Online mas mudo | Intent ou permissão | Portal e canal |
| Erro de login no log | Token inválido | Variável de ambiente |
| Lento e atrasado | Rate limit | Logs de requisição |
O processo está rodando
Bot offline na lista de membros quase sempre significa programa parado. Confira no servidor se o processo está ativo e leia os logs para achar o erro que o derrubou. Se ele cai e não volta, falta um gerenciador de processo com restart automático, como mostra o deploy com PM2.
Token e intents
Se o log mostra falha de login, o token foi trocado ou revogado. Gere um novo no portal e atualize a variável de ambiente. Se o bot conecta mas ignora mensagens, falta a intent de conteúdo de mensagem, que precisa estar ativada no portal e no código.
Depois de trocar o token ou variáveis, reinicie o bot atualizando o ambiente. Muitos casos de bot mudo são só o processo ainda rodando com o token antigo.
Permissões e rate limit
O bot pode estar online e sem permissão para falar no canal. Confira as permissões dele no canal específico. Se as respostas vêm atrasadas, o problema costuma ser rate limit. Trate o limite com calma, como explica corrigir rate limit 429.
Prevenir quedas
- Gerenciador de processo com restart automático
- Logs com data e nível para diagnóstico rápido
- Token em variável de ambiente, fácil de rotacionar
- Monitoramento de uptime para avisar quando cair
A melhor correção é não cair. Hospede o bot com restart automático seguindo hospedagem 24 horas e conheça os planos de bots.
Perguntas frequentes
- O bot aparece offline, por onde começo?
- Pelo processo. Se o bot está offline na lista de membros, quase sempre o programa parou de rodar. Confira no servidor se o processo está ativo e olhe os logs em busca do erro que o derrubou.
- O bot está online mas não responde aos comandos, por quê?
- Aí o programa roda, mas algo bloqueia a resposta. As causas comuns são falta da intent de conteúdo de mensagem, ausência de permissão no canal ou rate limit. Verifique essas três antes de mexer no código.
- Como sei se o token está inválido?
- Um token inválido costuma gerar erro de autenticação no log, como uma falha de login. Isso acontece quando o token foi trocado ou revogado. Gere um novo no portal e atualize a variável de ambiente.
- Rate limit derruba o bot?
- Não derruba, mas faz o bot parecer travado, porque ele precisa esperar para agir. Reinício em loop pode piorar. Trate o limite lendo o tempo de espera e reagendando, em vez de tentar de novo na hora.
Próximo passo
Ver planos de bots
Bots Discord 24/7 com ativação rápida e suporte em português.
Guias relacionados
Hospedagem de bot Discord 24/7 no Brasil
Hospedagem bot Discord 24/7 combina process manager com restart automático, token fora do código, logs e servidor no Brasil para latência baixa com a API e seus jogadores.
Como corrigir erro 429 rate limit no Discord
O erro 429 aparece quando seu bot envia chamadas demais em pouco tempo. Com controle simples de fila e tempo de espera você reduz esse problema.
Deploy de bot Discord Node.js com PM2: variáveis de ambiente e restart automático
PM2 é gerenciador de processos Node popular para bots Discord porque reinicia após crash, persiste entre reboots quando combinado com startup hook e centraliza logs mínimos sem montar Kubernetes inteiro. Este guia cobre arquivo ecosystem, env vars para token e integração com hospedagem BR.