Cómo evitar los rate limits de Discord y los baneos de bots

Discord limita la velocidad a la que un bot puede enviar peticiones. Un bot normal casi nunca lo nota, pero un bucle que edita muchos mensajes o reacciona en masa puede llegar al límite.

Cómo se ve un rate limit

Tu librería muestra una advertencia como You are being rate limited o un error con el estado 429 Too Many Requests. Librerías como discord.js y discord.py esperan y reintentan solas. Unas pocas advertencias son normales. Un flujo constante significa que tu código envía demasiado.

Cómo mantenerte dentro de los límites

• Haz el trabajo una sola vez. Guarda los resultados en caché en lugar de preguntarle a Discord cada vez que alguien ejecuta un comando.
• No recorras muchos miembros o canales llamando a la API por cada uno. Usa acciones masivas donde existan, como el borrado masivo.
• Baja el ritmo de mensajes, ediciones y reacciones dentro de los bucles con una pequeña espera entre ellos.
• Aplaza los comandos largos. Responde a un comando de barra en menos de tres segundos y luego envía el seguimiento: Errores comunes de los bots de Discord.
• Evita los rate limits globales no ejecutando varias copias del mismo bot con el mismo token.

Qué puede hacer que baneen a un bot

Lo deciden las reglas de Discord, no las nuestras. Las causas más comunes:

• Mensajes directos masivos a personas que no los pidieron.
• Spam, incluido entrar en muchos servidores para hacer publicidad.
• Selfbots: iniciar sesión con el token de una cuenta de usuario normal. No está permitido en Discord ni en nuestros servidores: Reglas de hosting de bots de Discord y uso justo.
• Filtrar el token y que alguien lo use de forma indebida: Cómo proteger el token de tu bot de Discord.

Si tu bot ya está limitado

1. Detén el servidor, lee la consola para encontrar qué acción se repite en bucle, arréglala y vuelve a iniciarlo.
2. Si un bot lleva bloqueado mucho tiempo, la causa suele ser un código que reintenta de forma agresiva. Añade una espera o un límite.
3. Restablece el token si crees que otra persona lo usó.