Première catégorie de tickets
Une « catégorie » est une catégorie de salons Discord - l'en-tête repliable de la barre latérale. La voie rapide : /setup ; la voie manuelle est en dessous.
Ce que « catégorie » signifie dans TicketCord
Nous utilisons les catégories de salons intégrées à Discord - il n'y a pas de concept séparé à apprendre. Chaque nouveau ticket devient un salon textuel dans la catégorie que vous choisissez, et le bot gère les permissions par salon pour que seuls le demandeur et le staff puissent le voir.
Le chemin rapide : /setup
Au lieu de tout créer à la main, exécutez /setup sur votre serveur. La commande est réservée aux utilisateurs disposant de la permission Discord Administrateur, et elle configure le côté Discord en une seule fois :
- Crée une catégorie Tickets pour les tickets ouverts et une catégorie Closed Tickets.
- Crée deux rôles staff - un rôle Ticket Admin avec toutes les permissions sur les tickets, et un rôle Ticket Support avec accès en lecture et réponse. (Sur le plan gratuit, ils s'appellent TicketCord Admin / TicketCord Support.)
- Applique les surcharges de permissions : les deux rôles staff peuvent voir et agir dans les tickets,
@everyoneest refusé. - Réordonne les nouveaux rôles pour les placer juste sous le rôle du bot, afin que la hiérarchie des rôles de Discord permette au bot de les gérer.
Pour que la commande fonctionne, le bot a besoin soit d'Administrateur, soit de Gérer les salons + Gérer les rôles au niveau du serveur (l'invitation les demande par défaut). Si votre serveur exige la 2FA de Discord pour les actions de modération, le compte qui a créé le bot dans le Discord Developer Portal doit lui aussi avoir la 2FA activée - c'est une règle côté Discord, pas la nôtre.
Si vous avez déjà des catégories ou rôles de type ticket
Avant de créer quoi que ce soit, /setup analyse votre serveur à la recherche de catégories et rôles existants dont les noms ressemblent à une configuration de tickets précédente (par ex. « Tickets », « Closed Tickets », « Ticket Admin », « Ticket Support »). S'il en trouve, vous obtenez trois boutons :
- Utiliser l'existant - garder vos ressources actuelles intactes ; vous les indiquerez vous-même dans le tableau de bord.
- Créer quand même - en créer de nouvelles avec des noms légèrement différents pour éviter les collisions.
- Annuler - abandonner sans rien changer.
Il reste à terminer la configuration sur le site
C'est l'étape que les gens oublient. /setup ne crée que l'infrastructure côté Discord. Il n'indique pas à TicketCord quelles catégories ou quels rôles utiliser - cela se passe dans le tableau de bord. Après avoir exécuté la commande, retournez dans Configuration et sélectionnez les nouvelles ressources dans l'assistant de configuration. Sans cette étape, les tickets ne s'ouvriront toujours pas.
Ou : créez les catégories vous-même
- Sur votre serveur, créez une catégorie nommée par exemple Tickets ouverts.
- Créez éventuellement une seconde catégorie nommée Tickets fermés - TicketCord peut y déplacer les salons résolus au lieu de les supprimer, ce qui est utile pour l'historique d'audit.
- Rendez les deux catégories privées par défaut : dans les permissions de la catégorie, refusez Voir le salon pour
@everyoneet accordez-le à votre rôle staff et au bot TicketCord.
Indiquez-les à TicketCord
Ouvrez l'assistant de configuration dans le tableau de bord, ou allez dans Configuration > Salons. Choisissez la catégorie des tickets ouverts - vous pouvez en choisir plusieurs si vous voulez que les tickets se répartissent entre elles au fur et à mesure qu'elles se remplissent (Discord limite chaque catégorie à 50 salons). Si vous avez créé une catégorie de tickets fermés, définissez-la comme destination des tickets fermés.
Les deux paramètres acceptent une liste, vous pouvez donc ajouter d'autres catégories plus tard sans remplacer celles déjà choisies.
Ce que le bot fait aux permissions
Quand un client ouvre un ticket, TicketCord crée un nouveau salon textuel dans la catégorie des tickets ouverts et ajoute trois surcharges de permissions : refuser Voir le salon à @everyone, accorder au demandeur Voir + Envoyer + Lire l'historique, et accorder la même chose à vos rôles staff. Les permissions au niveau de la catégorie restent intactes.
Étape suivante
Maintenant que les tickets ont un endroit où atterrir, vous êtes prêt à créer un panneau de tickets pour que les clients aient un bouton sur lequel cliquer.