Guía · 1 de septiembre de 2026 · 4 min de lectura
«El bot no funciona»: por dónde empezar
Un bot que parece averiado casi siempre funciona: le falta un derecho, o se le pide algo que no tiene derecho a hacer. Estas son las causas reales, ordenadas por frecuencia — no por lógica técnica.
Contenido
1. El módulo nunca se activó
Es la primera causa, y con diferencia. Instalar un bot no configura nada: cada módulo — bienvenida, niveles, tickets, auto-moderación — arranca apagado. Esperar un mensaje de bienvenida sin haber activado el módulo da exactamente la impresión de un bot roto.
El reflejo: comprobar el estado del módulo antes que nada. Una página de configuración que muestra lo apagado tanto como lo encendido resuelve esta cuestión en diez segundos.
2. Falta un permiso en ese canal concreto
Un bot puede tener todos los permisos a nivel de servidor y ninguno en un canal dado: los permisos de canal mandan. El síntoma típico es desconcertante — el bot responde en todas partes menos en un canal.
Los cuatro permisos que hay que comprobar primero: ver el canal, enviar mensajes, insertar enlaces (sin él no aparece ningún embed), adjuntar archivos (sin él, ninguna imagen generada).
La prueba que responde en treinta segundos
Abre los ajustes del canal afectado, pestaña de permisos, y busca el rol del bot. Es más rápido que comparar los permisos generales, y es ahí donde está el problema en la mayoría de los casos.
3. El rol del bot está demasiado bajo
Un bot solo puede actuar sobre los roles situados por debajo del suyo, y no puede sancionar a alguien cuyo rol más alto supere al suyo. Esa regla viene de Discord y ningún permiso la esquiva — un bot administrador colocado al final de la lista falla exactamente igual.
Síntomas: el bot sanciona a unos miembros y a otros no, o no asigna un rol concreto mientras que los demás pasan. Corrección: subir el rol del bot por encima de todos los roles que deba gestionar.
4. El comando no está desplegado
Los comandos de barra se declaran ante Discord, no se envían en cada uso. Un comando añadido recientemente puede tardar en aparecer en el menú, o no aparecer en absoluto si el despliegue falló.
Dos comprobaciones: cerrar y volver a abrir Discord por completo — el cliente guarda una lista en caché; y comprobar que el bot fue invitado con el ámbito de los comandos de aplicación. Un bot invitado sin él entra en el servidor y no expone ningún comando.
5. Una restricción que pusiste tú
Comando reservado a un rol, limitado a un canal, desactivado o en tiempo de recarga. Son ajustes voluntarios que uno olvida haber hecho, sobre todo cuando datan de hace meses o de otro administrador.
Un signo distintivo: el bot responde para negarse. Un comando que no produce ninguna reacción corresponde a las causas anteriores; un comando que explica que está reservado funciona perfectamente.
6. El canal configurado ya no existe
Un canal de registros borrado, una categoría renombrada, un canal de bienvenida archivado: el módulo sigue activo, apunta a un canal desaparecido y ya no envía nada. Nada falla de forma visible, lo que hace que el caso tarde en encontrarse.
Por eso un control de salud — que comprueba que cada canal configurado sigue existiendo y sigue siendo accesible — vale más que una larga reparación a posteriori.
7. No es este bot
En un servidor con varios bots, dos de ellos responden a veces al mismo comando, o uno borra el mensaje antes de que el otro lo procese. El comportamiento parece errático: el comando funciona una de cada dos veces.
La prueba: retirar temporalmente al otro bot el permiso de enviar mensajes en el canal afectado. Si el problema desaparece, se trataba de un conflicto, no de una avería.
Lo que hay que dar al informar de un problema
Un informe útil contiene cuatro cosas: el comando exacto, el canal, lo que pasó y lo que se esperaba. «El bot falla» no permite ninguna comprobación; «/rank en #general no responde nada desde ayer» se diagnostica en dos minutos.
Preguntas frecuentes
El bot está conectado pero no responde a nada
Comprueba primero el permiso de enviar mensajes en el canal, y después el ámbito de los comandos de aplicación en la invitación. Esas dos causas cubren la mayoría de los casos.
Los comandos no aparecen en el menú
Reinicia por completo el cliente de Discord. Si siguen sin aparecer, vuelve a invitar al bot con el ámbito correcto: eso no le hace salir del servidor y no reinicia nada.
El bot responde pero no actúa
Es casi siempre la jerarquía de roles, o un permiso específico que falta para la acción pedida — banear, gestionar roles, gestionar canales.
Todo dejó de funcionar de golpe
Mira el registro de auditoría del servidor: un cambio de permisos o de rol del bot figura ahí, con su autor y su marca de tiempo.
Leer después : El panel web, Permisos de los comandos, Auditoría de permisos.