Un bot de Discord se desconecta por una de unas pocas razones predecibles: un token restablecido, un intent privilegiado desactivado, un periodo de voto caducado en un bot alojado o la eliminación del bot del servidor del que depende. El gateway de Discord indica cuál es con un código de cierre. Los códigos 4004 y 4013/4014 son los que más verás, y cada uno tiene una solución concreta y mecánica, no un “reinícialo y espera” genérico.
Empieza aquí: la causa más probable primero
Ordenadas por la frecuencia con la que ocurren realmente:
- Se restableció el token. Alguien pulsó Restablecer token en el Portal para desarrolladores de Discord, a propósito o por accidente, y el token antiguo que usaba el bot ya no sirve.
- Se desactivó un intent privilegiado. El Intent de miembros del servidor o el Intent de contenido de mensajes se apagó después de configurar el bot.
- Caducó una ventana de voto o de suscripción. En un bot alojado como el Custom Bot de Noxyr, el tiempo de funcionamiento depende de un voto en Top.gg, y la ventana junto con su periodo de gracia se agotó.
- Se eliminó el bot del servidor, o se eliminó un bot del que depende. El Custom Bot depende específicamente de que Noxyr esté presente. Si expulsas a Noxyr, el bot personalizado se detiene en ese servidor.
- Una caída real. Discord está teniendo un mal día. Es raro, pero consulta discordstatus.com antes de dar por hecho que el problema está en tu configuración.
Qué significan realmente los códigos de cierre del gateway
| Código | Significado | Causa habitual |
|---|---|---|
| 4004 | Autenticación fallida | El token es incorrecto o se restableció en el Portal para desarrolladores |
| 4013 | Intent(s) no válido(s) | El código del bot pidió un intent que no existe, o una combinación que Discord rechaza |
| 4014 | Intent(s) no permitido(s) | El bot pidió un intent privilegiado (Miembros del servidor o Contenido de mensajes) que no está activado para la aplicación |
En la práctica, 4013 y 4014 aparecen en la mayoría de los bots por la misma causa de fondo: un intent privilegiado que necesita el código está desactivado en el portal. Discord.js y otras librerías similares a veces lo notifican en los registros como un error de “intents no permitidos” en lugar del código numérico, pero es el mismo problema. Nuestra guía de intents privilegiados del gateway explica con más detalle qué controla cada intent y qué se rompe si falta.
Cómo solucionar cada caso en Noxyr Custom Bot
Gateway 4004, o “Discord rechazó este token”
El token con el que el bot inició sesión por última vez ya no existe. Esto pasa cuando se restablece el token en el Portal para desarrolladores, ya sea a propósito (para rotarlo por seguridad) o por error (pulsar Restablecer token mientras se miraba la pestaña Bot).
- Abre el Portal para desarrolladores de Discord, selecciona la aplicación y ve a la pestaña Bot.
- Pulsa Restablecer token de nuevo. Esto genera uno nuevo. Cópialo de inmediato, porque Discord solo lo muestra una vez.
- Abre la página de Custom Bot en el panel de Noxyr y pega el token nuevo.
- Vuelve a activar el bot. Los nodos de Noxyr apagan automáticamente un bot con un token no válido para que no se quede en un bucle de reconexión muerto. Pegar un token que funcione y activarlo es lo que lo reinicia.
Gateway 4013/4014, o “Discord rechazó la conexión”
Un intent privilegiado que estaba activado durante la configuración se desactivó después, normalmente mientras alguien navegaba por la pestaña Bot por otro motivo.
- En el Portal para desarrolladores, ve a Bot → Intents privilegiados de Gateway.
- Vuelve a activar el Intent de miembros del servidor y el Intent de contenido de mensajes. Son obligatorios: el conjunto de funciones de Noxyr (mensajes de bienvenida, recuento de miembros, chat con IA, respuestas automáticas, transcripciones de tickets) necesita los dos.
- Guarda y vuelve a activar el bot desde la página de Custom Bot del panel. Como Discord solo aplica los cambios de intents en el siguiente inicio de sesión, volver a activar el interruptor no basta por sí solo: el bot tiene que reconectarse.
Ventana de voto y periodo de gracia caducados
El Custom Bot funciona con un voto en Top.gg. Un voto lo desbloquea durante 12 horas. Después, un periodo de gracia de 74 horas mantiene el bot en marcha mientras la página del panel se bloquea. Si ambos se agotan, el bot se desconecta, aunque no se borra nada de tu configuración.
- Vota por Noxyr en Top.gg.
- Vuelve a la página de Custom Bot. Se desbloquea de inmediato, en cuanto se registra el voto.
- El bot se reinicia por sí solo, con el mismo token y la misma configuración que tenía antes.
Para evitar esto, se envía un recordatorio por mensaje directo 24 horas después de tu último voto (12 horas dentro del periodo de gracia). Si el estado del bot aparece como “suspendido”, la propia página indicará si es por el voto, por el periodo de gracia o por el siguiente problema de esta lista.
Noxyr fue eliminado del servidor
El Custom Bot funciona con la configuración y la base de datos de Noxyr para ese servidor, así que depende de que Noxyr siga siendo miembro. Si expulsan a Noxyr, el bot personalizado deja de dar servicio en ese servidor en menos de un minuto, y envía un mensaje directo a quien expulsó a Noxyr (y al propietario del bot, si es otra persona) con un enlace de invitación.
- Vuelve a invitar a Noxyr usando el enlace del mensaje directo, o desde la página principal de Noxyr.
- El bot personalizado se recupera solo cuando Noxyr vuelve al servidor. No hace falta tocar el token ni los intents.
Mientras está detenido por este motivo concreto, la ventana de voto se pausa en lugar de consumirse, así que volver a invitar a Noxyr pronto no te hace perder tiempo de reloj.
Si ninguno de los puntos anteriores lo soluciona
Revisa primero el mensaje de estado de la página de Custom Bot. Los nodos de Noxyr escriben un motivo en lenguaje sencillo (token incorrecto, intents incorrectos, suspendido o un mensaje genérico de reintento para cualquier otro caso) en lugar de un código de error sin más. Si el mensaje de estado no coincide con ninguno de los casos anteriores, o si el bot sigue desconectado tras aplicar una solución que debería haber funcionado, el Centro de soporte es la forma más rápida de que alguien revise ese servidor concreto. Los pasos completos de configuración y resolución de problemas también están en la documentación de Custom Bot.
Preguntas frecuentes
¿Por qué se desconectó mi bot justo después de no hacer nada? “No hacer nada” normalmente significa que otra persona con acceso al portal o al servidor cambió algo: un restablecimiento de token, un cambio de intent o una expulsión. Revisa primero el mensaje de estado de la página de Custom Bot, que indica la causa.
¿Pierdo mis datos si el bot se desconecta? No. Los tokens, la configuración, los tickets, los productos, las facturas y las transcripciones se conservan independientemente del motivo por el que se detuvo el bot. Al solucionar la causa, todo vuelve exactamente como estaba.
¿Puedo evitar por completo que se desconecte por el voto? Vota aproximadamente cada tres días y medio (antes de que se agoten la ventana de 12 horas y el periodo de gracia de 74 horas) y el bot nunca se caerá por ese motivo.
¿Tengo que volver a activar los intents cada vez que reinicio el bot? No. Los intents son un ajuste de la propia aplicación de Discord y no se restablecen solos. Una vez que ambos están activados y guardados, permanecen así hasta que alguien los desactive.
¿Quieres volver a ponerlo en línea? Soluciona la causa indicada arriba y, después, inicia el bot desde la página de Custom Bot. Si lo configuras por primera vez, puedes añadir Noxyr gratis.