Déclencheurs
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
Section intitulée « 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
Section intitulée « 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
Section intitulée « Les déclencheurs »Une automatisation n’a qu’un seul déclencheur. La palette en compte quarante-deux, rangés par famille.
| 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, une fois par rôle quand plusieurs bougent en même temps. |
| Surnom modifié | Le surnom d’un membre sur le serveur change, qu’il le fasse lui-même ou non. Un changement de nom global Discord ne compte pas. |
| Boost du serveur | Un membre commence à booster. Discord ne signale pas les boosts suivants d’un membre qui boostait déjà. |
| Arrivée par invitation | Un membre arrive par une invitation que le bot a pu identifier. |
| Passage de niveau | Un membre gagne un niveau. |
Messages et vocal
Section intitulée « Messages et vocal »| Déclencheur | Quand il part |
|---|---|
| Message envoyé | À chaque message posté par un humain. |
| Message modifié | Un membre modifie le texte d’un de ses messages. L’ajout d’un aperçu de lien ou l’épinglage ne comptent pas. |
| Message supprimé | Le message d’un membre est supprimé. Les messages de bots et les suppressions en masse ne comptent pas. |
| Réaction ajoutée / Réaction retirée | Un membre ajoute ou retire sa réaction. Effacer d’un coup toutes les réactions d’un message ne déclenche rien. |
| Arrivée en vocal / Départ du vocal | Un membre rejoint ou quitte un salon vocal. Le départ expose la durée en minutes. |
| Changement de salon vocal | Un membre passe d’un vocal à un autre sans quitter le vocal. |
| Fil créé | Un membre crée un fil ou un post de forum. Les fils créés par un bot ne comptent pas. |
Modération
Section intitulée « Modération »| Déclencheur | Quand il part |
|---|---|
| AutoMod déclenché | L’AutoMod de Kotbo sanctionne un message : spam, invitation, majuscules, émojis, mentions, everyone. |
| Sanction appliquée | Une sanction est prononcée. |
| Sanction levée | Un membre est débanni, ou son exclusion temporaire est retirée avant son terme. |
Structure du serveur
Section intitulée « Structure du serveur »Salon créé, Salon supprimé, Rôle créé, Rôle supprimé : ces quatre déclencheurs partent aussi quand c’est le bot ou une intégration qui agit. Les fils ne comptent pas comme des salons. Après une suppression, l’objet n’existe plus : seul son nom reste utilisable.
Tickets, formulaires et suggestions
Section intitulée « Tickets, formulaires et suggestions »| Déclencheur | Quand il part |
|---|---|
| Ticket créé | Un ticket de support est ouvert. |
| Ticket fermé | Un ticket est fermé, depuis Discord, le dashboard ou l’assistant IA. Supprimer un ticket sans le fermer ne compte pas. |
| Avis sur un ticket | L’auteur d’un ticket fermé donne sa note de 1 à 5. Seule la première note compte, et le commentaire facultatif n’est pas transmis. |
| Formulaire envoyé | Un formulaire personnalisé est envoyé, depuis Discord ou depuis sa page publique. Les réponses arrivent groupées, une ligne Question : réponse par champ rempli. |
| Suggestion publiée | Un membre publie une suggestion. |
| Suggestion traitée | Le staff approuve, refuse ou marque une suggestion comme implémentée. |
Pour un ticket en message privé ou relayé sur le serveur staff, le salon est vide : le filtre de salons écarte alors le dossier.
Animation
Section intitulée « Animation »| Déclencheur | Quand il part |
|---|---|
| Participation à un concours | Un membre rejoint un giveaway. |
| Gagnant d’un concours | Pour chaque gagnant, une fois son lot acquis. Un tirage en attente de validation ne déclenche rien tant que le staff n’a pas validé. |
| Fin d’un concours | À la clôture d’un giveaway, qu’il ait fait des gagnants ou non. |
| Victoire à un mini-jeu | Un membre trouve le nombre mystère ou résout un rébus emoji. |
| 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. |
Partenariats
Section intitulée « Partenariats »Partenariat : changement d’étape part quand un dossier change d’étape, après l’application des avantages - le rôle partenaire est déjà posé. Partenariat : engagement non tenu part au constat d’un manquement, et son champ Périodes manquées permet de ne réagir qu’à partir de la deuxième ou de la troisième fois. Partenariat : arrivée attribuée ne part que pour les arrivées réellement rattachées à l’invitation d’un partenaire.
Voir Partenariats.
La planification
Section intitulée « 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 les Réglages du serveur.
Restreindre le déclencheur
Section intitulée « Restreindre le déclencheur »Plutôt que de filtrer avec une condition, plusieurs déclencheurs se limitent dès la carte du Quand :
- Seulement dans ces salons : salons textuels, vocaux ou catégories entières. Disponible sur les messages, les réactions, le vocal, les fils, l’AutoMod et les tickets. Sur Changement de salon vocal, le filtre porte sur le salon d’arrivée ; sur Fil créé, sur le salon ou le forum parent.
- Seulement pour ces rôles : sur Rôle attribué et Rôle retiré.
- Seulement sur ces messages : sur les réactions, en collant le lien du message (clic droit → Copier le lien). Si rien de ce qui est saisi n’est reconnu comme un message, Kotbo prévient qu’aucune réaction ne passera.
- Seulement pour ces émojis : sur les réactions, en collant les émojis ou en saisissant
:nom:pour un émoji du serveur.
Laissés vides, ces champs acceptent tout le serveur.
Les étapes
Section intitulée « Les étapes »Chaque déclencheur expose des valeurs - le membre, le message, le salon - que les étapes suivantes peuvent utiliser.
Poster : Envoyer un message, Envoyer un embed, Envoyer un message privé (sans effet si les MP du membre sont fermés), Répondre à un message (sans citation si le message a été supprimé entre-temps) et Écrire dans les logs, qui échoue tant qu’aucun salon de logs n’est configuré.
Sur un membre : Ajouter un rôle, Retirer un rôle, Donner un rôle temporaire, 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.
Récompenser et suivre : Donner des pièces, Retirer des pièces (sans descendre sous zéro), Donner de l’XP - avec passage de niveau et rôles de récompense - et Ajouter une note au membre, qui inscrit une ligne datée dans sa note de modération. Enfin, Ouvrir un ticket crée un ticket de support au nom d’un membre.
Conditions et contrôle de flux
Section intitulée « 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.
Dans la vue Étapes, les conditions sont proposées en phrases, et seules celles que le déclencheur peut renseigner apparaissent : le rôle, l’âge du compte, l’ancienneté sur le serveur, la fréquence du membre, le contenu ou la longueur du message, le salon, l’émoji, le type de sanction, le formulaire et ses réponses, le sort d’une suggestion, la note et le type d’un ticket, le code d’invitation, le mini-jeu gagné ou le nombre de membres du serveur.
Dans la vue Graphe, les mêmes tests s’assemblent à la main : Possède le rôle, Salon est, Texte contient, Texte est égal à, Comparer deux nombres, Calcul, Concaténer, ET / OU, NON, ainsi que la longueur d’un texte ou la taille d’une liste.
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, la Fréquence du membre, 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
Section intitulé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
Section intitulée « 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. Deux menus filtrent la liste par statut et par automatisation, le bouton Voir les échecs ne garde que les ratés, et Charger les exécutions plus anciennes remonte le temps. Une exécution en attente affiche sa reprise prévue, et une exécution échouée nomme l’étape fautive.
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
Section intitulée « Gérer la liste »Chaque carte propose Modifier, Dupliquer, Mettre en pause ou Activer, et Supprimer.