Bot de Discord desconectado: cómo solucionarlo paso a paso
¿Tu bot de Discord aparece offline? Revisa el token, las variables y el estado de la app con el asistente de SolumeCore y lee los errores de la consola.
Si tu bot de Discord aparece desconectado después de desplegarlo en SolumeCore, la causa casi siempre es una de tres: Discord rechazó el token, la app todavía no ha leído el token o la app no está en marcha. El asistente de bot de Discord del panel ejecuta justo esas tres comprobaciones, así que empieza por ahí y después mira la consola para cualquier otra cosa.
Paso 1: Ejecuta las tres comprobaciones
- Abre tu app en el panel y entra en Código > Deploy.
- En la tarjeta Asistente de bot de Discord, pulsa Abrir asistente. También puedes usar Código > Variables > Importar / exportar > Asistente de bot de Discord.
- Ve al paso Conectar. Si ya hay un token guardado, el asistente lo comprueba al instante. Pulsa Verificar de nuevo después de cada arreglo.
| Comprobación | Si no está en verde | Solución |
|---|---|---|
| Discord aceptó el token | Discord rechazó el token | Abre el portal de desarrolladores de Discord, ve a la pestaña Bot de tu aplicación, pulsa Reset Token y pega el token nuevo en el primer paso |
| Tu app ya tiene el token (o el aviso para reiniciar la app y que lea el token) | La app arrancó antes de que se guardara el token | Pulsa Reiniciar junto a la comprobación. Las apps solo leen las variables al arrancar |
| Tu app está encendida (o Tu app está apagada) | La app está apagada o se cayó | Pulsa Encender y abre la consola si vuelve a detenerse |
Si el mensaje dice que todavía no hay un token guardado, vuelve al primer paso y pégalo. Asegúrate de copiar el token del bot de la pestaña Bot, no el Client Secret ni el Application ID.
Paso 2: Lee la consola
Si las tres comprobaciones están en verde pero el bot sigue desconectado, lo más probable es que la app arranque y se caiga enseguida. Abre Consola > Consola en vivo (o Logs y salud para líneas más antiguas) y mira el primer error después del arranque:
| Error | Qué significa | Solución |
|---|---|---|
TokenInvalid / «An invalid token was provided» (discord.js), LoginFailure / «Improper token» (discord.py) |
El token es incorrecto o fue restablecido | Guarda de nuevo el token actual en el asistente o en Código > Variables y reinicia |
Used disallowed intents / PrivilegedIntentsRequired |
Tu código pide un intent que está desactivado en el portal | En la pestaña Bot activa el intent, normalmente Message Content Intent, y reinicia |
Cannot find module 'discord.js' / ModuleNotFoundError: No module named 'discord' |
No se instalaron las dependencias | Define el Comando de build (npm install o la línea de pip install -r requirements.txt) y vuelve a desplegar |
undefined / KeyError: 'DISCORD_TOKEN' |
El nombre de la variable en tu código no coincide con el del panel | Usa el mismo nombre en ambos sitios y reinicia |
SyntaxError u otro error que apunta a tu propio archivo |
Un fallo en el código | Corrígelo y vuelve a desplegar |
Hay más sobre cómo leer la consola en Ver los logs y la consola en vivo de tu app o bot.
Paso 3: El bot está en línea pero no responde
- No aparecen los comandos de barra: tu código debe registrarlos en Discord, y pueden tardar un momento en mostrarse. Vuelve a invitar el bot con el preajuste Básico, que incluye los comandos de barra.
- El bot ignora los mensajes normales: activa Message Content Intent en el portal y solicita ese intent en tu código.
- No ve un canal o no puede enviar mensajes: revisa los permisos del canal y de los roles en tu servidor de Discord. En el asistente, el paso Invitar te deja elegir Básico, Moderación, Música o Administrador; elige el preajuste que corresponda a lo que hace tu bot. Administrador le da control total de tu servidor, así que úsalo solo si sabes por qué lo necesita.
- Se invitó al servidor equivocado: pulsa de nuevo Invitar a mi servidor y elige el correcto.
Paso 4: El bot se desconecta pasado un rato
- Busca en los logs guardados las últimas líneas antes de que se detuviera: un error sin controlar o quedarse sin memoria son las causas habituales.
- Corrige el fallo, o envuelve el código arriesgado para que un error no detenga el proceso entero.
- Para mantenerlo sano, programa un reinicio. Mira Reiniciar tu app o bot y activar el reinicio automático. Un bot normal no escucha en ningún puerto, así que no actives un health check TCP o HTTP salvo que tu código también responda en la variable
PORT; de lo contrario la revisión fallará y lo reiniciará en bucle.
Paso 5: Dejó de funcionar tras una actualización
Abre Código > Deploy y mira el último deploy. Si dice Falló, pulsa Ver log. Si el problema es la versión nueva, abre el Historial de deploys y pulsa Volver a esta en la última versión que funcionaba. Mira Desplegar una app desde GitHub o GitLab.
Cuándo restablecer el token
Restablece el token si apareció en un repositorio, en una captura de pantalla o en un chat, o si no sabes quién lo ha visto. En el portal pulsa Reset Token, pega el nuevo en el asistente o en Código > Variables y reinicia la app. El token anterior deja de funcionar al instante.
Preguntas frecuentes
¿Por qué mi bot de Discord aparece desconectado si la app está en marcha?
Lo más probable es que el token sea incorrecto, que la app arrancara antes de guardar el token o que el código se caiga después de iniciar sesión (por ejemplo, por un intent no permitido). El paso Conectar del asistente y la consola te muestran cuál es.
¿Cómo sé si Discord aceptó mi token?
El paso Conectar muestra el nombre y el ID de tu bot y la línea Discord aceptó el token. Si Discord lo rechaza, verás un error que te pide restablecer el token en el portal.
¿Tengo que reiniciar la app después de cambiar el token?
Sí. La app lee las variables al arrancar, así que pulsa Reiniciar en el asistente o Reiniciar para aplicar en Código > Variables.
¿Por qué mi bot se desconecta cuando hago un deploy?
Durante un deploy la app se reinicia, así que el bot se reconecta a Discord y está desconectado un momento. Discord no permite dos conexiones con el mismo token, y por eso los bots no pueden usar deploys sin caída.
Artículos relacionados
- Cómo alojar un bot de Discord 24/7
- Desplegar un bot de Discord con Node.js (discord.js)
- Desplegar un bot de Discord con Python (discord.py)
- Ver los logs y la consola en vivo de tu app o bot
¿Sigues atascado? Abre un ticket de soporte desde el panel con el nombre de tu app y las últimas líneas de la consola. Si todavía estás eligiendo dónde alojar tu bot, compara los planes de apps.