KeldrinADMINISTRADOR DE SERVIDORES DEDICADOS

Mensajes y comandos de Discord

Envía notificaciones de tus servidores a un canal de texto de Discord y, si quieres, deja que usuarios aprobados controlen Keldrin con comandos de texto.

Dos opciones independientes

Un webhook entrega mensajes en Discord. Un bot lee comandos y responde. Una configuración solo con webhook no activa el control entrante de los servidores ni retransmite el chat de cada juego.

1. Crea el destino en Discord

Elige un canal de texto que administres. En Discord, abre Server Settings → Integrations → Webhooks (Ajustes del servidor → Integraciones → Webhooks), crea un webhook, dale un nombre reconocible y selecciona el canal de destino. Usa Copy Webhook URL (Copiar URL del webhook). Necesitas permiso para administrar webhooks.

La guía oficial de webhooks de Discord muestra los controles del lado de Discord. Mantén privada la URL completa; quien la tenga puede publicar en su canal.

2. Conecta los mensajes salientes en Keldrin

Abre Discord Integration (Integración con Discord) en la app Keldrin. Activa Discord outbound messages (Mensajes salientes de Discord), pega la URL en Shared webhook URL (automatically saved when you leave the field) (URL del webhook compartido; se guarda automáticamente al salir del campo) y saca el foco del campo para guardarla. Fíjate en la marca de guardado y en el aviso temporal. Deja desactivado el control por bot si solo quieres notificaciones.

Los controles reales de Discord en Keldrin, antes de introducir credenciales. Las URL y los tokens de ejemplo no funcionan.

3. Prueba la configuración guardada

Elige Test Discord end to end (Probar Discord de extremo a extremo). Una prueba saliente real publica un mensaje en el canal seleccionado. Revisa tanto el resultado en Keldrin como el canal. Una prueba correcta significa que Discord aceptó la entrega; no inicia ni detiene ningún juego.

4. Si quieres, activa los comandos

En el Discord Developer Portal, crea una aplicación y su bot. Añade el bot al mismo servidor de Discord y dale View Channel (Ver canal), Read Message History (Leer el historial de mensajes) y Send Messages (Enviar mensajes) en el canal del webhook. Configura el acceso al contenido de los mensajes para ese bot cuando Discord lo exija. Keldrin consulta periódicamente los mensajes del canal y necesita su texto para reconocer comandos. Consulta los requisitos de contenido de mensajes de Discord.

Copia el token del bot en privado. En Keldrin, activa Discord control in the shared webhook channel (Control de Discord en el canal del webhook compartido), introduce el token del bot (de solo escritura) y revisa Allowed control users (Usuarios con control permitido). El valor predeterminado es everyone (todos): cualquier usuario humano válido de ese canal puede enviar comandos. Sustitúyelo por ID de usuario de Discord separados por comas para restringir el control. El modo desarrollador de Discord habilita Copy User ID (Copiar ID de usuario).

Keldrin deduce el canal y el servidor a partir del webhook compartido. En el panel actual de la app Keldrin no se introducen ID de canal ni de servidor por separado. Sal del campo editado para guardar y vuelve a probar. Como primer comando inofensivo, envía !keldrin help en ese canal. Usa la ayuda que recibes para ver los comandos de juego registrados actualmente. Las respuestas pueden tardar unos segundos porque los comandos se consultan periódicamente.

5. Elige los avisos de servidores en ejecución

Después de guardar los mensajes salientes con un webhook, usa Running server heartbeats (Avisos periódicos de servidores en ejecución) en Integración con Discord. Actívalos o desactívalos y elige Every (Cada) 20, 40, 60 o 180 minutos. No se envía ningún aviso periódico cuando todos los servidores están detenidos. Los anuncios de inicio de servidor usan los mismos datos disponibles del servidor; si faltan datos de jugadores o de estado listo, deben quedar como desconocidos.

La captura de arriba, generada a partir de Keldrin 0.9.142, muestra los controles actuales de avisos periódicos.

Cómo se ve un resultado correcto

Solo demo interactiva: conectado, webhook y token configurados y un éxito reciente. No se envió ningún mensaje a Discord para crear este ejemplo.

Si faltan mensajes o comandos

  • Sal del campo editado para guardar antes de probar; la prueba usa los valores protegidos guardados.
  • Comprueba que el webhook sigue existiendo y apunta al canal correcto.
  • Para los comandos, revisa que el bot sea miembro del servidor, el acceso al canal, el acceso al contenido de los mensajes y la lista de usuarios permitidos.
  • Envía los comandos como usuario humano en el canal compartido. Los mensajes de bots y webhooks se ignoran.
  • Si un webhook o token de bot quedó expuesto, regenéralo en Discord y sustituye su valor guardado en Keldrin.

Los secretos guardados están protegidos para el usuario actual de Windows. Los campos de solo escritura en blanco conservan el secreto guardado; si cambias a otra cuenta de Windows, tendrás que volver a introducirlo. Web local muestra el estado y nunca acepta estas credenciales.

Pruébalo sin cambiar nada

La demo interactiva usa la interfaz actual de la Web local con servidores ficticios, en inglés. Todos los resultados son simulados; no transfiere archivos ni cambia ningún sistema real.

Interfaz real de la Web local de Keldrin · datos de demostración sintéticos