Déclencheurs (Automatisations)

Une automatisation associe un déclencheur à une suite d’étapes : quand tel événement se produit sur le serveur, le bot fait telle chose. Tout se compose visuellement, sans écrire de code.

Deux façons d’écrire la même chose

Une automatisation est un graphe. Deux vues travaillent dessus, et rien n’est jamais converti de force :

Étapes : l’automatisation se lit comme une suite de phrases - Quand …, Si …, Alors …. C’est la vue par défaut.
Graphe : un canevas de blocs reliés entre eux, avec une palette. Elle prend la main d’office sur les automatisations qui ne s’expriment pas linéairement - une boucle, un aiguillage - et Kotbo le signale : Cette automatisation utilise des blocs qui ne s’expriment pas sous forme d’étapes.

Créer une automatisation

Le bouton Nouvelle automatisation propose de partir d’un modèle prêt à l’emploi ou d’une page blanche.

Modèle	Ce qu’il fait
Message de bienvenue	Accueillir chaque arrivée dans un salon et lui donner son rôle de départ.
Surveiller les comptes récents	Signaler au staff les arrivées dont le compte Discord a moins d’une semaine.
Bloquer les invitations	Exclure temporairement qui poste un lien d’invitation vers un autre serveur.
Récompense de niveau	Féliciter publiquement un membre qui monte de niveau.
Accueil des tickets	Poster les consignes dès l’ouverture d’un ticket de support.

Les modèles sont prêts à l’emploi : il ne reste qu’à choisir les salons et les rôles.

Les déclencheurs

Une automatisation n’a qu’un seul déclencheur.

Déclencheur	Quand il part
Arrivée d’un membre	Un membre rejoint le serveur.
Départ d’un membre	Un membre quitte le serveur.
Rôle attribué / Rôle retiré	Un rôle est ajouté ou retiré à un membre.
Message envoyé	À chaque message posté par un humain.
Réaction ajoutée	Un membre réagit à un message.
Arrivée en vocal / Départ du vocal	Un membre rejoint ou quitte un salon vocal.
Ticket créé	Un ticket de support est ouvert.
Sanction appliquée	Une sanction est prononcée.
Passage de niveau	Un membre gagne un niveau.
Planification	À heure fixe, selon une planification récurrente.
Pari tranché / Pari annulé	Un arbitre désigne le camp gagnant, ou les mises sont rendues.
Dette de clan creusée / soldée	Un membre mise des points qu’il n’a pas, ou finit de rembourser.

La planification

Le déclencheur Planification se règle de façon guidée - toutes les heures, tous les jours, toutes les semaines, tous les mois, avec l’heure et le jour - ou par un motif avancé : un motif cron à cinq champs.

L’heure est interprétée dans le fuseau du serveur, réglé depuis l’accueil du dashboard.

Les étapes

Chaque déclencheur expose des valeurs - le membre, le message, le salon - que les étapes suivantes peuvent utiliser.

Actions

Poster : Envoyer un message, Envoyer un embed, Envoyer un message privé (sans effet si les MP du membre sont fermés).

Sur un membre : Ajouter un rôle, Retirer un rôle, Changer le surnom, Exclure temporairement, Expulser, Bannir (définitivement ou pour une durée donnée).

Sur un message : Supprimer un message, Réagir à un message, Épingler un message, Ouvrir un fil.

Enfin, Ouvrir un ticket crée un ticket de support au nom d’un membre.

Conditions et contrôle de flux

Si : n’exécuter la suite que dans certains cas. Une condition se lit toutes ces conditions ou au moins une condition, et se range en Alors / Sinon.
Aiguillage : compare une valeur texte à une liste de cas.
Pour chaque : parcourt une liste et exécute le corps de boucle pour chaque élément.
Attendre : suspend l’exécution. Elle reprend même après un redémarrage du bot.

Les tests disponibles couvrent Possède le rôle, Salon est, Texte contient, Texte est égal à, Comparer deux nombres, ET / OU, NON, ainsi que la longueur d’un texte ou la taille d’une liste.

Valeurs

Les blocs de données fournissent un Texte, un Nombre, un Booléen, un Texte composé (dans lequel des valeurs du contexte viennent s’insérer), Un rôle ou Un salon du serveur, et les propriétés du membre, du message, du salon ou du serveur.

Dans la vue Étapes, salons, rôles et textes se saisissent directement sur la carte, sans créer de bloc de donnée.

Enregistrer

Kotbo valide le graphe avant d’enregistrer et liste les problèmes à corriger : Commencez par poser un bloc déclencheur, Un champ de cette étape reste à remplir, N étape(s) restent à compléter avant l’enregistrement. Quand tout est correct : Le graphe est valide.

Une automatisation enregistrée démarre en pause ; l’interrupteur de sa carte l’active.

Suivre ce qui s’exécute

La liste filtre par Toutes, Actives ou En pause, et chaque carte affiche son nombre d’exécutions, son taux de réussite et sa dernière exécution.

L’onglet Exécutions liste les passages avec leur statut - En cours, En attente, Terminée, Échouée, Annulée - et le nombre de blocs parcourus. Cliquez sur une exécution pour la rejouer sur le graphe : le parcours se replay étape par étape, avec les entrées et sorties consignées à chaque bloc.

Gérer la liste

Chaque carte propose Modifier, Dupliquer, Mettre en pause ou Activer, et Supprimer.