Intégration Discord

Chemin backoffice : backoffice/settings/discord

Accessible aux rôles : Administrateur Système, Administrateur

Aperçu

L'Intégration Discord connecte votre tenant Airspace à une guilde (serveur) Discord, permettant les annonces automatisées, les canaux de communication du personnel et la liaison optionnelle des comptes pilotes. Cette intégration utilise le bot Airspace pour interagir avec votre serveur Discord au nom de votre compagnie.

Configuration Initiale

Pour connecter votre compagnie à un serveur Discord :

1. Naviguez vers backoffice/settings/discord.
2. Cliquez sur le bouton Connecter (ou Autoriser) pour démarrer le flux d'autorisation OAuth.
3. Vous serez redirigé vers Discord pour autoriser le bot Airspace à rejoindre votre guilde.
4. Sélectionnez le serveur Discord que vous souhaitez connecter et accordez les permissions demandées.
5. Après la fin de l'autorisation, vous êtes redirigé vers le backoffice et l'intégration est liée.

Le bot doit avoir des permissions suffisantes dans votre serveur Discord pour lire les canaux, envoyer des messages et gérer les rôles selon les besoins.

Configuration

Une fois le bot connecté à votre guilde, configurez les options suivantes :

Canal d'Annonces

Sélectionnez un canal dans la liste des canaux de votre guilde où le bot publiera les annonces automatisées. Les messages publiés dans ce canal incluent :

• Alertes nouveau tenant — Notifications pertinentes pour les opérations de votre compagnie
• Soumissions de formulaire de contact — Lorsque quelqu'un soumet un formulaire de contact, le message est relayé vers ce canal

Canal du Personnel

Sélectionnez un canal séparé désigné pour les communications réservées au personnel. Ce canal est destiné aux messages opérationnels internes visibles uniquement par votre équipe administrative.

Statut Actif

Activez ou désactivez l'intégration. Lorsque désactivée, le bot reste connecté à votre guilde mais cesse d'envoyer des messages et de traiter les événements. La réactiver reprend le fonctionnement normal sans nécessiter de réautorisation.

Déconnexion

Cliquez sur le bouton Déconnecter pour dissocier complètement le bot Airspace de votre serveur Discord. Cela supprime l'association de guilde de votre tenant. Pour vous reconnecter, vous devez repasser par le flux d'autorisation OAuth.

Messages de Test

Après avoir configuré vos canaux, utilisez les boutons Message de Test pour vérifier que le bot a les permissions correctes pour publier dans chaque canal sélectionné.

• Un message de test est envoyé dans le canal choisi.
• Si le bot ne dispose pas des permissions requises (par exemple, Send Messages, Embed Links), un message d'erreur spécifique est affiché dans le backoffice indiquant quelle permission est manquante.
• Résolvez tout problème de permission dans les paramètres de votre serveur Discord avant de compter sur l'intégration pour un usage en production.

Classements Mensuels

Chemin backoffice : backoffice/settings/discord (faites défiler jusqu'a la carte "Classements Mensuels")

La fonction Classements Mensuels vous permet d'envoyer manuellement un message de classements a votre canal d'annonces pour un mois specifique. C'est utile pour :

• Renvoyer un message de classements qui a echoue ou a ete manque
• Envoyer les classements d'un mois passe a la demande

Pour l'utiliser :

1. Selectionnez le Mois et l'Annee dans les menus deroulants.
2. Cliquez sur Envoyer les Classements.
3. Un embed enrichi avec les 5 meilleurs pilotes par points, vols et heures pour ce mois sera publie dans votre canal d'annonces.

remarque

Les classements sont egalement envoyes automatiquement le 1er jour de chaque mois a 12h00 UTC pour le mois precedent. L'envoi manuel est une option supplementaire, pas un remplacement.

Liaison de Compte Pilote

Les pilotes peuvent optionnellement lier leur compte Discord depuis leur page de paramètres de profil. Ceci est séparé de l'intégration au niveau du serveur et fonctionne comme suit :

1. Le pilote clique sur un bouton Lier Discord sur sa page de paramètres de profil.
2. Un flux OAuth est initié avec les portées suivantes :
   • identify — Permet à la plateforme de lire le nom d'utilisateur et l'ID Discord du pilote.
   • guilds.join — Permet au bot d'ajouter automatiquement le pilote au serveur Discord de votre compagnie.
3. Après l'autorisation, l'ID utilisateur Discord du pilote est stocké dans son enregistrement utilisateur.

remarque

Les ID utilisateur Discord sont stockés chiffrés dans la base de données pour protéger la vie privée des pilotes. La plateforme ne stocke pas les mots de passe Discord ni les jetons d'accès au-delà de ce qui est nécessaire pour le flux OAuth.

Gestion des Rôles de Guilde

Le bot peut gérer les rôles de guilde pour les membres du personnel dans votre serveur Discord. Cela permet l'assignation automatique de rôles basée sur le rôle Airspace d'un utilisateur, maintenant la structure de rôles de votre serveur Discord synchronisée avec la hiérarchie du personnel de votre compagnie.

Permissions

La gestion de l'intégration Discord nécessite le rôle Administrateur Système ou Administrateur. La configuration fait partie du module de paramètres et suit le même modèle de permissions que les autres paramètres système.