Como evitar rate limits e banimentos de bot no Discord

O Discord limita a velocidade com que um bot pode enviar requisições. Um bot normal raramente percebe, mas um loop que edita muitas mensagens ou reage em massa pode bater no limite.

Como é um rate limit

Sua biblioteca mostra um aviso como You are being rate limited ou um erro com o status 429 Too Many Requests. Bibliotecas como discord.js e discord.py esperam e tentam de novo sozinhas. Alguns avisos são normais. Um fluxo constante deles significa que o seu código envia coisa demais.

Como ficar dentro dos limites

• Faça o trabalho uma vez. Guarde os resultados em cache em vez de perguntar ao Discord toda vez que alguém usa um comando.
• Não faça loop por muitos membros ou canais chamando a API para cada um. Use ações em massa quando existirem, como o bulk delete.
• Desacelere mensagens, edições e reações em loops com uma pequena espera entre elas.
• Use defer em comandos demorados. Responda a um slash command em até três segundos e depois envie a resposta final: Erros comuns de bot do Discord.
• Evite os rate limits globais não rodando várias cópias do mesmo bot com o mesmo token.

O que pode fazer um bot ser banido

Quem decide isso são as regras do Discord, não as nossas. As causas mais comuns:

• Mensagens diretas em massa para pessoas que não pediram por elas.
• Spam, incluindo entrar em muitos servidores para divulgar algo.
• Selfbots: fazer login com o token de uma conta de usuário comum. Não é permitido no Discord e também não é permitido nos nossos servidores: Regras de hospedagem de bot do Discord e uso justo.
• Vazar o token e alguém fazer mau uso dele: Como manter o token do seu bot do Discord seguro.

Se o seu bot já está sendo limitado

1. Pare o servidor, leia o console para descobrir qual ação está em loop, corrija e inicie de novo.
2. Se um bot fica bloqueado por muito tempo, a causa geralmente é um código que tenta de novo de forma agressiva. Adicione uma espera ou um limite.
3. Redefina o token se achar que outra pessoa o usou.