Discord

2 min de lectura

Discord permite que un agente participe en servidores, canales y mensajes directos a través de un bot. La configuración combina los permisos del servidor, los intents de la aplicación y las reglas del canal en Kujira.

Crear la aplicación y el bot

Crea una aplicación

En el portal de desarrolladores de Discord, crea una aplicación, añade un bot y guarda su token. No lo compartas: permite actuar como ese bot.

Activa el acceso al contenido

En la pestaña Bot, activa Message Content Intent. Sin este intent, Discord puede entregar el evento pero omitir el contenido del mensaje que debe procesar el agente.

Invita el bot al servidor

Genera un enlace OAuth2 con el scope bot y concédele únicamente los permisos necesarios. Para un canal conversacional suelen bastar View Channel, Send Messages, Read Message History y, si corresponde, permisos para adjuntos o enlaces enriquecidos.

Crea el canal en Kujira

En Canales del agente, añade Discord, introduce el token y autoriza los canales o chats concretos que debe atender.

Consulta los intents y sus eventos asociados en la documentación de Discord.

Los intents y los permisos son dos controles distintos

Un intent decide qué datos puede entregar Discord a la aplicación; los permisos del servidor deciden dónde puede leer o escribir el bot. Ambos deben estar configurados.

Limitar el alcance del agente

Invitar el bot a un servidor no le concede acceso a todos sus canales: la visibilidad se determina por los permisos de cada canal. Usa esa capa junto con la lista de permitidos de Kujira para reducir el alcance al mínimo necesario.

Por defecto, los grupos requieren una mención para activar al agente. Es una buena configuración para canales compartidos: evita que procese conversaciones ajenas y hace visible cuándo se le pide intervenir. Solo crea excepciones en canales dedicados al agente.

Canal de soporte

Invita el bot al canal, permite leer el historial y deja la regla de mención activa si comparte el espacio con personas.

Canal dedicado

Autoriza solo ese canal en Kujira. Puedes relajar la regla de mención si todo lo publicado debe llegar al agente.

Verificar y diagnosticar

1. Envía una mención al bot en un canal autorizado.
2. Comprueba que puede leer el canal y publicar una respuesta en Discord.
3. Si el evento no llega, revisa el token, Message Content Intent, la lista de permitidos y la regla de mención.
4. Si llega pero no puede responder, revisa los permisos efectivos del bot en ese canal, incluidos los permisos denegados por categoría.

Las conversaciones externas se atienden desde Agent Desk. Para servidores con más de cien comunidades, Discord puede requerir aprobación adicional de los intents privilegiados.