Errores de bots de Discord en Square Cloud: LoginFailure, Intents no permitidos, Lavalink 1006

​

”LoginFailure: Improper token has been passed” / TOKEN_INVALID

• El token fue regenerado o revocado en el Discord Developer Portal. Generar un token nuevo invalida al instante el anterior en todos los lugares donde se usaba.
• El string del token tiene espacios o comillas extra copiadas por accidente.
• El código está leyendo la variable de entorno equivocada.

1. Ve al Developer Portal → tu aplicación → Bot → Reset Token.
2. Actualiza el token en las Variables de Entorno de esta aplicación en el dashboard de Square Cloud. Nunca subas el token en un archivo que se incluya en el .zip.
3. Verifica que no haya espacios o comillas de más alrededor del valor.
4. Actualiza la librería (discord.js@latest o pip install -U discord.py).
5. Reinicia la aplicación.

​

”Used disallowed intents” / Message Content Intent

1. Discord Developer Portal → tu aplicación → Bot → Privileged Gateway Intents → habilita Message Content Intent.
2. Decláralo también en el código:

// discord.js
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

# discord.py
intents = discord.Intents.default()
intents.message_content = True
client = commands.Bot(command_prefix="!", intents=intents)

3. Reinicia la aplicación.

​

Conexión de Lavalink cerrada con código 1006

1. Alinea la versión del wrapper de cliente de Lavalink de tu bot con la versión mayor del servidor Lavalink (cliente v3 con servidor v3, cliente v4 con servidor v4).
2. En Square Cloud, el servidor Lavalink en sí enlaza el puerto 80, pero tu bot debe conectarse a él a través del edge en el puerto 443 con secure: true.
3. Reinicia tanto la aplicación de Lavalink como la del bot después de corregir la incompatibilidad de versiones.

​

El bot queda offline después de funcionar en local

• Una conexión inestable a nivel de gateway sin manejo de reconexión.
• Versiones de dependencias conflictivas o incompatibles entre lo que probaste en local y lo que está en tu archivo de dependencias.
• Activadores de abuso de la API de Discord (en este caso la cuenta recibe un correo de notificación) por golpear los límites de tasa de forma demasiado agresiva.

1. Revisa primero los logs de la aplicación en el dashboard, muestran la razón real del fallo.
2. Agrega manejadores de errores para que un error transitorio no termine el proceso: process.on("unhandledRejection", ...) y client.on("error", ...) en discord.js, manejo equivalente en discord.py.
3. Square Cloud reinicia automáticamente una aplicación caída (AUTORESTART en el manifiesto) cuando el uptime anterior fue mayor a 60 segundos, el estado de salida fue 1, y no se ha reiniciado automáticamente en los últimos 60 minutos. Esto mantiene al bot vivo ante errores transitorios, pero nunca soluciona un error de código subyacente, un error de sintaxis o una dependencia faltante, esos todavía necesitan una corrección en el código.
4. Vigila los límites de tasa (429) de la API de Discord: el límite global es de aproximadamente 50 solicitudes/segundo por token de bot, con buckets más estrictos por ruta (crear/editar canal permite aproximadamente 2 cambios cada 10 minutos por canal). Cachea de forma agresiva, usa una cola asíncrona que respete los encabezados X-RateLimit-Remaining/X-RateLimit-Reset-After, y usa webhooks para envíos masivos.

​

Contáctanos