diff --git a/docs/2.modules/15.tickets.md b/docs/2.modules/15.tickets.md index bf3f00c9b..49898d05d 100644 --- a/docs/2.modules/15.tickets.md +++ b/docs/2.modules/15.tickets.md @@ -1,97 +1,219 @@ --- title: Tickets -description: Offrez la possibilité à vos membres de créer des tickets pour qu'ils puissent avoir une discussion privée avec l'équipe de votre serveur. +description: Offrez la possibilité à vos membres de créer des tickets pour qu'ils puissent recevoir une assistance de l'équipe de votre serveur, en toute confidentialité. navigation.icon: 'twemoji:admission-tickets' -contributors: ['toutouille-db'] -updatedAt: '2023-06-16' +contributors: ['toutouille-db', 'clement669'] +updatedAt: '2025-04-22' --- -![Menu de configuration](../assets/tickets/ticket-menu-config.png) - ### Créer un ticket -Vous pouvez créer ou demander la création d'un ticket en utilisant la commande \. +Si vous rencontrez des difficultés et souhaitez en discuter avec le staff compétent, dans un salon confidentiel, vous pouvez ouvrir un ticket. Il y a deux méthodes pour ça : +- En utilisant la commande \, +- En interagissant avec le bouton d'un message prévu à cet effet. + +::tabs + ::tab{ label="Via la commande /ticket" } + + ![Exemple montrant l'utilisation de la commande /ticket](../assets/tickets/commande_ouverture_ticket.png) + :: + + ::tab{ label="Via un message dédié" } + + ![Exemple montrant l'utilisation d'un message d'ouverture de tickets](../assets/tickets/discord_message_ouverture.png) + :: +:: ::hint{ type="info" } - La variable `raison` bien que facultative, peut être rendue obligatoire par les gérants du serveur. Il est conseillé de toujours la remplir de manière générale. + Lors de l'utilisation de la commande \, la variable `raison` est facultative par défaut. Comme les gérants du serveur peuvent toutefois choisir de la rendre obligatoire, il est conseillé de toujours la remplir. :: -### Modération des tickets +### Utiliser le ticket -Les administrateurs et modérateurs de tickets disposent des commandes suivantes permettant un contrôle supplémentaire sur les accès aux tickets : +Une fois votre ticket envoyé, un salon est créé par DraftBot pour que vous puissiez échanger avec les modérateurs les plus à même de pouvoir vous apporter l'aide dont vous avez besoin. -- \ ➜ Permet d'ouvrir un ticket pour un membre dans un objectif de contact privé. -- \ ➜ Permet d'autoriser l'accès au contenu du ticket à un membre quelconque. -- \ ➜ Permet de retirer l'accès au contenu du ticket à un membre. +::hint{ type="info" } + En dehors des administrateurs du serveur, l'équipe de modération et vous êtes les seuls habilités à accéder à ce salon. +:: -### Salon de réception +Après que votre ticket a été créé, il peut y avoir un certain délai avant qu'un modérateur ne prenne contact avec vous. Soyez patients, et n'hésitez pas à commencer à expliquer la situation par avance ! -Le salon de réception des tickets permet de recevoir les demandes de tickets des membres, qu'elles soient réalisées via l'utilisation de la commande \ ou bien via un **message d'ouverture**. +![Exemple d'un salon ticket généré par DraftBot](../assets/tickets/discord_salon_ticket.png) ::hint{ type="info" } - La réception des demandes de tickets dans ce salon nécessite obligatoirement que les ouvertures de demandes soient configurées en mode **Manuel**. + Certains serveurs configurent un système de validation des tickets. Dans ce cas, le salon est créé uniquement après que la demande d'ouverture de tickets a été validée par un modérateur. :: -## Configuration +### Clore un ticket + +Une fois le sujet résolu, vous pouvez clôturer le ticket, ce qui, une fois que vous aurez confirmé ce choix, aura pour effet de fermer le salon que DraftBot avait ouvert pour l'occasion. + +::hint{ type="info" } + Un ticket ouvert peut être clôturé par un modérateur, ou par le membre qui l'a ouvert. Dans les deux cas, une confirmation sera demandée, ainsi qu'un motif de fermeture. +:: + +::hint{ type="info" } + Notez que, sur les serveurs [premium](/premium) <:icon_premium_:1096140508625125417>, il est possible d'archiver automatiquement les tickets clôturés afin d'en garder trace. +:: + +### Modération des tickets + +Les commandes suivantes offrent aux administrateurs et modérateurs de tickets un contrôle supplémentaire sur les accès d'un ticket : ::tabs - ::tab{ label="Via la commande /config" } - Pour configurer le système de tickets, vous pouvez utiliser la commande \ puis cliquer dans la section "Tickets". + ::tab{ label="Ouvrir un ticket" } + La commande \ permet d'ouvrir un ticket pour un membre dans un objectif de contact privé. + + Cela permet à un modérateur de créer un ticket pour un membre sans que ce dernier ne doive le faire lui-même. + + ![Exemple d'utilisation de la commande "/ticketmod ouvrir"](../assets/tickets/commande_ticketmod_ouvrir.png) + :: + + ::tab{ label="Ajouter un accès" } + La commande \ permet d'autoriser l'accès au contenu du ticket à un membre de votre choix. + + Cela permet à un modérateur d'accorder à un autre membre l'accès au salon de tickets. Cette commande peut se révéler utile dans le cas d'une résolution de conflits entre deux utilisateurs, par exemple. ::hint{ type="warning" } - Si le système n'est pas configuré, un seul bouton "Configurer le système" sera visible. Cliquez dessus pour commencer la configuration. + Si vous êtes modérateur de tickets, nous vous recommandons de prévenir le membre concerné par le ticket avant d'y inviter une autre personne, en particulier si des informations sensibles y ont été communiquées. :: - ![Menu de configuration de départ](../assets/tickets/ticket-menu-no-config.png) + ![Exemple d'utilisation de la commande /ticketmod ajouter](../assets/tickets/commande_ticketmod_ajouter.png) + :: - > **Catégorie** ➜ Permet de définir la catégorie de création des tickets. Vous pouvez demander à DraftBot de la créer automatiquement pour vous ou bien d'en utiliser une existante. + ::tab{ label="Retirer un accès" } + La commande \ permet de retirer l'accès au contenu du ticket à un membre de votre choix. - > **Salon de réception** ➜ Permet de définir le salon qui recevra les demandes d'ouverture de ticket. Si la validation est en mode **Automatique**, seul l'historique des fermetures et suppressions de ticket sera affiché dans ce salon. Vous pouvez demander à DraftBot de créer automatiquement le salon ou bien d'en utiliser un existant. + Cette fonctionnalité s'avère utile si un des membres, ou rôles, présents sur le ticket n'est pas concerné par celui-ci. ::hint{ type="info" } - Le salon de réception des tickets se trouve par défaut dans la catégorie que vous avez indiquée, mais peut être déplacé dans une autre catégorie. + Vous ne pouvez pas retirer l'accès au ticket à un membre possédant les permissions d'administration, ou le rôle de modérateur de tickets. :: - > **Supprimer le système** ➜ Permet de réinitialiser le système et revenir au bouton "Configurer le système". + ![Exemple d'utilisation de la commande "/ticketmod retirer"](../assets/tickets/commande_ticketmod_retirer.png) + :: +:: + +### Validation et Logs - ::hint{ type="warning" } - Cette action est irréversible, toute la configuration sera perdue. - :: +Si un "Salon de validation de tickets & logs" a été configuré, il est possible de mettre en place sur le serveur un salon dans lequel apparaîtront toutes les notifications d'ouverture ou de fermeture de tickets. - > **Demande de confirmation** ➜ Permet de modifier le message de confirmation affiché lorsqu'un ticket est demandé (modifiable, uniquement, si la validation des tickets est en mode **Manuel**). Vous pouvez choisir la présentation "Par défaut" de DraftBot ou votre texte personnalisé en cliquant sur "Modifier". +En outre, si la fonction "Validation des tickets" est activée, c'est également dans ce salon que les modérateurs de tickets pourront valider (ou non) les demandes d'ouvertures de tickets. - > **Demande du motif d'ouverture** ➜ Permet d'obliger les membres à indiquer une raison d'ouverture du ticket. La raison fournie est indiquée dans le message d'accueil du ticket ainsi que sur la demande d'ouverture si la validation des tickets est en mode **Manuel**. +::hint{ type="info" } + La réception des demandes de tickets dans ce salon nécessite obligatoirement que les ouvertures de demandes soient configurées en mode **Manuel**. +:: - > **Message d'accueil** ➜ Permet de modifier la description du message d'accueil d'un ticket **uniquement** lorsqu'il a été ouvert via la commande \. Lorsqu'un ticket est ouvert via la commande \ la description du message d'accueil contient alors la raison indiquée par le membre. - > **Rôles modérateurs** ➜ Ajouter ou retirer des rôles n'ayant pas la permission "Administrateur" qui auront accès aux tickets. Plusieurs rôles peuvent être ajoutés. +## Configuration +Pour configurer le système de tickets, deux possibilités s'offrent à vous : +- Vous pouvez utiliser la commande \ puis cliquer dans la section "Tickets". +- Vous pouvez également vous rendre dans le [panel](/dashboard/first/tickets) en ligne. - > **Mentionner les modérateurs** ➜ Activer/désactiver la mention automatique des rôles indiqués comme rôles modérateurs à chaque nouveau ticket ouvert. Si cette option est activée, tous les rôles modérateurs seront mentionnés, il n'est actuellement pas possible de choisir les rôles à mentionner parmi la liste des rôles modérateurs. +::tabs + ::tab{ label="Activation via /config" } + Si le système n'est pas activé, le premier bouton sera gris et indiquera "Système désactivé". - > **Suppression admin** ➜ Les tickets sont directement supprimés si un administrateur de serveur ferme un ticket. - :: + <:icon_arrows:1120818258883383307> Cliquer dessus activera alors le système. - ::tab{ label="Via le panel" } - ![Menu de configuration](../assets/tickets/ticket-panel-config.png) + Une fois cela fait, le bouton deviendra vert et affichera "Système activé". - Sur le panel, dans la catégorie **Communautaire**, vous retrouverez sur la partie des **Tickets**, les mêmes possibilités de configuration qu'avec les commandes Slash sur Discord. Le message d'ouverture sera prochainement configurable sur le panel. + <:icon_arrows:1120818258883383307> Cliquer à nouveau dessus aura pour effet de désactiver le système. - > ⚠️ Une fois vos modifications effectuées, n'oubliez pas d'enregistrer avec le bouton "Enregistrer" situé en bas de la page. + ![Retour de la commande /config avant et après activation](../assets/tickets/commande_config_root_activation.png) - - **Catégorie des tickets** ➜ Permet de définir la catégorie de création des tickets. La catégorie doit avoir été préalablement créée. Pensez à actualiser la page du panel si vous avez créé une catégorie entre-temps. + ::hint{ type="info" } + Si le module n'a jamais été configuré sur le serveur, seul un bouton "configurer le système" apparaîtra. + :: - - **Mention des modérateurs** ➜ Permet d'activer la mention automatique des modérateurs lors de l'ouverture d'un ticket. + ::collapse + - Il vous sera alors demandé si vous souhaitez que l'ouverture des tickets s'effectue automatiquement, ou par validation manuelle. + - Ensuite, vous devrez choisir si les utilisateurs seront obligés de saisir un motif d'ouverture de ticket ou non. + - Il vous sera alors demandé si vous souhaitez affecter le système à une catégorie existante, ou laisser DraftBot en créer une pour vous + - Vous pourrez ensuite définir, si vous le souhaitez, un salon de [logs/validation](#validation-et-logs) + :: + :: - - **Rôles modérateurs de tickets** ➜ Ajouter ou retirer des rôles n'ayant pas la permission Administrateur qui auront accès aux tickets. Plusieurs rôles peuvent être ajoutés. + ::tab{ label="Activation via le panel" } + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/tickets) - - **Suppression automatique (admin)** ➜ Lorsque cette option est activée, les tickets sont directement supprimés si un administrateur ferme un ticket. + Depuis le panel DraftBot, vous pouvez activer le système de tickets en vous rendant dans la section "Tickets", et en cliquant sur le bouton pour le faire basculer en mode "on". - - **Validation des tickets** ➜ Lorsque la validation est activée, les demandes de tickets sont transférées dans le **salon de réception** et doivent être acceptées/refusées par les **modérateurs de tickets** ou administrateurs. + ![Activation du système depuis le panel](../assets/tickets/panel_activation.png) - - **Motif d'ouverture** ➜ Permet d'astreindre ou non les membres à spécifier un motif d'ouverture du ticket lors de l'utilisation de \. Son activation est conseillée afin d'éviter les abus de création de tickets ou les demandes sans raison particulière. + Une fois le système activé, les options disponibles apparaissent comme ceci : + ![Vue générale du panel de configuration du système de tickets](../assets/tickets/panel_root.png) :: :: + +### Mise en fonction du module +Lorsque vous activez le système, plusieurs options + +### Personnalisation + +### Validation des tickets + +### Message d'ouverture + +### Motifs d'ouverture ou fermeture + +### Fils privés + +### Sauvegarde automatique + +### Suppression automatique + +### Rôles et mentions + +### Restrictions + +![Menu de configuration de départ](../assets/tickets/ticket-menu-no-config.png) + +> **Catégorie** ➜ Permet de définir la catégorie de création des tickets. Vous pouvez demander à DraftBot de la créer automatiquement pour vous ou bien d'en utiliser une existante. + +> **Salon de réception** ➜ Permet de définir le salon qui recevra les demandes d'ouverture de ticket. Si la validation est en mode **Automatique**, seul l'historique des fermetures et suppressions de ticket sera affiché dans ce salon. Vous pouvez demander à DraftBot de créer automatiquement le salon ou bien d'en utiliser un existant. + +::hint{ type="info" } + Le salon de réception des tickets se trouve par défaut dans la catégorie que vous avez indiquée, mais peut être déplacé dans une autre catégorie. +:: + +> **Supprimer le système** ➜ Permet de réinitialiser le système et revenir au bouton "Configurer le système". + +::hint{ type="warning" } + Cette action est irréversible, toute la configuration sera perdue. +:: + +> **Demande de confirmation** ➜ Permet de modifier le message de confirmation affiché lorsqu'un ticket est demandé (modifiable, uniquement, si la validation des tickets est en mode **Manuel**). Vous pouvez choisir la présentation "Par défaut" de DraftBot ou votre texte personnalisé en cliquant sur "Modifier". + +> **Demande du motif d'ouverture** ➜ Permet d'obliger les membres à indiquer une raison d'ouverture du ticket. La raison fournie est indiquée dans le message d'accueil du ticket ainsi que sur la demande d'ouverture si la validation des tickets est en mode **Manuel**. + +> **Message d'accueil** ➜ Permet de modifier la description du message d'accueil d'un ticket **uniquement** lorsqu'il a été ouvert via la commande \. Lorsqu'un ticket est ouvert via la commande \ la description du message d'accueil contient alors la raison indiquée par le membre. + +> **Rôles modérateurs** ➜ Ajouter ou retirer des rôles n'ayant pas la permission "Administrateur" qui auront accès aux tickets. Plusieurs rôles peuvent être ajoutés. + +> **Mentionner les modérateurs** ➜ Activer/désactiver la mention automatique des rôles indiqués comme rôles modérateurs à chaque nouveau ticket ouvert. Si cette option est activée, tous les rôles modérateurs seront mentionnés, il n'est actuellement pas possible de choisir les rôles à mentionner parmi la liste des rôles modérateurs. + +> **Suppression admin** ➜ Les tickets sont directement supprimés si un administrateur de serveur ferme un ticket. + +![Menu de configuration](../assets/tickets/ticket-panel-config.png) + +Sur le panel, dans la catégorie **Communautaire**, vous retrouverez sur la partie des **Tickets**, les mêmes possibilités de configuration qu'avec les commandes Slash sur Discord. Le message d'ouverture sera prochainement configurable sur le panel. + +> ⚠️ Une fois vos modifications effectuées, n'oubliez pas d'enregistrer avec le bouton "Enregistrer" situé en bas de la page. + +- **Catégorie des tickets** ➜ Permet de définir la catégorie de création des tickets. La catégorie doit avoir été préalablement créée. Pensez à actualiser la page du panel si vous avez créé une catégorie entre-temps. + +- **Mention des modérateurs** ➜ Permet d'activer la mention automatique des modérateurs lors de l'ouverture d'un ticket. + +- **Rôles modérateurs de tickets** ➜ Ajouter ou retirer des rôles n'ayant pas la permission Administrateur qui auront accès aux tickets. Plusieurs rôles peuvent être ajoutés. + +- **Suppression automatique (admin)** ➜ Lorsque cette option est activée, les tickets sont directement supprimés si un administrateur ferme un ticket. + +- **Validation des tickets** ➜ Lorsque la validation est activée, les demandes de tickets sont transférées dans le **salon de réception** et doivent être acceptées/refusées par les **modérateurs de tickets** ou administrateurs. + +- **Motif d'ouverture** ➜ Permet d'astreindre ou non les membres à spécifier un motif d'ouverture du ticket lors de l'utilisation de \. Son activation est conseillée afin d'éviter les abus de création de tickets ou les demandes sans raison particulière. + ### Message d'ouverture ![Configuration du message d'ouverture](../assets/tickets/ticket-open-message.png) @@ -107,3 +229,4 @@ Lors de sa première configuration, depuis la commande \ dans la sectio Vous pouvez vous servir d'un message préalablement créé depuis l'Embed Creator sur le panel en cliquant sur "Message existant" sur la question posée après sélection du type de message d'ouverture pour personnaliser à votre guise l'embed de présentation ou via la commande \. :: + diff --git a/docs/assets/tickets/commande_config_base.png b/docs/assets/tickets/commande_config_base.png new file mode 100644 index 000000000..c849146fd Binary files /dev/null and b/docs/assets/tickets/commande_config_base.png differ diff --git a/docs/assets/tickets/commande_config_cloture.png b/docs/assets/tickets/commande_config_cloture.png new file mode 100644 index 000000000..36664d2d2 Binary files /dev/null and b/docs/assets/tickets/commande_config_cloture.png differ diff --git a/docs/assets/tickets/commande_config_ouverture.png b/docs/assets/tickets/commande_config_ouverture.png new file mode 100644 index 000000000..a5c71327b Binary files /dev/null and b/docs/assets/tickets/commande_config_ouverture.png differ diff --git a/docs/assets/tickets/commande_config_personnalisation.png b/docs/assets/tickets/commande_config_personnalisation.png new file mode 100644 index 000000000..6e8f5921e Binary files /dev/null and b/docs/assets/tickets/commande_config_personnalisation.png differ diff --git a/docs/assets/tickets/commande_config_root.png b/docs/assets/tickets/commande_config_root.png new file mode 100644 index 000000000..476469e9c Binary files /dev/null and b/docs/assets/tickets/commande_config_root.png differ diff --git a/docs/assets/tickets/commande_config_root_activation.png b/docs/assets/tickets/commande_config_root_activation.png new file mode 100644 index 000000000..a07b7f34a Binary files /dev/null and b/docs/assets/tickets/commande_config_root_activation.png differ diff --git a/docs/assets/tickets/commande_ouverture_ticket.png b/docs/assets/tickets/commande_ouverture_ticket.png new file mode 100644 index 000000000..507628869 Binary files /dev/null and b/docs/assets/tickets/commande_ouverture_ticket.png differ diff --git a/docs/assets/tickets/commande_ticketmod_ajouter.png b/docs/assets/tickets/commande_ticketmod_ajouter.png new file mode 100644 index 000000000..234a79f4c Binary files /dev/null and b/docs/assets/tickets/commande_ticketmod_ajouter.png differ diff --git a/docs/assets/tickets/commande_ticketmod_ouvrir.png b/docs/assets/tickets/commande_ticketmod_ouvrir.png new file mode 100644 index 000000000..9745b5a4b Binary files /dev/null and b/docs/assets/tickets/commande_ticketmod_ouvrir.png differ diff --git a/docs/assets/tickets/commande_ticketmod_retirer.png b/docs/assets/tickets/commande_ticketmod_retirer.png new file mode 100644 index 000000000..99796b76b Binary files /dev/null and b/docs/assets/tickets/commande_ticketmod_retirer.png differ diff --git a/docs/assets/tickets/discord_archive.png b/docs/assets/tickets/discord_archive.png new file mode 100644 index 000000000..7e754c9b8 Binary files /dev/null and b/docs/assets/tickets/discord_archive.png differ diff --git a/docs/assets/tickets/discord_fermeture_ticket1.png b/docs/assets/tickets/discord_fermeture_ticket1.png new file mode 100644 index 000000000..eda59d35c Binary files /dev/null and b/docs/assets/tickets/discord_fermeture_ticket1.png differ diff --git a/docs/assets/tickets/discord_fermeture_ticket2.png b/docs/assets/tickets/discord_fermeture_ticket2.png new file mode 100644 index 000000000..95a68ca48 Binary files /dev/null and b/docs/assets/tickets/discord_fermeture_ticket2.png differ diff --git a/docs/assets/tickets/discord_fermeture_ticket3.png b/docs/assets/tickets/discord_fermeture_ticket3.png new file mode 100644 index 000000000..f4021c279 Binary files /dev/null and b/docs/assets/tickets/discord_fermeture_ticket3.png differ diff --git a/docs/assets/tickets/discord_message_ouverture.png b/docs/assets/tickets/discord_message_ouverture.png new file mode 100644 index 000000000..9a4ce93a2 Binary files /dev/null and b/docs/assets/tickets/discord_message_ouverture.png differ diff --git a/docs/assets/tickets/discord_salon_ticket.png b/docs/assets/tickets/discord_salon_ticket.png new file mode 100644 index 000000000..051ae8c58 Binary files /dev/null and b/docs/assets/tickets/discord_salon_ticket.png differ diff --git a/docs/assets/tickets/discord_salon_ticket_prive.png b/docs/assets/tickets/discord_salon_ticket_prive.png new file mode 100644 index 000000000..b3bb4ed4e Binary files /dev/null and b/docs/assets/tickets/discord_salon_ticket_prive.png differ diff --git a/docs/assets/tickets/discord_salon_validation.png b/docs/assets/tickets/discord_salon_validation.png new file mode 100644 index 000000000..665332839 Binary files /dev/null and b/docs/assets/tickets/discord_salon_validation.png differ diff --git a/docs/assets/tickets/panel_activation.png b/docs/assets/tickets/panel_activation.png new file mode 100644 index 000000000..cea39f183 Binary files /dev/null and b/docs/assets/tickets/panel_activation.png differ diff --git a/docs/assets/tickets/panel_message_ouverture.png b/docs/assets/tickets/panel_message_ouverture.png new file mode 100644 index 000000000..4bf7b6b6c Binary files /dev/null and b/docs/assets/tickets/panel_message_ouverture.png differ diff --git a/docs/assets/tickets/panel_message_ouverture_selecteur.png b/docs/assets/tickets/panel_message_ouverture_selecteur.png new file mode 100644 index 000000000..25fc9ce5e Binary files /dev/null and b/docs/assets/tickets/panel_message_ouverture_selecteur.png differ diff --git a/docs/assets/tickets/panel_root.png b/docs/assets/tickets/panel_root.png new file mode 100644 index 000000000..d481f2807 Binary files /dev/null and b/docs/assets/tickets/panel_root.png differ diff --git a/docs/assets/tickets/web_archive.png b/docs/assets/tickets/web_archive.png new file mode 100644 index 000000000..48e04882a Binary files /dev/null and b/docs/assets/tickets/web_archive.png differ