Saltar al contenido de la página
Documentación
Documentación de Make Agent Fast

Discord

Añade una interacción firmada /ask a una aplicación y a un servidor de Discord.

De un vistazo

Añade una interacción firmada /ask a una aplicación y a un servidor de Discord.

Enrutamiento de conectoresUn agente, muchos canales, conocimiento y bandeja de entrada compartidos
Agente + conocimientoEnrutador de conectores
Telegram
WhatsApp
Messenger
Instagram
Discord
KakaoTalk
Tutorial en vídeo · Episodio 9Messenger, Discord y KakaoTalk1:29 – 4:09 · Audio en inglésEpisodio completo y capítulos →

Crea la aplicación de Discord#

Sigue la guía de inicio rápido de aplicaciones y la introducción a las interacciones oficiales de Discord. Crea una aplicación en el Discord Developer Portal y reúne los siguientes datos:

Campo de Make Agent FastUbicación en DiscordFinalidad
Application IDGeneral InformationIdentifica la aplicación y el comando
Public KeyGeneral InformationVerifica las interacciones firmadas con Ed25519; exactamente 64 caracteres hexadecimales
Bot tokenPágina BotValida la aplicación y registra /ask; manténlo en secreto

Al restablecer un token de bot, el anterior deja de ser válido de inmediato. La Public Key no es secreta, pero debe pertenecer a la misma aplicación que el token del bot.

Conecta y registra /ask#

Abre la página Canales del agente, elige Discord, introduce los tres valores y selecciona Conectar.

Make Agent Fast valida el token del bot con el endpoint de aplicación de Discord y rechaza una Public Key que no coincida con la aplicación. Si el Application ID tiene un error de escritura, lo normaliza al ID real de la aplicación autenticada y, a continuación, crea o actualiza el comando global /ask question sin eliminar otros comandos de la aplicación.

Tras guardar, copia la Interactions Endpoint URL que se muestra en General Information → Interactions Endpoint URL en Discord y guarda los cambios. Discord envía un PING firmado; Make Agent Fast valida la firma y devuelve el PONG requerido.

Instala y prueba#

Usa los ajustes de instalación de Discord para autorizar la aplicación en un servidor de prueba con los permisos necesarios para los comandos de aplicación. La propagación de los comandos globales puede tardar un tiempo.

Ejecuta /ask, completa la opción obligatoria question y envíala. Make Agent Fast confirma la interacción antes del breve plazo límite de Discord, ejecuta el agente y luego edita la respuesta original diferida. El historial de conversación se limita a cada usuario de Discord, de modo que las siguientes solicitudes de /ask puedan conservar el contexto.

El conector actual solo admite texto. No lee canales de voz, archivos adjuntos, mensajes ordinarios de canal ni mensajes directos; solo la interacción /ask registrada llega al agente.

Rota o desconecta#

Si el token del bot queda expuesto, restablécelo en Discord, actualiza el conector y verifica /ask de nuevo. Si cambia la propia aplicación, actualiza los tres valores y la Interactions Endpoint URL correspondiente a esa aplicación.

Al desactivar o eliminar el conector no se borran la aplicación de Discord ni el comando global. Quita la aplicación de los servidores y elimina por separado las credenciales obsoletas del proveedor cuando la des instales definitivamente.

Solución de problemas#

SíntomaSolución
El conector rechaza los camposUsa el token del bot y la Public Key de 64 caracteres de la misma aplicación
Discord rechaza el endpointConfirma que sea HTTPS público, pega el endpoint generado y vuelve a guardar las credenciales antes de reintentar
Falta /askConfirma la instalación/autorización del comando, espera a la propagación global y vuelve a conectar para registrarlo de nuevo
La interacción indica que la aplicación no respondióComprueba que el conector esté activado y revisa los errores de Make Agent Fast/Discord; la validación de la firma del endpoint debe ser correcta
Se ignoran otros mensajes del chatEs lo esperado; la integración solo gestiona /ask
La respuesta aparece truncadaLas respuestas en mensajes de Discord están limitadas a 2000 caracteres

Nunca expongas el token del bot en código de cliente, repositorios, registros ni capturas de pantalla.