Tickets

Système de support privé : un membre clique sur un bouton, le bot crée un channel dédié avec lui et le staff. À la fermeture, un transcript HTML est généré et archivé.

Activer : /setup → bouton Tickets, ou /config module nom:tickets actif:true

Setup

1. Configurer

/tickets config categorie:#Tickets staff_role:@Staff log_salon:#tickets-log message_accueil:"Bonjour {user}, décris ton problème en détail."

Option	Description
categorie	Catégorie Discord où créer les channels (recommandé : restrictée au staff par défaut)
staff_role	Rôle ajouté à chaque ticket (peut voir tous les tickets)
log_salon	Salon où poster le récap à la fermeture (avec lien vers le transcript)
message_accueil	Premier message dans le ticket (variable {user} disponible)

Permission requise : Manage Server.

2. Créer le panel

Va dans le salon où tu veux que les membres ouvrent leurs tickets, et tape :

/tickets setup titre:"Besoin d'aide ?" description:"Clique sur le bouton ci-dessous pour ouvrir un ticket privé."

Le bot poste un embed avec un bouton 🎫 Ouvrir un ticket. Les membres cliquent dessus pour créer leur ticket.

Vie d'un ticket

1. Membre clique sur Ouvrir un ticket
2. Bot crée un channel privé dans la catégorie configurée, accessible au membre + au staff role
3. Bot poste le message d'accueil avec un bouton 🔒 Fermer
4. Membre et staff échangent
5. Bouton 🔒 Fermer → bot demande confirmation, archive le channel, génère le transcript HTML et le poste dans le log_salon

Commandes

/tickets list [limit]

Liste les tickets ouverts du serveur (1–25, défaut 10).

Permission requise : Manage Messages.

/tickets history membre [limit]

Historique des tickets d'un membre (ouverts + fermés).

Permission requise : Manage Messages.

/tickets config

Sans option → affiche la config actuelle. Avec options → modifie les options correspondantes.

/tickets setup

Crée un panel d'ouverture dans le salon courant. Tu peux avoir plusieurs panels (par exemple un par catégorie de support).

Transcripts

À la fermeture, le bot génère un fichier HTML avec :

• Tous les messages échangés (texte, embeds)
• Liens vers les pièces jointes
• Métadonnées (auteur, date, ID du ticket)

Stocké côté serveur du bot dans data/transcripts/<guildId>/<ticketId>.html. Le lien posté dans le log_salon ouvre directement ce fichier (uniquement accessible si l'admin a configuré un serveur statique pour les exposer).

Limites

• Pas de catégories de tickets pour l'instant (1 panel = 1 type)
• Pas de rating après fermeture (à venir)
• Le bot a besoin de Manage Channels et Manage Roles pour gérer les permissions

Dashboard

/servers/<guildId>/tickets propose :

• Configuration des options
• Liste des tickets ouverts/fermés
• Lien direct vers les transcripts