Discord
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.
Image: Exportación del canal de Discord mostrando un servidor conectado
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
- Inicia sesión en el Discord Developer Portal en discord.com/developers.
- Haz clic en New Application, dale un nombre (por ejemplo, "Mi Agente de Comunidad") y créala.
- En el menú de la izquierda, abre la sección Bot.
- Haz clic en Reset Token (o View Token) y copia el token del bot. Este es tu pase de acceso seguro.
- En Privileged Gateway Intents, activa Message Content Intent para que el bot pueda leer los mensajes.
Image: Discord Developer Portal mostrando el token del bot
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:
- Abre OAuth2 → URL Generator.
- Marca el alcance bot y luego marca los permisos básicos de mensajes (leer mensajes, enviar mensajes, adjuntar archivos).
- Copia la URL generada y ábrela en tu navegador.
- 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
- Abre tu agente en el Panel de Control de Agentes.
- Haz clic en el nodo Canales.
- Selecciona Discord en la sección de Equipo y comunidad.
- Pega tu token del bot en el campo.
- Haz clic en Conectar.
Tu bot se pone en línea y empieza a responder mensajes en cualquier canal al que tenga acceso.
Image: Pegando el token del bot de Discord en Nirvai
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
| Capacidad | Compatible |
|---|---|
| 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
| Problema | Solución |
|---|---|
| El bot no responde | Asegú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 desconectado | La 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 bot | Necesitas el permiso "Gestionar Servidor" en el servidor de Discord. Pídele a un administrador que haga este paso. |
| "Token inválido" al conectar | Copia 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 mensajes | Puede 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.