🔀 Éditeur de Flows

Un flow est une petite automatisation que tu dessines en reliant des blocs : quand quelque chose arrive sur ton serveur, alors le bot fait une ou plusieurs choses — éventuellement seulement si une condition est remplie.

Exemple : « quand un membre reçoit le rôle VIP → lui envoyer un message privé → poster une annonce dans #général ».

---

🧱 Les trois familles de blocs

• 🚀 Déclencheurs — le point de départ d'un flow. Chaque flow part d'un déclencheur. Il décrit ce qui se passe : un membre arrive, un message est posté, un rôle est retiré, un salon est supprimé… → Voir tous les déclencheurs
• ⚡ Actions — ce que le bot fait : envoyer un message, donner un rôle, créer un salon, exclure un membre… → Voir toutes les actions
• 🔀 Logique — ce qui organise le flow : conditions, variables, attentes, boucles, mémoire… → Voir tous les blocs de logique

---

✏️ Construire un flow

1. Nouveau → donne un nom à ton flow.
2. Glisse un déclencheur depuis la palette de gauche sur la zone de travail.
3. Ajoute des blocs à la suite et relie-les : tire un fil depuis le point de sortie d'un bloc jusqu'à l'entrée du suivant.
4. Clique sur un bloc pour régler ses paramètres dans le panneau de droite.
5. Enregistre, puis active le flow.

Retrouver un bloc dans la palette

La palette est rangée en 10 sections : Déclencheurs, Messages, Réactions et emojis, Rôles, Modération, Salons, Fils, Vocal, Logique (brancher, attendre, boucler) et Valeurs et stockage (variables, mémoire, listes du serveur, appel d'une URL externe). Survole ou clique une section pour ouvrir ses blocs. Les sections longues (les déclencheurs, les messages, la logique) sont découpées en sous-titres qui suivent les pages de cette documentation : par exemple Membres, Messages, Réactions et interactions, Vocal pour les déclencheurs. Les blocs qui vont par paires (Rôle ajouté / Rôle retiré, Début / Fin de boost, Arrivée / Départ en vocal…) sont côte à côte. Pour aller vite, tape le nom du bloc dans la barre de recherche en haut de la palette : elle cherche dans toutes les sections. Un doute entre deux blocs qui se ressemblent ? Survole-les pour lire leur phrase d'aide, ou ouvre Quel bloc choisir ?.

[!WARNING] Rien n'est sauvegardé automatiquement : pense à Enregistrer avant de quitter la page.

Les sorties multiples

Certains blocs ont plusieurs sorties : un fil part de chacune, et le flow suit celle qui correspond.

• Condition, Aiguillage, Tirage au sort : la sortie suivie dépend du résultat.
• Toutes les actions ont une sortie Suite et une sortie Échec (en rouge) : si Discord refuse l'action, le flow suit Échec et la variable {error} contient la raison. Voir Gérer un échec.
• Appeler une URL externe : sorties réussi / échec.
• Envoyer un message privé : sorties envoyé / échec (les messages privés fermés sont fréquents).
• Pour chaque membre : une sortie « pour chaque membre » (le corps de la boucle) et une sortie « terminé ».
• Certains déclencheurs, comme Arrivée d'un membre, ont des sorties « bloqué » quand un filtre optionnel (avatar par défaut, compte suspect…) l'exige : tu peux ainsi traiter à part les membres refusés.

Une sortie sans fil met simplement fin à cette branche du flow.

---

🧪 Tester un flow

Le bouton Tester lance le flow tout de suite.

[!WARNING] Un test exécute vraiment les actions : un message est envoyé, un rôle est donné, un salon est créé… Les filtres du déclencheur (heures, cooldown, rôle requis…) sont ignorés pour le test, et un flow désactivé peut être testé. Essaie d'abord sur un serveur de test ou avec des actions sans risque.

---

🧩 Variables

Dans les champs texte, tu peux insérer des variables entre accolades — {user}, {server}, {arg}… — qui sont remplacées au moment de l'exécution. Chaque déclencheur fournit les siennes, et certains blocs en créent d'autres (par exemple « Enregistrer l'ID du salon créé dans la variable »).

→ Toutes les variables et leurs règles

---

🛡️ Filtres communs à tous les déclencheurs

Chaque déclencheur propose, en plus de ses réglages propres, des garde-fous optionnels : heures et jours actifs (dans le fuseau de ton choix), anti-spam par membre ou pour tout le serveur, plafond de déclenchements par jour, âge minimum du compte ou de l'ancienneté, taille du serveur, délai avant exécution, et journal de chaque déclenchement dans un salon.

Les actions ont les leurs : ne s'exécuter que pour un rôle, ignorer un rôle ou un salon, ignorer les bots.

→ Le détail des filtres

---

⚠️ Ce qu'il faut savoir

• Les permissions du bot comptent. Si le bot n'a pas le droit de faire une action (ou si le rôle visé est plus haut que le sien), Discord la refuse. Relie la sortie Échec de l'action pour réagir (prévenir un modérateur, essayer autre chose) ; sans elle, le flow continue comme si de rien n'était. Vérifie la hiérarchie de rôles quand quelque chose « ne se passe pas ».
• Les actions sensibles (expulser, bannir, exclure, supprimer un salon ou un rôle, appeler une URL…) sont signalées et ignorées à l'intérieur d'une boucle tant que tu n'as pas coché l'autorisation explicite.
• Des plafonds protègent tous les serveurs : nombre de membres par boucle, messages privés par minute, appels d'URL, taille de la mémoire… → Voir les limites