Documentation / Système de tickets

Système de tickets

Signalements en jeu, gestion dans le panneau web, Discord et alertes au staff.

Le système de tickets unifie support et signalements : le joueur ouvre un ticket avec /report, le staff répond avec /reports ou depuis le panneau web et, en option, tout se synchronise avec des fils Discord privés.

Activer les tickets

  1. 1Panneau → Mes serveurs → votre serveur → onglet Tickets.
  2. 2Activez Tickets actifs et enregistrez les réglages rapides.
  3. 3Redémarrez Adictos_WebLogs dans FiveM pour synchroniser la configuration.
  4. 4Attribuez la permission Voir les tickets (view_tickets) aux rôles du staff qui doivent les gérer.

Commandes en jeu

CommandeQuiDescription
/reportJoueurOuvre le menu et crée un ticket (catégorie, sujet, message)
/reportsStaffListe les tickets ouverts et permet de répondre, prendre en charge et fermer
/ticketadd [id] [id_jugador]StaffAjoute un autre joueur connecté à un ticket existant
L’id du ticket pour /ticketadd est le numéro interne affiché dans le panneau web ou dans la liste du staff en jeu.

Panneau web (staff)

  1. 1Menu latéral → Tickets (nécessite la permission view_tickets).
  2. 2Sélectionnez un ticket pour voir l’historique et répondre.
  3. 3Utilisez Prendre en charge pour indiquer que vous vous en occupez, Fermer une fois terminé, ou Rouvrir si nécessaire.
  4. 4Vous pouvez ajouter des joueurs au ticket (licence ou ID Discord) pour que plusieurs personnes participent à la même conversation.

Sur le Dashboard, vous verrez combien de tickets attendent une réponse du staff (dernier message du joueur ou aucune réponse du staff).

Configuration complète

Pour les catégories, limites, liste noire, horaires, tags, IA, apparence NUI et synchronisation Discord :

  1. 1Panneau → Admin → Configuration des tickets (nécessite edit_tickets_config ou d’être Owner).
  2. 2Définissez jusqu’à 6 catégories avec icône, couleur, limite de tickets ouverts et champs supplémentaires.
  3. 3Dans Liste noire, bloquez des utilisateurs (Discord, licence) ou des rôles Discord, dans toutes les catégories ou seulement certaines.

Notifier le staff sur Discord (webhook)

Indépendant de la synchronisation des fils. Lorsqu’un joueur ouvre un ticket avec /report, le panneau peut envoyer un embed dans un salon du staff :

  1. 1Créez un webhook sur Discord (salon du staff → Intégrations → Webhooks).
  2. 2Mes serveurs → Tickets → Webhook — nouveaux tickets en jeu → collez l’URL et activez.
  3. 3Optionnel : un second webhook pour les actions du staff (prendre en charge, répondre, fermer).

Fermeture automatique

RéglageEffet
Jours sans réponse du staffFerme si le joueur a écrit et que personne du staff n’a répondu en X jours
Jours sans réponse du joueurFerme si le staff a répondu et que le joueur n’a pas répondu en X jours

Mettez 0 dans l’un ou l’autre pour le désactiver. Configurable dans Mes serveurs → Tickets ou dans Configuration des tickets → Général.

Discord (fils et bot)

Optionnel : les joueurs ouvrent des tickets depuis des boutons, /ticket ou la commande de la catégorie (p. ex. /new) sur Discord ; chaque ticket est un fil privé ou un salon synchronisé avec le panneau. La commande accepte un utilisateur ou un rôle optionnel (objetivo), réservé au staff : l’utilisateur devient titulaire du ticket et est prévenu une fois ; le rôle reçoit l’accès comme avec /add, sans mentionner tout le rôle. Il faut connecter le bot dans Mes serveurs → DiscordBot et démarrer le bot de tickets depuis Panel Settings. Détails dans la section Rôles Discord.

Les webhooks de tickets ne sont pas la même chose que la synchronisation des fils : le webhook se contente d’alerter dans un salon ; la synchronisation maintient la conversation bidirectionnelle sur Discord.