Saltar al contenido principal

Discord

DiscordEquipo y comunidad

Agregar tu agente a Discord es como invitar a un nuevo miembro a tu comunidad que siempre está disponible para responder preguntas. Los miembros chatean con el agente en un canal y él responde automáticamente. Esta página te muestra cómo crear un bot de Discord y agregarlo a tu servidor.

Antes de comenzar​

  • Un agente guardado en el Panel de Control de Agentes (al menos el paso de Perfil completado).
  • Un servidor de Discord: el espacio de comunidad donde viven tus canales y tus miembros.
  • Permiso de "Gestionar Servidor" o de administrador en ese servidor.
  • Un token del bot: un pase de acceso seguro de tu aplicación de Discord que le permite a Nirvai controlar tu bot. Lo crearás en el siguiente paso.

Paso a paso​

1. Crea el bot en Discord​

  1. Inicia sesión en el Discord Developer Portal en discord.com/developers.
  2. Haz clic en New Application, dale un nombre (por ejemplo, "Mi Agente de Comunidad") y créala.
  3. En el menú de la izquierda, abre la sección Bot.
  4. Haz clic en Reset Token (o View Token) y copia el token del bot. Este es tu pase de acceso seguro.
  5. En Privileged Gateway Intents, activa Message Content Intent para que el bot pueda leer los mensajes.
aviso

Mantén tu token del bot en privado. Cualquiera que lo tenga puede controlar tu bot: trátalo como una contraseña. Si alguna vez lo pegas en otro lugar por error, haz clic en Reset Token para revocarlo.

2. Agrega el bot a tu servidor​

Todavía en el Developer Portal:

  1. Abre OAuth2 → URL Generator.
  2. Marca el alcance bot y luego marca los permisos básicos de mensajes (leer mensajes, enviar mensajes, adjuntar archivos).
  3. Copia la URL generada y ábrela en tu navegador.
  4. Elige tu servidor y haz clic en Autorizar.

El bot aparece en la lista de miembros de tu servidor (se mostrará desconectado hasta que termines el siguiente paso).

3. Conecta el bot a Nirvai​

  1. Abre tu agente en el Panel de Control de Agentes.
  2. Haz clic en el nodo Canales.
  3. Selecciona Discord en la sección de Equipo y comunidad.
  4. Pega tu token del bot en el campo.
  5. Haz clic en Conectar.

Tu bot se pone en línea y empieza a responder mensajes en cualquier canal al que tenga acceso.

Qué pasa después de conectarlo​

  • Cuando alguien publica en un canal al que el bot tiene acceso, Discord le pasa el mensaje a Nirvai, tu agente lo lee y la respuesta aparece en el mismo canal.
  • El agente termina la respuesta actual antes de empezar la siguiente: los mensajes adicionales se ponen en fila y se responden en orden.
  • Si un miembro envía una imagen o un archivo, el agente simplemente responde: no hay un mensaje aparte de "subido".

Lo que tu agente puede hacer en Discord​

CapacidadCompatible
Responder mensajes del canal✓
Enviar mensajes de texto✓
Enviar imágenes✓
Enviar archivos✓
Enviar tarjetas de mensaje enriquecidas✓

Gestionar tu conexión​

  • Eliminar desconecta Discord de tu agente. El bot permanece en tu servidor, pero queda desconectado hasta que vuelvas a conectarlo.
  • Para rotar el token del bot, haz clic en Reset Token en el Developer Portal y luego pega el nuevo token en Nirvai.

Solución de problemas​

ProblemaSolución
El bot no respondeAsegúrate de que el bot tenga permiso para leer y enviar mensajes en ese canal, y de que Message Content Intent esté activado en el Developer Portal.
El bot aparece desconectadoLa conexión puede haberse caído: elimínala en Nirvai y vuelve a conectarla con el mismo token del bot.
"Permisos insuficientes" al invitar al botNecesitas el permiso "Gestionar Servidor" en el servidor de Discord. Pídele a un administrador que haga este paso.
"Token inválido" al conectarCopia el token de nuevo: no debe haber espacios al principio ni al final. Si lo regeneraste, el anterior dejó de funcionar.
El bot responde pero se salta mensajesPuede haber una respuesta larga aún en curso: el siguiente mensaje se tomará en cuanto el agente termine.

Qué sigue​

  • Conoce todos los lugares donde puede aparecer tu agente en el Resumen de Canales.
  • Configura un bot público en Telegram o un asistente de workspace en Slack.