Les automatisations te permettent de programmer le bot sans écrire une ligne de code : « quand il se passe ceci, si telle condition est vraie, alors fais cela ». Un rôle donné 10 minutes après l'arrivée, un message privé de bienvenue, un rappel chaque vendredi, une commande /regles, un salon de suggestions qui ajoute 👍 et 👎 tout seul… tout se construit en reliant des blocs dans un diagramme.
Cette page présente les notions de base. Pour la prise en main de l'éditeur, voir L'éditeur.
Où trouver les automatisations
Dans le tableau de bord de ton serveur, le groupe Automatisation du menu de gauche contient quatre pages :
| Page | Contenu |
|---|---|
| Automatisations | La liste de tes automatisations, leurs interrupteurs et leurs statistiques. |
| Commandes personnalisées | Tes propres commandes slash, chacune reliée à une automatisation (voir Commandes personnalisées). |
| Variables | Les compteurs et valeurs que tes automatisations retiennent (voir Variables). |
| Historique | Toutes les exécutions des 14 derniers jours, avec le chemin suivi et les erreurs. |
- Nouvelle automatisation ouvre l'éditeur ; Modèles propose une vingtaine d'automatisations prêtes à l'emploi ; Importer charge un fichier exporté.
- Compteurs : automatisations enregistrées / maximum de ton offre, exécutions et erreurs des 14 derniers jours.
- Recherche et filtres : par nom, par état (activées, désactivées, en erreur) et par type de déclencheur.
- Une carte par automatisation : son déclencheur, son interrupteur, ses badges (pause, échecs, hors quota) et un petit graphe de ses exécutions sur 14 jours.
Note
Le module peut être désactivé depuis l'accueil du serveur (tuile Automatisations) : le bot n'exécute alors plus aucune automatisation, sans rien supprimer.
Déclencheur, conditions, actions
Une automatisation est un diagramme qui part toujours d'un seul déclencheur :
| Bloc | Rôle | Exemples |
|---|---|---|
| Déclencheur | Ce qui lance l'automatisation. Un seul par automatisation. | Un membre rejoint, un message est envoyé, tous les jours à 9 h, une commande /points… |
| Condition | Une question : la suite part par la sortie Oui ou par la sortie Non. | A un rôle, âge du compte, le texte contient un mot, plage horaire, hasard… |
| Action | Ce que fait le bot. | Envoyer un message, donner un rôle, réagir, exclure temporairement, attendre, ajouter des points… |
| Branches au hasard | Choisit une sortie au hasard (2 à 5), selon des poids. | Trois messages de bienvenue différents. |
Les listes complètes sont dans Déclencheurs, Conditions et Actions.
Comment le bot exécute une automatisation
- L'événement se produit sur Discord (un membre arrive, un message est posté…). Le bot cherche les automatisations activées du serveur dont le déclencheur correspond, en tenant compte de ses réglages (salons surveillés, texte recherché, rôles…).
- Pour chacune, il vérifie les garde-fous (voir plus bas) : bots ignorés, délai de recharge, anti-boucle.
- Il suit le diagramme depuis le déclencheur : chaque condition choisit sa sortie, chaque action est faite l'une après l'autre. Quand une sortie mène à plusieurs blocs, ils sont faits dans l'ordre du diagramme, de haut en bas puis de gauche à droite.
- L'exécution est enregistrée dans l'historique : qui l'a déclenchée, le chemin suivi, la durée et l'éventuelle erreur.
Une action Attendre met la suite de côté : elle est reprise à l'heure prévue, même si le bot redémarre entre-temps (jusqu'à 7 jours). Une action Arrêter termine l'exécution.
Important
Si une action échoue (permission manquante, rôle au-dessus du bot, membre parti…), l'exécution s'arrête à cette étape et l'erreur est expliquée dans l'historique. Après 10 échecs d'affilée, le bot met l'automatisation en pause et les gestionnaires du serveur reçoivent une notification sur le site.
Les garde-fous
Les automatisations sont puissantes ; le bot les encadre pour éviter les catastrophes :
| Garde-fou | Effet |
|---|---|
| Bots ignorés | Par défaut, un bot ou un webhook ne déclenche jamais une automatisation (réglable dans Paramètres). Les messages du bot lui-même ne déclenchent jamais rien. |
| Délai de recharge | Optionnel : temps minimum entre deux exécutions, par membre, par salon ou pour tout le serveur. |
| Anti-boucle | Le diagramme ne peut pas revenir sur une étape précédente. Une automatisation qui se relance plus de 8 fois en 10 secondes pour le même membre est mise en attente un instant. |
| Imbrication | Une automatisation peut en lancer une autre, sur 3 niveaux au maximum. |
| Plafonds | 100 étapes par exécution, 240 actions par minute sur le serveur, dont 20 actions de modération (exclusion, expulsion, bannissement, suppression de messages). |
| Rôles protégés | Le bot ne donne jamais un rôle au-dessus du sien, géré par une application, ou qui donne des droits de modération (administrateur, gérer les rôles, bannir…). |
| Modération | Les actions de modération ne touchent jamais le propriétaire du serveur, le bot lui-même, ni un membre au-dessus du bot. |
| Mentions | Les messages des automatisations peuvent mentionner des membres et des rôles, jamais @everyone ni @here. |
Limites selon l'offre
| Free | Basic | Ultimate | |
|---|---|---|---|
| Automatisations | 2 | 5 | 10 |
| Commandes personnalisées | 2 | 5 | 10 |
| Variables | 50 | 50 | 50 |
| Historique | 14 jours | 14 jours | 14 jours |
Toutes les fonctions (déclencheurs, conditions, actions, modèles, tests, versions) sont disponibles dans toutes les offres : seul le nombre change. Les automatisations et les commandes ont chacune leur quota.
Si ton offre baisse (abonnement terminé), rien n'est supprimé : les premières automatisations de la liste restent actives dans la limite de la nouvelle offre, les suivantes portent le badge Hors quota et ne s'exécutent plus. Voir Abonnement du serveur.
Qui peut les gérer
Comme les autres pages du serveur : le propriétaire, les membres qui ont Administrateur ou Gérer le serveur sur Discord, et le staff Dispatch.IO autorisé depuis Autorisation d'édition. Chaque création, modification, suppression et activation est inscrite dans les Logs des configurations du serveur (catégorie Automatisations).
Voir Gestion des permissions.