Quand tu enregistres un réglage sur le tableau de bord, le bot l'applique en général dans la seconde, sans redémarrage. Cette page explique comment le site et le bot restent synchronisés, le délai module par module, et que faire si un changement ne semble pas appliqué.
Elle s'adresse à tous les administrateurs curieux de savoir « quand est-ce que ça marche ? », et à l'équipe pour le détail technique.
Une base de données commune
Le site et le bot ne se parlent pas directement : ils partagent la même base de données et le même serveur Redis (un cache en mémoire qui sert aussi de messagerie), à travers une bibliothèque commune, le config service.
- La base de données garde toute la configuration de ton serveur. Ce que tu enregistres sur le site, le bot le lit au même endroit.
- Redis garde une copie rapide (un cache) des réglages les plus lus, et transporte de petits messages entre le site et le bot.
- Le site lit aussi Discord directement : la liste de tes serveurs, les salons, rôles et emojis affichés dans les sélecteurs. Il ne crée lui-même que quelques éléments (par exemple un salon quand tu cliques sur un bouton de création) ; tout le reste (messages, panneaux, sanctions, commandes) est fait par le bot.
Ce qui se passe quand tu enregistres
- Sauvegarde : le site enregistre ta configuration dans la base et vide le cache correspondant.
- Historique : il ajoute une ligne aux Logs des configurations, avec ton nom et l'avant / après.
- Message au bot : pour la plupart des modules, il publie un message
configUpdatedsur Redis avec le type de configuration et la liste des changements. - Réaction du bot : le bot vide ses propres caches pour ce serveur, relit la configuration, fait ce que le module demande (enregistrer des commandes, publier un panneau, appliquer le mode raid…) et publie un message « Modification d'une configuration » dans le salon de logs, avec ton nom et la source Site Web (Dashboard).
- Mise à jour en direct : le site publie aussi un événement propre à la page ; tous les onglets ouverts sur cette page se mettent à jour (voir plus bas).
Module par module
Appliqués immédiatement, avec un message au bot
| Page du tableau de bord | Ce que fait le bot | Délai | Trace sur Discord |
|---|---|---|---|
| Configuration de base (paramètres essentiels) | Recharge langue, fuseau horaire, séparateur et couleur. | Immédiat | Un message par réglage changé dans Logs Généraux du Serveur. |
| Configuration de base (mentions d'urgence) | Recharge les destinataires des alertes. | Immédiat | Message dans Logs Généraux du Serveur. |
| Salons | Recharge les salons du bot et oublie sa copie des données Discord du serveur. | Immédiat | Un message par salon changé. |
| Bienvenue | Recharge salon, message, image et rôles d'arrivée. | Immédiat | Messages pour le salon, les rôles, le message et l'image. |
| Niveaux | Recharge la configuration, ajoute ou retire /rank, /modify-xp et /reset-levels. Désactiver le système annule les giveaways d'XP en cours. | Immédiat (commandes : quelques secondes) | Messages pour l'activation, l'XP, le salon, les récompenses et l'image. |
| Flammes | Recharge la configuration et les données de flammes en cache. | Immédiat | Aucun. |
| Anti-Raid | Recharge les protections, les mots interdits et les salons de l'anti-raid. | Immédiat | Un message par changement dans Logs Anti-Raid & Sécurité. |
| Sécurité : mode raid | Active ou coupe le mode raid et les actions de cybersécurité Discord (serveur Communauté). | Immédiat | Message dans Logs Anti-Raid & Sécurité. |
| Sécurité : liste blanche | Recharge la liste blanche. | Immédiat | Aucun (sauf une app ajoutée depuis la page Anti-Raid). |
| Autres commandes | Enregistre ou retire les commandes du pack auprès de Discord. | Quelques secondes | Message dans Logs Généraux du Serveur. |
| Tickets (configuration) | Publie, met à jour ou retire le panneau de tickets. | Quelques secondes | Le panneau dans le salon choisi. |
Lus directement dans la base
Pour ces pages, le site vide le cache partagé au moment de l'enregistrement : le bot lit la nouvelle version à sa prochaine utilisation.
| Page | Pris en compte | Trace sur Discord |
|---|---|---|
| Au revoir, Bump | Immédiatement (le site prévient le bot, mais il n'a rien de plus à faire). | Aucune. |
| Réaction mot | Au message suivant. | Aucune. |
| Salons temporaires | Au message suivant. | Aucune. |
| Salons vocaux temporaires | À la connexion vocale suivante. | Aucune. |
| Membres & XP | Immédiatement, sans annonce de passage de niveau ni attribution de rôle. | Aucune. |
Vérifiés à intervalle
| Page | Quand le bot vérifie | Pour aller plus vite |
|---|---|---|
| Réseaux sociaux | YouTube toutes les 2 heures, Twitch toutes les 30 secondes (réglages par défaut). | Vérifier & envoyer : immédiat. |
| Flux RSS | Chaque minute, pour les flux dont l'intervalle est écoulé. | Vérifier & envoyer : immédiat. |
Envoyés au bot comme une action
| Page | Ce qui se passe | Délai |
|---|---|---|
| Rôles-réactions | Le bot publie ou modifie le panneau, ajoute les réactions ou boutons, puis prévient le site, qui met la liste à jour. Si la publication échoue côté Discord, le site n'affiche pas d'erreur. | Quelques secondes |
| Traitement des tickets | Messages, renommage, fermeture, réouverture et sanctions sont exécutés par le bot ; le fil du ticket se met à jour en direct. | Quelques secondes |
Les mises à jour en direct sur le site
Tant qu'une page du tableau de bord est ouverte, le site garde une connexion ouverte avec le serveur (technique Server-Sent Events) et reçoit ces événements :
| Événement | Ce que tu vois |
|---|---|
| Un autre administrateur enregistre la même page de configuration | La page se met à jour et affiche « … mis à jour par nom ». |
| Le bot rejoint ou quitte le serveur | L'écran « Dispatch.IO™ n'est pas sur ce serveur » laisse place à la page, ou l'inverse. |
| Tes rôles changent sur un serveur | Ta liste de serveurs et le menu se mettent à jour. |
| Le mode raid change | Le bandeau de l'accueil du serveur et la page Sécurité se mettent à jour. |
| Activité sur le serveur (commandes, messages, vocal) | La page Statistiques recharge ses chiffres (si Live SSE est actif). |
| Nouveau message ou changement de statut d'un ticket | L'espace de traitement du ticket se met à jour. |
| Paiement ou changement d'abonnement | La boutique et les offres se mettent à jour. |
| Nouvelle notification | La cloche de notifications se met à jour. |
Note
La fin automatique du mode raid ne déclenche pas d'événement : recharge la page Sécurité pour voir l'état à jour.
Dans l'autre sens : de Discord vers le site
- Réglages changés avec
/config: ils sont enregistrés dans la même base, donc visibles sur le site au prochain chargement de la page (pas de mise à jour en direct). Ils n'apparaissent pas dans les Logs des configurations du site, seulement dans Logs Généraux du Serveur sur Discord. - Salons, rôles, emojis, permissions du bot : le site garde une copie des données Discord du serveur pendant 30 minutes. Pour voir tout de suite un salon ou un rôle que tu viens de créer, clique sur Mettre à jour les données en haut de la page (une fois par minute au plus ; sinon « Cooldown actif : encore … »).
- Listes de membres et de bots des sélecteurs : gardées 30 minutes ; seuls les 100 premiers membres sont proposés (tu peux toujours coller un ID Discord).
- Journaux d'audit et Logs des configurations : données gardées 30 secondes, pages rafraîchies toutes les 15 secondes.
Aperçus, tests et vérifications
Certaines actions demandent au bot de faire quelque chose tout de suite et d'attendre sa réponse :
| Action | Ce que fait le bot | Bon à savoir |
|---|---|---|
| Aperçu des cartes (Bienvenue, Au revoir, Niveaux, Bump) | Dessine l'image avec tes réglages et la renvoie au site. | Le site attend 8 secondes au plus : si le bot est hors ligne, l'aperçu échoue. |
| Message de test (Bienvenue, Au revoir) | Envoie un vrai message dans le salon configuré. | Une fois par minute et par serveur. |
| Vérifier & envoyer (Réseaux sociaux, Flux RSS) | Vérifie la chaîne ou le flux immédiatement. | Recharge de 30, 15 ou 10 minutes selon l'offre. |
Si un changement ne s'applique pas
- Vérifie que le bot est en ligne sur ton serveur : si le bot redémarre au moment où tu enregistres, le réglage est bien en base et sera lu (tout de suite ou au plus tard une heure après, selon le module), mais les actions ponctuelles (message de log, enregistrement des commandes, publication d'un panneau) ne sont pas rejouées. Enregistre à nouveau.
- Regarde les Logs des configurations : si ta modification n'y figure pas, elle n'a pas été enregistrée.
- Vérifie les permissions du bot sur Discord : un réglage peut être enregistré mais impossible à appliquer (par exemple sans Gérer les rôles). Voir Permissions et rôles.
- Un salon ou un rôle manque dans un sélecteur ? Clique sur Mettre à jour les données.
- Réseaux sociaux et RSS : attends le passage suivant ou utilise Vérifier & envoyer.
- Nouvelles commandes invisibles : recharge Discord (Ctrl + R).
D'autres pistes sont dans Dépannage du site.
Pages liées
- Journaux : Logs des configurations et journal d'audit.
- Gestion des permissions
- Journaux (module) : les messages de log du bot.
- Redis et base de données : le détail technique (réservé à l'équipe).