Documentation — Bot Discord

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

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.

Un utilisateur ne peut pas ouvrir un second ticket tant que le premier est encore ouvert, même si deux demandes arrivent en même temps. Si le salon d'un ticket est supprimé à la main, le ticket est automatiquement marqué fermé.

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.

VariableRendu
{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
Discord — Nom des tickets
# 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 private

Rend 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)

Un utilisateur non-staff ne peut pas mentionner le rôle support ou un membre du staff dans un ticket : message supprimé + avertissement automatique.

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").

Relances automatiques

Discord — Relances
# 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

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.

L'analyse est faite à la demande par un modèle d'IA hébergé par Synoxa. Le contenu du ticket n'est ni conservé ni enregistré dans les journaux. Détails dans la politique de confidentialité.

Statistiques

/ticket statsGérer le serveur

Statistiques 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 serveur

Graphique (image) de l'évolution des tickets ouverts et fermés sur les 14 derniers jours

/ticket stats affluenceGérer le serveur

Graphique 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 list

Liste 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.

Avec /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]Administrateur

Crée un panel, ou attache le système au message existant via réaction

/setup panel editAdministrateur

Modifie titre, description et couleur via un formulaire

/setup panel deleteAdministrateur

Supprime 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.

Si le bot redémarre, les panels avec auto-update reprennent automatiquement — pas besoin de les recréer.

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 serveur

Historique 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 messages

Liste les transcriptions disponibles (IDs temporaires, régénérés à chaque appel)

/transcript get <id>Gérer les messages

Télécharge une transcription en .txt

/transcript search <utilisateur>Gérer les messages

Retrouve les transcriptions liées à un utilisateur

Les transcriptions sont stockées chiffrées sur le disque (AES-256-GCM). C'est transparent à l'usage : /transcript get renvoie toujours le texte lisible.