Ir al contenido

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:

  1. Crear un servidor de Discord
  2. Crear una aplicación de Discord
  3. Configurar tu aplicación de Discord
  4. Añadir el bot a tu servidor de Discord
  5. Integrar tu bot de Discord con Quickchat AI
Play

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.

Ve a discord.com/developers/applications con tu sesión iniciada y crea una nueva aplicación.

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.

Interfaz de Quickchat AI

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 Messages
  • Create Public Threads
  • Send Messages in Threads
  • Read 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:

Permisos de tu bot

¿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

Tu client ID

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=bot

Para conectar tu bot con Quickchat AI, recupera tu Discord Bot Token desde el Developer Portal.

  1. Ve a Bot SettingsReset TokenCopy Token

Restablecer token

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

Pegar token

Vuelve a Discord: tu bot debería estar online y listo para chatear. Simplemente menciónalo con @ para iniciar una conversación. 🤖💬

Bot activo

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.

Conversación en hilo

”Integration requires code grant” al añadir el bot

Sección titulada «”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 está en el servidor pero aparece desconectado

Sección titulada «El bot está en el servidor pero aparece desconectado»
  1. 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 instrucciones.
  2. Los tokens de bot se muestran solo una vez. Ante la duda, haz clic en Reset Token en el Developer Portal, copia el nuevo token y pégalo de nuevo en Quickchat.
  3. Asegúrate de que Message Content Intent esté activado en Bot → Privileged Gateway Intents.
  4. Espera hasta un minuto después de guardar: el bot se reinicia cuando cambian sus ajustes.

Menciona al bot con @ en un canal al que tenga acceso. Verifica que sus permisos de rol y de canal incluyan Send Messages, Create Public Threads, Send Messages in Threads y Read Message History. Si responde en el canal o en hilos se configura en Quickchat 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