Integración con Discord

Ruta del backoffice: backoffice/settings/discord

Disponible para roles: Administrador del Sistema, Administrador

Descripción General

La Integración con Discord conecta su tenant de Airspace a un guild (servidor) de Discord, habilitando anuncios automatizados, canales de comunicación del personal y vinculación opcional de cuentas de pilotos. Esta integración utiliza el bot de Airspace para interactuar con su servidor de Discord en nombre de su aerolínea.

Configuración Inicial

Para conectar su aerolínea a un servidor de Discord:

1. Navegue a backoffice/settings/discord.
2. Haga clic en el botón Conectar (o Autorizar) para iniciar el flujo de autorización OAuth.
3. Será redirigido a Discord para autorizar al bot de Airspace a unirse a su guild.
4. Seleccione el servidor de Discord que desea conectar y otorgue los permisos solicitados.
5. Después de que la autorización se complete, será redirigido de vuelta al backoffice y la integración estará vinculada.

El bot debe tener permisos suficientes en su servidor de Discord para leer canales, enviar mensajes y gestionar roles según sea necesario.

Configuración

Una vez que el bot está conectado a su guild, configure las siguientes opciones:

Canal de Anuncios

Seleccione un canal de la lista de canales de su guild donde el bot publicará anuncios automatizados. Los mensajes publicados en este canal incluyen:

• Alertas de nuevo tenant -- Notificaciones relevantes para las operaciones de su aerolínea
• Envíos de formulario de contacto -- Cuando alguien envía un formulario de contacto, el mensaje se transmite a este canal

Canal del Personal

Seleccione un canal separado designado para comunicaciones exclusivas del personal. Este canal está destinado a mensajes operativos internos visibles solo para su equipo administrativo.

Estado Activo

Active o desactive la integración. Cuando está desactivada, el bot permanece conectado a su guild pero deja de enviar mensajes y procesar eventos. Reactivarla reanuda la operación normal sin requerir re-autorización.

Desconectar

Haga clic en el botón Desconectar para desvincular completamente el bot de Airspace de su servidor de Discord. Esto elimina la asociación del guild de su tenant. Para reconectar, debe pasar por el flujo de autorización OAuth nuevamente.

Mensajes de Prueba

Después de configurar sus canales, use los botones de Mensaje de Prueba para verificar que el bot tiene los permisos correctos para publicar en cada canal seleccionado.

• Se envía un mensaje de prueba al canal elegido.
• Si el bot carece de los permisos requeridos (por ejemplo, Send Messages, Embed Links), se muestra un mensaje de error específico en el backoffice indicando qué permiso falta.
• Resuelva cualquier problema de permisos en la configuración de su servidor de Discord antes de depender de la integración para uso en producción.

Rankings Mensuales

Ruta del backoffice: backoffice/settings/discord (desplácese hasta la tarjeta "Rankings Mensuales")

La función de Rankings Mensuales le permite enviar manualmente un mensaje de rankings a su canal de anuncios para cualquier mes específico. Esto es útil para:

• Reenviar un mensaje de rankings que falló o se perdió
• Enviar rankings de un mes pasado bajo demanda

Para usarlo:

1. Seleccione el Mes y el Año de los menús desplegables.
2. Haga clic en Enviar Rankings.
3. Un embed enriquecido con los 5 mejores pilotos por puntos, vuelos y horas de ese mes se publicará en su canal de anuncios.

nota

Los rankings también se envían automáticamente el 1er día de cada mes a las 12:00 UTC para el mes anterior. El envío manual es una opción adicional, no un reemplazo.

Vinculación de Cuentas de Pilotos

Los pilotos pueden opcionalmente vincular su cuenta de Discord desde su página de configuración de perfil. Esto es separado de la integración a nivel de servidor y funciona de la siguiente manera:

1. El piloto hace clic en un botón de Vincular Discord en su página de configuración de perfil.
2. Se inicia un flujo OAuth con los siguientes alcances:
   • identify -- Permite a la plataforma leer el nombre de usuario e ID de Discord del piloto.
   • guilds.join -- Permite al bot agregar al piloto al servidor de Discord de su aerolínea automáticamente.
3. Después de la autorización, el ID de usuario de Discord del piloto se almacena en su registro de usuario.

nota

Los IDs de usuario de Discord se almacenan encriptados en la base de datos para proteger la privacidad del piloto. La plataforma no almacena contraseñas de Discord ni tokens de acceso más allá de lo requerido para el flujo OAuth.

Gestión de Roles del Guild

El bot puede gestionar roles del guild para miembros del personal en su servidor de Discord. Esto habilita la asignación automática de roles basada en el rol de Airspace del usuario, manteniendo la estructura de roles de su servidor de Discord sincronizada con la jerarquía de personal de su aerolínea.

Permisos

Gestionar la integración con Discord requiere el rol de Administrador del Sistema o Administrador. La configuración es parte del módulo de configuración y sigue el mismo modelo de permisos que otras configuraciones del sistema.