Guía paso a paso para integrar tu Agente de Quickchat AI con Discord. Crea un bot, configura los permisos y ponlo en marcha en tu servidor.
En esta guía veremos cómo integrar tu Asistente de IA en tu servidor de Discord. Resumen de lo que cubriremos:
- Crear un servidor de Discord
- Crear una aplicación de Discord
- Configurar tu aplicación de Discord
- Añadir el bot a tu servidor de Discord
- Integrar tu bot de Discord con Quickchat AI
Mira el video
Sección titulada «Mira el video»Crear y configurar un servidor de Discord
Sección titulada «Crear y configurar un servidor de Discord»Crear un servidor de Discord
Sección titulada «Crear un servidor de Discord»Para iniciar la integración, necesitas un servidor de Discord. Si no tienes cuenta, visita discord.com y crea una. Una vez dentro, sigue esta guía para crear tu servidor de Discord.
Crear una aplicación de Discord
Sección titulada «Crear una aplicación de Discord»Ve a discord.com/developers/applications con tu sesión iniciada y crea una nueva aplicación.
Configurar tu aplicación de Discord
Sección titulada «Configurar tu aplicación de Discord»Antes de añadir el bot al servidor, habilita el Message Content Intent para tu aplicación. Esto permite que tu bot lea los mensajes enviados por los usuarios en tu servidor.

Añadir el bot a tu servidor de Discord
Sección titulada «Añadir el bot a tu servidor de Discord»Ahora necesitas añadir el bot a tu servidor. Para hacerlo, construye la siguiente URL de Discord y pégala en tu navegador:
https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237712896&scope=bot¿De dónde sale el número de permisos?
El número de permisos (309237712896) proviene de solicitar los siguientes permisos:
Send MessagesCreate Public ThreadsSend Messages in ThreadsRead Message History
Ese es el conjunto mínimo de permisos para que tu bot funcione correctamente. Puedes verlo en discord.com/developers/applications, seleccionando tu aplicación, haciendo clic en Bot en la izquierda y desplazándote hacia abajo:

¿Dónde encuentro MI CLIENT ID?
La forma más fácil es mirar la barra de direcciones del navegador y copiar el número largo que forma parte de la dirección:
https://discord.com/developers/applications/<YOUR CLIENT ID>/bot
En este caso, el client id es 1234567890123456789, lo que significa que la URL completa para añadir el bot será:
https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237712896&scope=botIntegrar tu bot de Discord con Quickchat AI
Sección titulada «Integrar tu bot de Discord con Quickchat AI»Para conectar tu bot con Quickchat AI, recupera tu Discord Bot Token desde el Developer Portal.
- Ve a Bot Settings → Reset Token → Copy Token

- En el Panel de Quickchat AI, ve a External Applications, abre la integración de Discord, activa Activar Discord y pega tu token.

🎉 ¡Tu bot de IA está en línea!
Sección titulada «🎉 ¡Tu bot de IA está en línea!»Vuelve a Discord: tu bot debería estar online y listo para chatear. Simplemente menciónalo con @ para iniciar una conversación. 🤖💬

De forma predeterminada, cuando lo @mencionen, el bot responde en el mismo canal. Puedes cambiarlo con el ajuste Modo de respuesta de la integración: Responder en el canal (predeterminado) o Responder en hilos. Con Responder en hilos, el bot responde dentro de un hilo y los usuarios pueden continuar la conversación allí sin volver a mencionarlo.

Solución de problemas
Sección titulada «Solución de problemas»Si Quickchat AI informa de un error en la página de integración de Discord, enlaza directamente a la sección correspondiente más abajo.
Message Content Intent
Sección titulada «Message Content Intent»PrivilegedIntentsRequired: tu bot se conectó, pero su Message Content Intent está desactivado, así que no puede leer los mensajes. En el Developer Portal, abre tu aplicación, ve a Bot → Privileged Gateway Intents, activa Message Content Intent y guarda. El bot se reinicia automáticamente, espera alrededor de un minuto.

Token de bot no válido
Sección titulada «Token de bot no válido»InvalidToken: el token que tiene Quickchat AI es incorrecto o se regeneró. Un token de bot se muestra solo una vez, y restablecerlo invalida el anterior. En el Developer Portal, abre tu aplicación, ve a Bot, haz clic en Reset Token, copia el nuevo token, luego haz clic en Reconnect en Quickchat AI y pégalo.

Require OAuth2 Code Grant
Sección titulada «Require OAuth2 Code Grant»Si aparece “Integration requires code grant” al añadir el bot, tu aplicación tiene activado Require OAuth2 Code Grant, lo que bloquea el flujo simple de invitación del bot. En el Developer Portal, abre tu aplicación, ve a Bot, desactiva Require OAuth2 Code Grant, guarda y vuelve a abrir la URL de invitación.
La página de autorización muestra un pastel o un mensaje “baked”
Sección titulada «La página de autorización muestra un pastel o un mensaje “baked”»Esa pantalla curiosa es la página de éxito de Discord: el bot fue añadido. Para confirmarlo, abre Ajustes del servidor → Integraciones → Bots y aplicaciones y busca tu bot en la lista.
El bot no responde tras la configuración
Sección titulada «El bot no responde tras la configuración»El bot se reinicia cada vez que cambias su token o sus ajustes, así que espera hasta un minuto después de guardar. Si sigue sin conectarse o sin responder:
- En el panel de Quickchat AI, abre External Apps → Discord y revisa el estado de la conexión. Un token inválido o un intent faltante se reporta ahí, con un enlace a la solución exacta.
- Confirma que Message Content Intent está activado (ver arriba) y que el token es actual (usa Reset Token ante la duda).
- Menciona al bot con @ en un canal al que tenga acceso, y verifica que sus permisos de rol y de canal incluyan Send Messages, Create Public Threads, Send Messages in Threads y Read Message History.
- Elige si responde en el canal o en un hilo con el ajuste Modo de respuesta en External Apps → Discord.
Únete a nuestro servidor de Discord para aprender más sobre cómo sacar el máximo partido a Quickchat AI 👉 discord.gg/KqkHwvPRNH