Système de tickets
Ouverture, prise en charge, relances, horaires et SLA, résumé par IA, réponses prédéfinies, panel et transcriptions.
Le cœur du bot : un système de support complet, avec ouverture via commande, bouton ou réaction, suivi du statut, de la priorité et de la prise en charge par le staff.
Ouverture d'un ticket
- Via
/ticket create [raison](raison : 1000 caractères maximum) - Via un panel (bouton "Ouvrir un ticket" posté par le staff)
- Via une réaction sur le message du panel
Si des catégories de tickets sont configurées, l'utilisateur choisit une catégorie via un menu déroulant, puis remplit un formulaire : sujet (max 100 caractères) et description (max 1000 caractères). Un salon privé est créé dans la catégorie Discord configurée, visible uniquement par l'utilisateur, le staff et les admins.
Nom des salons de ticket. Par défaut, le salon s'appelle pseudo-numéro (ex : synoxa-42). Tu peux choisir ta propre nomenclature avec /setup ticket-nom et les variables ci-dessous. Le format doit contenir le numéro du ticket, et les tickets déjà ouverts ne sont pas renommés.
| Variable | Rendu |
|---|---|
| {number} | Numéro du ticket (ex : 42) |
| {number:4} | Numéro complété de zéros (ex : 0042) |
| {username} | Pseudo du créateur du ticket |
| {category} | Catégorie choisie |
| {year}, {month}, {day} | Date de création |
# Ex : support-0042 /setup ticket-nom format:{category}-{number:4} # Revenir au format par défaut /setup ticket-nom format:defaut
Gestion d'un ticket ouvert
Sauf mention contraire, ces commandes sont réservées au rôle support configuré avec /setup support et aux administrateurs.
/ticket add <membre>Ajouter quelqu'un au ticket (staff ou créateur du ticket)
/ticket remove <membre>Retirer quelqu'un du ticket (staff uniquement)
/ticket note add <contenu>Note privée, visible uniquement par le staff (jamais par le créateur du ticket)
/ticket info [numero]Vue d'ensemble du ticket (créateur, statut, catégorie, prise en charge, dates, temps de première réponse, confidentialité) et notes privées, dans un message visible par toi seul. Sans numéro : le ticket du salon actuel. Avec un numéro : un ticket du serveur depuis n'importe quel salon (staff uniquement)
/ticket list [membre]Liste les tickets ouverts du serveur (ou d'un membre) avec leur numéro, pour utiliser /ticket info depuis un autre salon (staff uniquement)
/ticket privateRend le ticket privé : le rôle support n'y a plus accès, seuls le créateur, le staff assigné et les administrateurs le voient. Relancer la commande le repasse en normal (staff ou créateur)
/ticket status <valeur>Change le statut de traitement : Ouvert, En cours, En attente ou Résolu. Distinct de l'état ouvert/fermé, jamais modifiable par le client (staff/admin)
/ticket priority <niveau>Fixe la priorité : basse, normale (par défaut) ou urgente. Un ticket urgent est mis en avant (couleur rouge, mention "TICKET URGENT") et relancé deux fois plus vite en cas d'inactivité (staff/admin)
/ticket category <nom>Transfère un ticket déjà ouvert vers une autre catégorie configurée, avec autocomplétion (staff/admin)
/ticket fusion <salon_source>Fusionne un ticket doublon du même utilisateur dans celui-ci : notes privées transférées, résumé posté, puis le doublon est fermé et supprimé (staff/admin)
La première réponse du staff est automatiquement horodatée pour mesurer les temps de réponse (SLA) — voir /ticket stats.
Prise en charge (claim)
Fonction optionnelle, désactivée par défaut. Active-la avec /setup ticket-claim : un bouton "Prendre en charge" apparaît alors sur chaque nouveau ticket. Un membre du staff peut s'assigner le ticket (le bouton devient "Libérer").
- Tant qu'un ticket est pris, un autre membre du staff non-admin qui essaie de le prendre est refusé poliment. Un administrateur peut forcer le transfert pour débloquer une situation.
- Auto-claim : un membre du staff qui envoie plusieurs messages (5 par défaut) dans un ticket pas encore attribué se le voit assigner automatiquement. Seuil configurable,
0pour désactiver. - Auto-libération : si le staff assigné ne répond plus pendant un certain délai (24h par défaut), il est relancé et le ticket redevient automatiquement re-prenable par un autre membre du staff.
- Notes à l'attribution : dès qu'un ticket est attribué (claim manuel, transfert admin ou auto-claim), les notes privées existantes sont montrées à la personne dans un message visible par elle seule, jamais en message privé. Pour un auto-claim, via un bouton "Voir les notes". La liste complète est affichée si elle compte 3 notes ou moins, sinon un résumé invite à taper
/ticket info.
Relances automatiques
- Relance du client : si un ticket n'a reçu aucun message depuis un certain délai (24h par défaut), le bot relance son créateur dans le salon. Délai configurable ou désactivable (
0) ; l'optionmpenvoie aussi la relance en message privé. - Relance du staff assigné : délai distinct, voir la section précédente.
- Fermeture automatique après relance : si elle est activée, un ticket toujours inactif un certain délai après la relance client est fermé automatiquement, avec transcription sauvegardée et sondage de satisfaction, comme une fermeture normale.
# Relance client après 24h, staff après 12h, fermeture auto 48h après la relance
/setup ticket-relance heures:24 heures_staff:12 fermeture_auto:48
Horaires du support et objectif de réponse
- Horaires du support : avec
/setup ticket-horaires, tu définis les heures, les jours et le fuseau du support (Europe/Parispar défaut). Le message d'accueil de chaque ticket indique « support ouvert » ou « support fermé » avec l'heure de reprise, à l'heure locale de chacun. C'est informatif : les tickets ne sont ni bloqués ni relancés différemment. - Objectif de première réponse (SLA) : avec
/setup ticket-sla, tu fixes un délai en minutes. Si personne du staff n'a répondu à temps, le bot poste une alerte dans le ticket et mentionne le rôle d'escalade de ton choix (le rôle support par défaut). Le temps ne compte que pendant les horaires du support s'ils sont définis, un ticket urgent a un délai deux fois plus court, et il n'y a qu'une alerte par ticket (visible dans/ticket info). - Première réponse : c'est le premier message d'un membre du staff, ou une réponse prédéfinie (
/reponse use).
Fermeture d'un ticket
/ticket close [raison] ou le bouton "Fermer le ticket" (staff/admin uniquement), avec confirmation obligatoire. L'option raison est facultative : elle est rappelée à la confirmation et gardée dans l'historique du ticket (/ticket info). Les boutons de confirmation, de réouverture et de suppression sont réservés au staff. Après fermeture : réouverture possible, ou suppression définitive (avec sauvegarde automatique de la transcription avant suppression, en .txt).
La transcription complète (tous les messages, pièces jointes listées, horodatage) est sauvegardée sur le serveur.
Sondage de satisfaction. À la fermeture, le bot envoie un message privé au créateur du ticket avec 5 boutons (1 à 5 étoiles) pour noter le support reçu. Si ses messages privés sont fermés, le sondage est ignoré silencieusement. Seul le créateur du ticket peut le noter. Désactivable avec /setup ticket-satisfaction.
Résumé par IA
/ticket resume (staff/admin, sur un ticket ouvert) demande à Synoxa IA un résumé du ticket : la demande du client, les échanges importants, l'état actuel et la suite à donner. Le résumé est un message visible uniquement par toi.
- Limité à 5 résumés par tranche de 4 heures et par serveur. Si l'IA est indisponible, un message te l'indique et la tentative ne compte pas dans la limite.
- Il faut un minimum de messages dans le ticket, et la commande ne fonctionne que sur un ticket ouvert. Les 150 derniers messages (12 000 caractères maximum) sont pris en compte.
- Seul le texte des messages (avec les rôles « client » et « staff ») est analysé : ni noms, ni identifiants, ni pièces jointes. Les notes privées du staff ne sont jamais transmises.
Statistiques
/ticket statsGérer le serveurStatistiques globales du serveur ou par membre du staff (temps de réponse moyen, nombre de tickets fermés, satisfaction moyenne en étoiles...)
/ticket stats graphiqueGérer le serveurGraphique (image) de l'évolution des tickets ouverts et fermés sur les 14 derniers jours
/ticket stats affluenceGérer le serveurGraphique de la répartition des créations de ticket par heure de la journée sur les 30 derniers jours, pour repérer les heures calmes et les heures de forte affluence
Réponses prédéfinies
Des messages prêts à l'emploi pour le staff, pour éviter de retaper les mêmes réponses dans les tickets. Réservé au staff (rôle support configuré ou administrateurs), avec autocomplétion sur le nom pour use et remove.
/reponse add <nom> <contenu>Crée une réponse, ou la met à jour si le nom existe déjà
/reponse use <nom> [membre]Envoie le contenu dans le salon actuel, avec une mention optionnelle
/reponse listListe toutes les réponses disponibles sur le serveur
/reponse remove <nom>Supprime une réponse
5 réponses sont fournies par défaut dès que le bot rejoint un serveur (bienvenue, patience, relance, résolu, détails). Elles sont librement modifiables ou supprimables.
/reponse use, seul le membre choisi est mentionné : jamais @everyone ni un rôle présent dans le texte de la réponse.Panel de tickets
Le panel est le message public que les utilisateurs utilisent pour ouvrir un ticket. Réservé aux admins. Les commandes sont regroupées sous /setup panel.
/setup panel create [salon] [message_id]AdministrateurCrée un panel, ou attache le système au message existant via réaction
/setup panel editAdministrateurModifie titre, description et couleur via un formulaire
/setup panel deleteAdministrateurSupprime le panel actuel
Le panel affiche des statistiques auto-actualisées (ex: temps de réponse moyen) et un bouton "Infos" pour expliquer le support aux utilisateurs.
Historique
/history user [utilisateur]Historique des tickets d'un utilisateur (par défaut soi-même), avec statistiques. Consulter l'historique d'un autre membre est réservé au staff
/history server [statut]Gérer le serveurHistorique complet du serveur (tous / ouverts / fermés), top 5 des utilisateurs, statistiques globales
/history server est réservé aux membres avec la permission "Gérer le serveur".
Transcriptions
Réservé au staff (permission "Gérer les messages"). Toutes les réponses de /transcript sont privées : elles ne sont visibles que par la personne qui lance la commande.
/transcript listGérer les messagesListe les transcriptions disponibles (IDs temporaires, régénérés à chaque appel)
/transcript get <id>Gérer les messagesTélécharge une transcription en .txt
/transcript search <utilisateur>Gérer les messagesRetrouve les transcriptions liées à un utilisateur
/transcript get renvoie toujours le texte lisible.