Guia · 1 de setembro de 2026 · 4 min de leitura
«O bot não funciona»: por onde começar
Um bot que parece avariado quase sempre funciona: falta-lhe um direito, ou pede-se-lhe alguma coisa que não tem direito de fazer. Eis as causas reais, ordenadas por frequência — não por lógica técnica.
Índice
1. O módulo nunca foi ligado
É a primeira causa, e de longe. Instalar um bot não configura nada: cada módulo — boas-vindas, níveis, tickets, auto-moderação — arranca desligado. Esperar uma mensagem de boas-vindas sem ter ligado o módulo dá exatamente a impressão de um bot avariado.
O reflexo: verificar o estado do módulo antes de tudo o resto. Uma página de configuração que mostra o que está desligado tanto como o que está ligado resolve isto em dez segundos.
2. Falta uma permissão nesse canal em concreto
Um bot pode ter todas as permissões ao nível do servidor e nenhuma num determinado canal: as permissões de canal ganham. O sintoma típico é desconcertante — o bot responde em todo o lado exceto num canal.
As quatro permissões a verificar primeiro: ver o canal, enviar mensagens, incorporar ligações (sem ela, não aparece nenhum embed), anexar ficheiros (sem ela, nenhuma imagem gerada).
O teste que responde em trinta segundos
Abre as definições do canal em causa, separador das permissões, e procura o cargo do bot. É mais rápido do que comparar as permissões gerais, e é aí que está o problema na maioria dos casos.
3. O cargo do bot está demasiado baixo
Um bot só pode agir sobre os cargos situados abaixo do seu, e não pode sancionar alguém cujo cargo mais alto ultrapasse o dele. Essa regra vem do Discord e nenhuma permissão a contorna — um bot administrador colocado no fundo da lista falha exatamente da mesma forma.
Sintomas: o bot sanciona uns membros e outros não, ou não atribui um cargo específico enquanto os outros passam. Correção: subir o cargo do bot acima de todos os cargos que tem de gerir.
4. O comando não está implantado
Os comandos de barra são declarados junto do Discord, não enviados a cada utilização. Um comando acrescentado há pouco pode demorar a aparecer no menu, ou não aparecer de todo se a implantação falhou.
Duas verificações: fechar e reabrir o Discord por completo — o cliente guarda uma lista em cache; e verificar se o bot foi convidado com o âmbito dos comandos de aplicação. Um bot convidado sem ele entra no servidor e não expõe comando nenhum.
5. Uma restrição que tu próprio puseste
Comando reservado a um cargo, limitado a um canal, desativado, ou em tempo de recarga. São definições voluntárias que nos esquecemos de ter feito, sobretudo quando datam de há meses ou de outro administrador.
Um sinal distintivo: o bot responde para recusar. Um comando que não produz reação nenhuma pertence às causas anteriores; um comando que explica que está reservado funciona perfeitamente.
6. O canal configurado já não existe
Um canal de registos apagado, uma categoria renomeada, um canal de boas-vindas arquivado: o módulo continua ativo, aponta para um canal desaparecido, e deixa de enviar seja o que for. Nada falha visivelmente, o que torna o caso demorado de encontrar.
É por isso que um controlo de saúde — que verifica se cada canal configurado ainda existe e continua acessível — vale mais do que uma longa reparação depois do facto.
7. Não é este bot
Num servidor com vários bots, dois deles respondem por vezes ao mesmo comando, ou um apaga a mensagem antes de o outro a processar. O comportamento parece errático: o comando funciona uma vez em cada duas.
O teste: retirar temporariamente ao outro bot a permissão de enviar mensagens no canal em causa. Se o problema desaparecer, tratava-se de um conflito, não de uma avaria.
O que dar ao comunicar um problema
Um relato útil contém quatro coisas: o comando exato, o canal, o que aconteceu e o que era esperado. «O bot está com bugs» não permite qualquer verificação; «/rank no #geral não responde nada desde ontem» diagnostica-se em dois minutos.
Perguntas frequentes
O bot está online mas não responde a nada
Verifica primeiro a permissão de enviar mensagens no canal, e depois o âmbito dos comandos de aplicação no convite. Essas duas causas cobrem a maioria dos casos.
Os comandos não aparecem no menu
Reinicia o cliente do Discord por completo. Se continuarem ausentes, volta a convidar o bot com o âmbito certo: isso não o faz sair do servidor e não repõe nada.
O bot responde mas não age
É quase sempre a hierarquia dos cargos, ou uma permissão específica em falta para a ação pedida — banir, gerir cargos, gerir canais.
Parou tudo de uma vez
Vê o registo de auditoria do servidor: uma mudança de permissões ou de cargo do bot aparece lá, com o autor e a hora.
Ler a seguir : O painel web, Permissões dos comandos, Auditoria das permissões.