Réactions et déclencheurs

Un message qui porte au moins un déclencheur s'appelle un panneau. Un même panneau peut mélanger boutons et réactions.

Depuis le site : l'assistant

La page Réactions de rôles du site propose un assistant en quatre étapes, puis le bouton Déployer sur Discord :

1. Format : Conteneur Discord (Components V2), Embed Discord Classique ou Message Discord existant (ID).
2. Destination et contenu : le salon, puis le titre, la description, la couleur d'accentuation (#5865F2 par défaut) et une image pour un nouveau message.
3. Déclencheurs : pour chacun, le type (Bouton Rôle(s), Bouton Message ou Réaction Emoji), le texte ou l'emoji, le style du bouton (Bleu Blurple, Gris Discord, Vert Succès, Rouge Alerte), son emplacement (dans le conteneur ou en dessous), les rôles ou le message de réponse.
4. Revue, puis déploiement : le bot publie le message, ajoute les boutons et pose lui-même les réactions.

• Le titre et la description proposés par défaut (« 🎭 Rôles & Intérêts », « Cliquez sur les boutons ci-dessous… ») sont en français, quelle que soit la langue du serveur : remplace-les.
• Modifier un panneau met à jour le message, et tous ses déclencheurs sont recréés.
• Supprimer retire les boutons et les réactions du bot ; le message lui-même reste sur Discord.

Depuis Discord : /config

Dans /config → Réaction rôle/message, tu ajoutes des déclencheurs à un message existant (salon + identifiant du message) :

• sur le message d'un membre, uniquement des réactions ;
• sur un message du bot, des réactions, des boutons de rôle ou des boutons de réponse.

Pour créer d'abord un message du bot, utilise /say, /create-embed ou /create-container (voir Messages et annonces). Le détail des champs est dans Configuration du bot.

Un bouton de rôle fonctionne comme un interrupteur, décidé par le premier rôle du bouton :

• si le membre n'a pas ce premier rôle, il reçoit tous les rôles du bouton qui lui manquent ;
• s'il l'a déjà, il perd tous les rôles du bouton qu'il possède.

Le membre reçoit ensuite une confirmation visible de lui seul, dans la langue de son Discord : « Rôles (@Membres) attribués avec succès. » ou « Rôles (…) supprimés avec succès. ».

Messages personnalisés (site)

Sur le site, l'étape Réponse d'un bouton de rôle permet d'écrire tes propres messages : Message si le rôle est ajouté et Message si le rôle est retiré.

• {roles} affiche tous les rôles concernés, {role} le premier.
• Le site pré-remplit « Tu as reçu {roles} ! » et « Tu as perdu {roles}. » : traduis-les si ton serveur est en anglais.
• Si seul le message d'ajout est rempli, il sert aussi au retrait.

Bon à savoir

• Si le bot ne peut pas donner le rôle (permission Gérer les rôles absente, rôle placé au-dessus du sien), le membre ne voit rien : aucun message d'erreur.
• Dans /config, un bouton donne au plus 3 rôles. Les rôles gérés par une intégration et ceux placés au-dessus du rôle du bot sont refusés.
• Un bouton dont le texte est un seul emoji s'affiche comme une icône ; sinon, le texte devient le libellé du bouton.

• Le membre ajoute la réaction : il reçoit les rôles. Il la retire : il les perd. Aucun message n'est envoyé.
• Fonctionne sur n'importe quel message d'un salon textuel, y compris le message d'un membre.
• Le bot pose lui-même la réaction sur le message quand tu crées le déclencheur.
• Si un membre ajoute et retire la réaction très vite, le bot attend 2,5 secondes et applique le dernier état.
• Les super-réactions et les réactions des bots sont ignorées.
• Un emoji personnalisé doit venir de ton serveur.

Un bouton de réponse affiche un message enregistré quand on clique dessus. Exemple : un bouton Règlement qui affiche le règlement complet.

• Créé dans /config : tu choisis un message source (texte, embeds, images, boutons de lien) ; le bot en garde une copie figée. Par défaut, la réponse n'est visible que par le membre (Rendre le message éphémère ? : Oui) ; avec Non, elle est publiée dans le salon.
• Créé sur le site (Bouton Message) : tu écris un texte ; la réponse est toujours visible par le seul membre.

Si la copie ne peut pas être affichée (par exemple une pièce jointe expirée), le bot publie à la place, visible de tous : « Impossible d'afficher le message sauvegardé. » Remplace alors le bouton.

• La limite de panneaux bloque seulement la création : tu peux toujours modifier un panneau existant, et si l'offre baisse, les panneaux existants continuent de fonctionner. Voir Offres Premium et limites.
• Discord impose ses propres limites : 5 boutons par ligne, 20 réactions différentes par message.
• Dans /config, l'ajout d'une réaction se grise dès que le message porte 3 réactions, quelles qu'elles soient.

Le bot garde les déclencheurs à jour tout seul :

• En ouvrant /config → Réaction rôle/message, le bot supprime aussi les déclencheurs des messages qu'il n'arrive plus à lire, même si c'est seulement parce qu'il a perdu l'accès au salon.
• Sur le site, un panneau dont le message n'existe plus est retiré de la liste (« panneau(x) orphelin(s) nettoyé(s) »).
• Chaque création, modification ou suppression faite depuis /config ou le site est notée dans le Salon logs serveur.

Une règle associe un mot à un ou plusieurs emojis. Quand un message contient le mot, le bot y réagit avec ces emojis, dans l'ordre.

• Le mot est cherché n'importe où dans le message, sans tenir compte des majuscules, même à l'intérieur d'un autre mot (chat déclenche aussi sur chaton).
• Le mot peut être une mention (<@id>) : le bot réagit quand ce membre est mentionné.
• Anti-flood : un message qui ne déclenche qu'un mot avec un seul emoji reçoit toujours sa réaction. Quand plusieurs mots correspondent, ou qu'une règle a plusieurs emojis, le bot ne réagit qu'une fois toutes les 10 secondes pour un même membre.
• Ne sont pas concernés : les messages des bots, des comptes de la liste noire de Dispatch.IO et du salon de suggestions.
• Sur le site, une règle peut être désactivée sans être supprimée, et compte jusqu'à 10 emojis.
• Si l'offre baisse, seules certaines règles restent actives, dans la limite de l'offre : le site marque les autres Hors quota.
• Le bot a besoin de Ajouter des réactions (et Utiliser des emojis externes pour les emojis d'un autre serveur).

• Interrupteur sur le premier rôle : un membre qui a le premier rôle d'un bouton perd tous les rôles du bouton en cliquant, même s'il lui en manquait.
• Succès affiché trop tôt sur le site : le message de réussite s'affiche dès que la demande est envoyée. Si le bot échoue (salon inaccessible, permission manquante, deux boutons avec le même texte), la liste ne change simplement pas.
• Deux déclencheurs identiques : un même message ne peut pas porter deux boutons au même texte, ni un bouton au même nom qu'un emoji de réaction.
• Message existant au format conteneur : en mode Message Discord existant (ID), le site ne peut pas ajouter de boutons à un message qui utilise un conteneur ; seules les réactions sont posées.
• Réaction personnalisée supprimée : supprimer le déclencheur d'une réaction avec un emoji personnalisé ne retire pas la réaction du message ; retire-la à la main.
• Bouton orphelin : cliquer sur un bouton dont le déclencheur a été supprimé affiche un texte technique (message_trigger.button.content.message_trigger_not_found).

• Configuration du bot : /config → Réaction rôle/message et Réaction mot.
• Rôles-réactions et Réactions aux mots : les pages du site.
• Messages et annonces : créer un message du bot avec /say, /create-embed ou /create-container.
• Permissions et rôles : placer le rôle du bot au-dessus des rôles à donner.
• Offres Premium et limites : toutes les limites par offre.