Tout savoir sur FlowBot Engine
Concepts, référence complète des blocs, variables de template, gabarits et limites du moteur — pour construire des workflows Discord fiables sans écrire une ligne de code.
Introduction
FlowBot Engine est un bot Discord construit autour d'un éditeur visuel de blueprints — des graphes de nœuds, façon Unreal Engine ou n8n. Chaque blueprint décrit un workflow : un événement Discord déclenche une chaîne de conditions et d'actions, exécutée en temps réel par le bot.
Aucune ligne de code n'est nécessaire : vous composez le comportement de votre bot en glissant des blocs sur un canvas et en les reliant entre eux, directement depuis le dashboard.
Démarrage rapide
- 1. Invitez le bot — connectez-vous avec Discord depuis le dashboard, puis invitez FlowBot sur le serveur de votre choix.
- 2. Créez un blueprint — dans l'onglet « Commandes personnalisées » de votre serveur, cliquez sur « Nouvelle commande » et choisissez un gabarit ou partez d'un canevas vide.
- 3. Composez et sauvegardez — glissez des blocs, reliez-les, personnalisez les champs propres à votre serveur (rôles, salons), puis sauvegardez.
- 4. Activez — les blueprints créés depuis un gabarit démarrent désactivés par sécurité. Une fois relu et configuré, activez-le depuis la liste des commandes.
Concepts clés
Un blueprint est un graphe de nœuds propre à un serveur, versionné, activable/désactivable indépendamment des autres. Trois catégories de nœuds le composent :
Triggers
Point d'entrée. Un seul port de sortie — rien ne peut se connecter à son entrée.
Conditions
Une entrée, deux sorties : TRUE et FALSE. Le graphe bifurque selon le résultat.
Actions
Une entrée, une sortie séquentielle. S'enchaînent dans l'ordre où vous les reliez.
Exécution : à chaque événement Discord correspondant à un trigger actif, le moteur parcourt le graphe depuis ce trigger, évalue les conditions rencontrées et exécute les actions dans l'ordre. Un port de sortie ne peut être relié qu'à un seul nœud suivant — le flux est linéaire, jamais en éventail.
Les champs texte des actions et conditions supportent des variables de template (voir la référence) résolues au moment de l'exécution.
Triggers
Les événements Discord qui peuvent démarrer un blueprint.
Membre rejoint
Un utilisateur rejoint le serveur
Aucune configuration requise.
Membre quitte
Un utilisateur quitte, est expulsé ou banni du serveur
Aucune configuration requise.
Message envoyé
Un message est posté dans un salon
Aucune configuration requise.
Réaction ajoutée
Une réaction est ajoutée à un message
- · Emoji (optionnel)
- · Message ciblé (optionnel)
Activité vocale
Un membre rejoint/quitte un salon vocal
- · Événement : Rejoint / Quitte / Change de vocal / Tous
- · Salon vocal (optionnel)
Slash command
Votre propre commande /ma-commande
- · Nom de la commande
- · Description
- · Options (nom, type, requis, choix)
Conditions
Chaque condition évalue une expression et route l'exécution vers sa branche TRUE ou FALSE. Les conditions se chaînent librement (une condition peut suivre une autre condition).
Texte contient
Le message contient un texte donné
- · Texte recherché
- · Sensible à la casse
A le rôle
L'utilisateur possède un rôle
- · Rôle
- · Utilisateur ciblé (optionnel)
Dans le salon
L'événement vient d'un salon précis
- · Salon
Chance aléatoire
Continue avec une probabilité en %
- · Probabilité (%)
Compte récent
Le compte Discord a été créé il y a moins de X jours
- · Créé il y a moins de (jours)
- · Utilisateur ciblé (optionnel)
Salon vocal vide
Le salon vocal ciblé ne contient plus personne
- · Salon ciblé (optionnel)
Salon éphémère
Le salon a été créé dynamiquement par un blueprint
- · Salon ciblé (optionnel)
Actions
Les effets que le bot peut exécuter sur votre serveur.
Envoyer un message
Poste un message texte
- · Message
- · Salon (optionnel)
- · Éphémère (slash command)
Envoyer un embed
Poste un message riche (embed)
- · Titre
- · Description
- · Couleur
- · Salon (optionnel)
Message privé
Envoie un DM à un utilisateur
- · Message
- · Utilisateur ciblé (optionnel)
Supprimer le message
Supprime le message déclencheur
Aucune configuration requise.
Ajouter une réaction
Le bot réagit au message avec un emoji
- · Emoji
Épingler le message
Épingle le message déclencheur dans le salon
Aucune configuration requise.
Ajouter un rôle
Donne un rôle au membre
- · Rôle
- · Utilisateur ciblé (optionnel)
Retirer un rôle
Retire un rôle au membre
- · Rôle
- · Utilisateur ciblé (optionnel)
Expulser
Expulse le membre du serveur
- · Raison (optionnel)
Bannir
Bannit le membre du serveur
- · Raison (optionnel)
- · Purge des messages (optionnel)
Timeout (mute)
Réduit temporairement le membre au silence
- · Durée (minutes)
- · Raison (optionnel)
Lever le timeout
Retire la mise en sourdine du membre
Aucune configuration requise.
Changer le pseudo
Modifie le pseudo du membre sur le serveur
- · Nouveau pseudo (vide = réinitialiser)
- · Utilisateur ciblé (optionnel)
Déplacer en vocal
Déplace le membre vers un autre salon vocal
- · Salon vocal cible (optionnel)
- · Utilisateur ciblé (optionnel)
Créer un salon vocal
Crée un salon vocal (ex. hub « rejoindre pour créer »)
- · Nom du salon
- · Catégorie (optionnel)
- · Limite de membres
- · Éphémère
Supprimer un salon
Supprime un salon (par défaut : le dernier créé)
- · Salon ciblé (optionnel)
Hériter des permissions
Synchronise les permissions du salon avec sa catégorie
- · Salon ciblé (optionnel)
Définir une permission
Autorise/refuse une permission pour un rôle ou un membre
- · Salon ciblé (optionnel)
- · Type de cible (Rôle / Membre)
- · Id de la cible
- · Permission
- · Mode (Autoriser / Refuser / Neutre)
Attendre
Pause avant l’action suivante
- · Durée (secondes)
Variables de template
Utilisables dans n'importe quel champ texte (messages, embeds, noms de salon, raisons…). Un token inconnu reste affiché tel quel plutôt que de disparaître silencieusement.
| Token | Description | Exemple |
|---|---|---|
{user} | Mention de l'utilisateur à l'origine du déclenchement | <@123456789012345678> |
{user.id} | Identifiant de l'utilisateur | 123456789012345678 |
{user.name} | Nom d'affichage de l'utilisateur | Koweng |
{channel} | Mention du salon du contexte | <#123456789012345678> |
{channel.id} | Identifiant du salon | 123456789012345678 |
{guild.name} | Nom du serveur | Mon Serveur |
{message.content} | Contenu du message déclencheur | salut tout le monde |
{args.<nom>} | Valeur d'une option de slash command custom | {args.pseudo} |
{last_channel} | Mention du dernier salon créé dans cette exécution (CREATE_VOICE_CHANNEL) | <#123456789012345678> |
{last_channel.id} | Identifiant du dernier salon créé dans cette exécution | 123456789012345678 |
Gabarits
Des blueprints prêts à l'emploi pour démarrer d'un cas d'usage courant plutôt que d'une page blanche, proposés à la création d'une commande.
Bienvenue + rôle automatique
Accueille les nouveaux membres et leur attribue un rôle.
Message de bienvenue (embed)
Une carte de bienvenue soignée pour les nouveaux membres.
Modération — mot interdit
Supprime le message et avertit l’auteur si un mot filtré apparaît.
Rôle par réaction
Réagir à un message avec un emoji donne un rôle.
Hub vocal éphémère
Rejoindre un salon hub crée un salon vocal personnel et y déplace le membre.
Commande /ping
Une slash command simple qui répond pour vérifier que le bot est actif.
Réponse aléatoire amusante
Réagit à un mot-clé avec une chance de déclenchement configurable.
Par sécurité, un blueprint créé depuis un gabarit démarre désactivé : certains filtres (ex. un salon hub) sont volontairement vides tant que vous ne les avez pas personnalisés, ce qui les rendrait sinon dangereusement larges. Relisez et personnalisez avant d'activer.
Limites & sécurité
Des garde-fous protègent chaque exécution contre les boucles infinies et les abus, appliqués côté bot indépendamment de ce que l'éditeur autorise à construire.
| Nœuds exécutés par déclenchement | 20 |
| Nœuds par blueprint | 50 |
| Blueprints par serveur | 25 |
| Durée maximale d'une exécution | 10 min |
| Délai maximum (Attendre) | 5 min |
| Timeout maximum | 28 jours |
| Commandes slash par serveur | 50 |
| Options par commande slash | 25 |
| Membres par salon vocal créé | 99 |
Chaque sauvegarde de blueprint est validée côté serveur avant écriture — jamais de confiance aveugle dans un graphe envoyé par le client.
FAQ
›Mon blueprint ne se déclenche pas, pourquoi ?
›Comment récupérer l'id d'un salon, d'un rôle ou d'un utilisateur ?
›Puis-je relier une sortie à plusieurs nœuds ?
›Pourquoi une action échoue après un trigger « Membre quitte » ?
Message privé et la condition Compte récent fonctionnent en revanche même après un départ, car elles résolvent l'utilisateur au niveau global plutôt que via la liste des membres du serveur.