Une commande personnalisée est une automatisation dont le déclencheur est Commande personnalisée : quand un membre tape la commande, le bot exécute le diagramme. Elle apparaît dans la liste des commandes de Discord comme les commandes de Dispatch.IO, mais seulement sur ton serveur.
Créer une commande
- Menu Automatisation › Commandes personnalisées › Nouvelle commande (ou un modèle comme
/regles). - Dans le déclencheur, remplis :
| Champ | Règles |
|---|---|
| Nom de la commande | Minuscules, sans espace : lettres, chiffres, - et _, 32 caractères. Il doit être libre sur ton serveur et ne pas être une commande de Dispatch.IO (/rank, /warn…). |
| Description | Affichée par Discord sous le nom (100 caractères). |
| Options | Jusqu'à 10 options que le membre remplit (voir plus bas). |
| Qui peut l'utiliser | Tout le monde, ou seulement les membres qui ont une permission (gérer les messages, exclure temporairement, gérer les rôles, gérer le serveur, administrateurs). Les autres ne voient pas la commande. |
| Réponses visibles seulement par le membre | Toutes les réponses du bot (actions Répondre) ne sont vues que par celui qui a tapé la commande, même si le bloc Répondre n'a pas cette option. |
- Ajoute des actions : le plus souvent une action Répondre.
- Enregistre. La commande est enregistrée sur Discord quelques secondes après (désactiver l'automatisation la retire).
Note
Discord peut mettre un moment à afficher une nouvelle commande ou une modification dans ton application. Si elle n'apparaît pas, recharge Discord (Ctrl + R).
Les options
Chaque option devient une variable utilisable dans les textes et les conditions :
| Type | Ce que le membre choisit | Dans un texte |
|---|---|---|
| Texte | Un texte libre | {option.nom} : le texte |
| Nombre entier, Nombre | Un nombre | {option.nom} : le nombre |
| Oui / non | Vrai ou faux | {option.nom} : true ou false |
| Membre | Un membre du serveur | {option.nom} : sa mention ; {option.nom.id} : son identifiant |
| Salon | Un salon | {option.nom} : sa mention |
| Rôle | Un rôle | {option.nom} : sa mention |
Une option Membre peut aussi être la cible des actions : dans le champ Membre concerné d'une action (rôle, MP, sanction, variable…), choisis « L'option nom de la commande ». Les options obligatoires sont placées avant les autres, comme Discord l'exige.
Exemple : une commande /donner-points membre:<membre> quantite:<nombre> réservée aux modérateurs, avec une action Ajouter à une variable (variable points, quantité {option.quantite}, membre concerné : l'option membre) puis Répondre « ✅ {option.quantite} points donnés à {option.membre} ».
Répondre à la commande
Discord exige une réponse en moins de 3 secondes : le bot met donc la commande « en réflexion » tout de suite, puis :
- la première action Répondre remplace ce message d'attente ; les suivantes sont envoyées en messages de suite ;
- si aucune action ne répond, le message d'attente est supprimé (il reste « ✅ C'est fait. » seulement quand les réponses sont visibles par le membre seul) : pour poster un message sous la commande, utilise Répondre plutôt qu'Envoyer un message ;
- si l'automatisation échoue, le bot affiche l'erreur en clair au membre ;
- si l'automatisation est en recharge, le membre voit « ⏳ Cette action est en recharge… ».
Les autres actions (envoyer un message dans un salon, donner un rôle…) fonctionnent normalement ; le « salon du déclencheur » est le salon où la commande a été tapée.
Limites
- 2 commandes en Free, 5 en Basic, 10 en Ultimate (quota séparé de celui des automatisations).
- Discord accepte 100 commandes par serveur et par application au plus.
- Une commande désactivée, supprimée ou au-delà du quota disparaît de Discord ; un membre qui l'utiliserait avant la mise à jour de son application voit « Cette commande n'est plus disponible ».