Documentation

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. 1. Invitez le bot — connectez-vous avec Discord depuis le dashboard, puis invitez FlowBot sur le serveur de votre choix.
  2. 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. 3. Composez et sauvegardez — glissez des blocs, reliez-les, personnalisez les champs propres à votre serveur (rôles, salons), puis sauvegardez.
  4. 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.

TokenDescriptionExemple
{user}Mention de l'utilisateur à l'origine du déclenchement<@123456789012345678>
{user.id}Identifiant de l'utilisateur123456789012345678
{user.name}Nom d'affichage de l'utilisateurKoweng
{channel}Mention du salon du contexte<#123456789012345678>
{channel.id}Identifiant du salon123456789012345678
{guild.name}Nom du serveurMon Serveur
{message.content}Contenu du message déclencheursalut 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écution123456789012345678

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éclenchement20
Nœuds par blueprint50
Blueprints par serveur25
Durée maximale d'une exécution10 min
Délai maximum (Attendre)5 min
Timeout maximum28 jours
Commandes slash par serveur50
Options par commande slash25
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 ?
Vérifiez d'abord qu'il est activé (les blueprints créés depuis un gabarit démarrent désactivés). Vérifiez ensuite que les filtres du trigger (salon, rôle) correspondent bien à votre situation, et que le bot a les permissions Discord nécessaires sur le serveur.
›Comment récupérer l'id d'un salon, d'un rôle ou d'un utilisateur ?
Activez le Mode développeur dans Discord (Paramètres → Avancés), puis clic droit sur l'élément → Copier l'identifiant.
›Puis-je relier une sortie à plusieurs nœuds ?
Non — le flux est linéaire, un port de sortie n'accepte qu'un seul edge. Pour brancher plusieurs cas, utilisez des conditions successives.
›Pourquoi une action échoue après un trigger « Membre quitte » ?
Certaines actions (ajouter un rôle, changer le pseudo, déplacer en vocal) exigent que la cible soit toujours membre du serveur — impossible juste après son départ. Les actions 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.

Prêt à construire votre premier blueprint ?

Ouvrir le dashboard