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

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.

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.

Activar Message Content Intent

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.

Restablecer el token del bot

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 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:

  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 un enlace a la solución exacta.
  2. Confirma que Message Content Intent está activado (ver arriba) y que el token es actual (usa Reset Token ante la duda).
  3. 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.
  4. 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

Última actualización: