Discord

Cómo funciona Discord aquí

Los miembros llegan al bot mediante un comando de barra, no escribiendo normalmente. Escribir /ask ¿cuánto cuesta el envío? obtiene respuesta; escribir ¿cuánto cuesta el envío? en el canal no.

Eso es intencionado. Un bot que lee cada mensaje de un servidor necesita un acceso mucho más amplio a las conversaciones de tu comunidad, y gastaría tus créditos en charlas en las que nunca fue invitado a participar. El comando de barra mantiene privado el resto de tu servidor y deja a tus miembros el control de cuándo escucha el bot.

Añadir al servidor (un clic)

Abre Configuraciones → Canales en la barra lateral del panel y, en la tarjeta Discord, elige Autorizar. El diálogo se abre con Añade el bot de ProxyAI a tu servidor y su botón Añadir al servidor.

1. Elige Añadir al servidor. La pantalla de permisos de Discord se abre en una pestaña nueva.
2. Elige el servidor. Necesitas el permiso Gestionar servidor en él; es la regla de Discord para añadir cualquier app, no la nuestra.
3. Elige Autorizar. Vuelves a tu panel de ProxyAI.

Los miembros pueden usar /ask en ese servidor. No hay nada que crear, nada que configurar y ningún sitio de desarrolladores que visitar.

El bot pide dos permisos: Ver canales y Enviar mensajes. El comando de barra funciona sin ninguno de los dos; son los que permiten que una persona de tu equipo responda al canal desde la bandeja de ProxyAI.

Para añadir un segundo servidor, elige Añadir al servidor otra vez y selecciónalo. Para quitar el bot, elimínalo del servidor en Discord.

Una particularidad conviene conocerla: el elemento Volver a comprobar del menú de la tarjeta solo mira los ajustes avanzados de abajo, así que después de una instalación con un clic indica «No configurado». La conexión está bien; confírmalo ejecutando /ask en tu servidor.

Avanzado: usa tu propio bot

Elige esta opción cuando quieras que el bot lleve tu propio nombre e imagen, un comando distinto de ask o que responda a mensajes directos. Implica crear una aplicación en el sitio de desarrolladores de Discord, así que requiere más esfuerzo.

1. Abre el Portal de desarrolladores de Discord y elige New Application. El nombre que le pongas es el que verán los miembros.
2. Abre la pestaña Bot, elige Reset Token y copia el Bot Token. Discord lo muestra una sola vez.
3. Abre General Information y copia la Public Key. ProxyAI la usa para confirmar que las peticiones llegan realmente de Discord.
4. En el diálogo de ProxyAI, debajo de Avanzado, trae tu propio bot, pega ambos valores.
5. Opcionalmente, define un nombre de Comando de barra: en minúsculas, sin espacios. Déjalo en blanco para ask.
6. Elige Guardar.

El diálogo muestra además una URL de endpoint de interacciones, con botón de copiar. No la necesitas: al guardar, se comprueba tu bot, se crea el comando de barra y tu aplicación apunta a ProxyAI automáticamente.

Luego invita a tu bot:

1. Portal de desarrolladores → Installation.
2. En Installation Contexts, activa Guild Install para servidores, y también User Install si quieres que el bot responda a mensajes directos.
3. En Default Install Settings, asigna los ámbitos applications.commands y bot y el permiso Enviar mensajes.
4. Copia el Install Link, ábrelo y elige tu servidor.

Ambos valores son secretos. Si alguno se filtra, reinicia el token en el sitio de Discord y guarda el nuevo aquí.

Pruébalo

En un servidor donde el bot esté instalado, escribe /ask y envía una pregunta. Discord muestra que el bot está pensando, y la respuesta llega unos segundos después.

• El comando no aparece: un comando recién creado puede tardar hasta una hora en llegar a todos los servidores, y Discord guarda la lista en caché por dispositivo. Espera y recarga con Ctrl+R (Cmd+R en Mac). Comprueba que el bot se invitó con el ámbito applications.commands.
• «Este servidor aún no está conectado a un asistente»: el bot está en el servidor, pero ningún bot de ProxyAI lo ha reclamado. Ejecuta Añadir al servidor desde tu panel.
• «Este asistente funciona dentro de un servidor»: escribiste en privado al bot compartido de ProxyAI. El bot compartido solo responde dentro de servidores; los mensajes directos requieren tu propio bot con User Install activado.
• «La aplicación no respondió»: la respuesta tardó demasiado o la conexión fue rechazada. En la vía avanzada, guarda de nuevo los ajustes de Discord.
• El guardado falla con un error de token no válido: el token se restableció después de copiarlo. Restablécelo otra vez y pega el valor nuevo.
• Una respuesta humana nunca llega: al bot le falta Enviar mensajes en ese canal concreto. Revisa los permisos de ese canal, no solo el rol de servidor.

Conversaciones y privacidad

En la bandeja de agentes, una conversación pertenece a un canal de Discord, no a un miembro concreto. En un canal compartido, todos los que usen el comando allí comparten un mismo historial, y una respuesta humana es visible para todo el canal. Los mensajes directos, si los activas, siguen siendo privados para cada miembro.

El bot solo ve el texto escrito en el comando. Todo lo demás que se diga en tu servidor queda fuera de ProxyAI.