# Ticket Support

# Présentation du Bot Ticket Support

[**Ticket Support**](https://xelyos.fr/solution/bot-ticket-support/invite)<span style="white-space:pre-wrap;"> est un bot Discord développé pour faciliter la gestion des demandes d’assistance au sein d’un serveur.</span>  
<span style="white-space:pre-wrap;">Il permet aux membres de créer, suivre et gérer leurs tickets directement depuis Discord, tout en offrant un </span>**panel web complet**<span style="white-space:pre-wrap;"> pour centraliser et administrer l’ensemble des tickets.</span>

#### ⚙️ Fonctionnalités principales du bot

- <span style="white-space:pre-wrap;">📩 </span>**Création et gestion de tickets**
    - Les membres peuvent créer des tickets facilement depuis Discord.
    - <span style="white-space:pre-wrap;">Chaque ticket est associé à son auteur et reste accessible depuis le </span>**panel web**.
- <span style="white-space:pre-wrap;">🗂️ </span>**Catégories configurables**, pour chaque catégorie, il est possible de définir :
    - <span style="white-space:pre-wrap;">une </span>**réponse automatique**<span style="white-space:pre-wrap;"> personnalisée,</span>
    - <span style="white-space:pre-wrap;">une </span>**catégorie de channels**<span style="white-space:pre-wrap;"> pour le déplacement,</span>
    - <span style="white-space:pre-wrap;">des </span>**rôles autorisés**<span style="white-space:pre-wrap;"> à accéder aux tickets de cette catégorie.</span>
- <span style="white-space:pre-wrap;">👥 </span>**Ajout dynamique de participants**
    - <span style="white-space:pre-wrap;">Des </span>**membres supplémentaires peuvent être ajoutés ou retirés**<span style="white-space:pre-wrap;"> d’un ticket à tout moment.</span>
- <span style="white-space:pre-wrap;">⏸️ </span>**Mise en attente**
    - <span style="white-space:pre-wrap;">Il est possible de marquer un ticket comme </span>**en attente**, pour indiquer qu’une action ou une réponse est temporairement suspendue.
- <span style="white-space:pre-wrap;">✏️ </span>**Modification du nom**
    - <span style="white-space:pre-wrap;">Le nom du ticket peut être </span>**modifié**<span style="white-space:pre-wrap;"> directement via le bot.</span>
- <span style="white-space:pre-wrap;">⚙️ </span>**Configuration centralisée**
    - <span style="white-space:pre-wrap;">Toutes les options sont </span>**paramétrables depuis le dashboard Xelyos**<span style="white-space:pre-wrap;"> : aucune modification manuelle nécessaire sur le bot.</span>

#### 💻 Le panel web (dashboard Xelyos)

<span style="white-space:pre-wrap;">Le </span>**panel Xelyos**<span style="white-space:pre-wrap;"> permet à la fois aux utilisateurs et aux administrateurs de </span>**gérer leurs tickets et leurs serveurs**.

##### Pour les utilisateurs :

- <span style="white-space:pre-wrap;">🔍 Accès à </span>**l’historique complet de leurs tickets**
- 📂 Consultation et suivi en temps réel des tickets en cours

##### Pour les administrateurs :

- <span style="white-space:pre-wrap;">⚙️ </span>**Gestion complète du serveur**
    - <span style="white-space:pre-wrap;">Définir la </span>**catégorie par défaut**<span style="white-space:pre-wrap;"> lors de la création d’un ticket</span>
    - <span style="white-space:pre-wrap;">Personnaliser les </span>**messages automatiques**<span style="white-space:pre-wrap;"> :</span>
        - message d’ouverture du ticket
        - message de création de ticket
    - <span style="white-space:pre-wrap;">Consulter </span>**l’historique global des tickets**
- <span style="white-space:pre-wrap;">👥 </span>**Gestion des accès**
    - <span style="white-space:pre-wrap;">Définir les </span>**utilisateurs autorisés**<span style="white-space:pre-wrap;"> à accéder au dashboard et à l’historique complet</span>
    - <span style="white-space:pre-wrap;">Gérer les </span>**rôles ayant accès**<span style="white-space:pre-wrap;"> aux tickets (globaux ou spécifiques à une catégorie)</span>
- <span style="white-space:pre-wrap;">🎨 </span>**Gestion des catégories de ticket**
    - <span style="white-space:pre-wrap;">Définir un </span>**emoji**<span style="white-space:pre-wrap;">, un </span>**nom**<span style="white-space:pre-wrap;">, une </span>**description**
    - <span style="white-space:pre-wrap;">Choisir la </span>**catégorie Discord**<span style="white-space:pre-wrap;"> correspondante</span>
    - <span style="white-space:pre-wrap;">Définir une </span>**réponse automatique**
    - <span style="white-space:pre-wrap;">Configurer les </span>**rôles autorisés**

### 🔗 En résumé

**Ticket Support**<span style="white-space:pre-wrap;">, c’est un système complet et intégré de gestion d’assistance pour Discord, combinant la </span>**simplicité d’un bot Discord**<span style="white-space:pre-wrap;"> et la </span>**puissance d’un dashboard web**. Il permet d’unifier la gestion des tickets, de suivre les demandes d’aide, et de configurer précisément le comportement du bot selon les besoins de chaque serveur.

# Protocole d’installation du bot

##### **Accédez au dashboard Xelyos**

<span style="white-space:pre-wrap;">Rendez-vous sur le </span>**dashboard Xelyos**<span style="white-space:pre-wrap;">, dans la catégorie </span>**Bot Discord → Ticket Support**.

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/q6Zimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/q6Zimage.png)

##### **Invitez le bot sur votre serveur**

<span style="white-space:pre-wrap;">Dans l’onglet </span>**Gérer mes serveurs**<span style="white-space:pre-wrap;">, cliquez sur le lien : </span>**inviter le bot**<span style="white-space:pre-wrap;"> pour l’ajouter à votre serveur Discord.</span>

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/XEXimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/XEXimage.png)

![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/BQGimage.png)##### **Actualisez la liste des serveurs**

<span style="white-space:pre-wrap;">Une fois le bot ajouté, cliquez sur le bouton de </span>**rafraîchissement**<span style="white-space:pre-wrap;"> pour mettre à jour la liste. Votre serveur apparaîtra alors dans le tableau.</span>

![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/fOBimage.png)##### **Confirmation d’installation**

Le bot vous enverra un message privé de confirmation pour indiquer qu’il a bien été ajouté à votre serveur.

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/4O1image.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/4O1image.png)

##### **Initialisation de la configuration**

<span style="white-space:pre-wrap;">Depuis la page de configuration de votre serveur, cliquez sur le bouton </span>**Initialiser l’installation**. Cette action va automatiquement :

- <span style="white-space:pre-wrap;">🗂️ Créer une </span>**catégorie dédiée**<span style="white-space:pre-wrap;"> à la création des tickets. </span>
- <span style="white-space:pre-wrap;">💬 Créer le </span>**salon de réaction**<span style="white-space:pre-wrap;"> permettant aux membres de créer leurs tickets.</span>

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/U6Simage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/U6Simage.png)

##### **Personnalisation post-installation**

<span style="white-space:pre-wrap;">Toutes ces informations peuvent ensuite être </span>[**modifiées et personnalisées**](https://wiki.xelyos.fr/books/ticket-support/page/configuration-du-bot)<span style="white-space:pre-wrap;"> depuis le </span>**dashboard Xelyos**.

# Configuration du bot

<span style="white-space:pre-wrap;">Le </span>**panel de configuration**<span style="white-space:pre-wrap;"> permet de personnaliser en détail le comportement du bot </span>**Ticket Support**<span style="white-space:pre-wrap;"> sur chaque serveur Discord. Toutes les options sont directement accessibles depuis le </span>**dashboard Xelyos**<span style="white-space:pre-wrap;">, sans avoir besoin de commandes Discord. </span>

<p class="callout warning"><span style="white-space:pre-wrap;">(2026-03-30) Pour le moment, seul le </span>**propriétaire**<span style="white-space:pre-wrap;"> du bot peut accéder au panel de configuration. L'accès pour les administrateurs est en cours de développement</span></p>

### Paramètres du bot

##### **Paramètres généraux**

<span style="white-space:pre-wrap;">Sélectionnez la catégorie Discord dans laquelle seront créés les </span>**nouveaux tickets**<span style="white-space:pre-wrap;"> par défaut.</span>

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/jEsimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/jEsimage.png)

##### **Création de ticket**

- **Salon de réaction**  
    <span style="white-space:pre-wrap;">Choisissez le </span>**channel**<span style="white-space:pre-wrap;"> où le message de création de ticket sera publié.</span>  
    C’est sur ce message que les utilisateurs réagiront pour ouvrir un ticket.
- **Message de création**  
    <span style="white-space:pre-wrap;">Définissez le </span>**texte du message**<span style="white-space:pre-wrap;"> affiché dans le salon de création.</span>  
    Vous pouvez y inclure des instructions, un contexte ou des précisions pour les membres.

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/TBJimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/TBJimage.png)

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/2g3image.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/2g3image.png)

##### **Message envoyé à la création d’un ticket**

<span style="white-space:pre-wrap;">Personnalisez le </span>**message automatique**<span style="white-space:pre-wrap;"> que le bot enverra </span>**dans le salon du ticket**<span style="white-space:pre-wrap;"> lors de sa création. Ce message peut contenir, par exemple :</span>

- un message d’accueil,
- des consignes pour l’utilisateur,
- ou un rappel des règles d’assistance.

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/2yIimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/2yIimage.png)

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/0ugimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/0ugimage.png)

---

### Gestion des accès

##### **Gestion des accès au panel**

<span style="white-space:pre-wrap;">Sélectionnez les </span>**membres**<span style="white-space:pre-wrap;"> qui auront accès au </span>**dashboard Xelyos**<span style="white-space:pre-wrap;"> pour votre serveur. Ces utilisateurs pourront consulter l’historique complet des tickets, modifier la configuration du bot et gérer les catégories ou les rôles directement depuis le panel web.</span>

##### **Gestion des accès aux tickets**

<span style="white-space:pre-wrap;">Définissez les </span>**rôles Discord**<span style="white-space:pre-wrap;"> autorisés à </span>**accéder aux tickets**<span style="white-space:pre-wrap;">. Ces rôles pourront voir, répondre et interagir dans les salons de tickets. Vous pouvez attribuer des rôles </span>**globaux**<span style="white-space:pre-wrap;"> (valables pour tous les tickets) ou </span>**spécifiques à certaines catégories**.

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/wj4image.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/wj4image.png)

---

### Sujets de ticket

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/69timage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/69timage.png)

<span style="white-space:pre-wrap;">Les </span>**sujets de ticket**<span style="white-space:pre-wrap;"> permettent de proposer plusieurs types de demandes aux utilisateurs lors de la création d’un ticket. Chaque sujet peut être configuré individuellement pour adapter le comportement du bot selon le type de demande.</span>

- **Emoji**<span style="white-space:pre-wrap;"> </span>**(optionnel)**  
    Permet d’ajouter un emoji pour identifier visuellement le sujet dans la liste des tickets disponibles.
- **Nom du sujet**  
    Nom du sujet tel qu’il apparaîtra dans la liste des choix de création de ticket.
- **Déplacer dans**  
    <span style="white-space:pre-wrap;">Sélectionnez la </span>**catégorie Discord**<span style="white-space:pre-wrap;"> dans laquelle les tickets de ce sujet seront automatiquement créés.</span>
- **Courte description**  
    Texte descriptif visible dans la liste des sujets, utile pour indiquer la nature du ticket ou les conditions d’utilisation.
- **Réponse automatique**<span style="white-space:pre-wrap;"> </span>**(optionnelle)**  
    Message que le bot enverra automatiquement dans le salon du ticket dès sa création. Vous pouvez y inclure des informations, des liens ou des consignes.
- **Rôles autorisés à voir ce ticket**  
    <span style="white-space:pre-wrap;">Sélectionnez les </span>**rôles Discord**<span style="white-space:pre-wrap;"> qui auront accès aux tickets créés pour ce sujet. (Utilisez </span>**Ctrl + clic**<span style="white-space:pre-wrap;"> pour en sélectionner plusieurs.)</span>
- **Activer le sujet**  
    Permet d’activer ou de désactiver le sujet. Les sujets désactivés ne seront plus proposés lors de la création d’un ticket.
- **Supprimer le sujet**  
    Supprime le sujet et ses paramètres associés.

# Commandes

<span style="white-space:pre-wrap;">Le bot Ticket Support dispose de plusieurs </span>**commandes Slash**<span style="white-space:pre-wrap;"> pour gérer vos tickets directement depuis Discord. Elles permettent d’interagir facilement avec les tickets sans passer par le panel.</span>

##### **/add-user**

**Ajoute un utilisateur au ticket en cours.**  
Permet d’inviter un membre supplémentaire à participer à la discussion dans le ticket.  
<span style="white-space:pre-wrap;">🔹 </span>**Exemple :* `<em class="editor-theme-code editor-theme-italic">/add-user @Utilisateur</em>`*

---

##### **/remove-user**

**Retire un utilisateur du ticket.**  
Utilisez cette commande pour retirer l’accès d’un membre à un ticket.  
<span style="white-space:pre-wrap;">🔹 </span>**Exemple :* `<em class="editor-theme-code editor-theme-italic">/remove-user @Utilisateur</em>`*

---

##### **/claim**

**Prendre en charge un ticket.**  
Marquez le ticket comme “pris en charge” afin d’indiquer qu’un membre du staff s’en occupe.  
Le bot affichera un message de confirmation visible par tous.  
<span style="white-space:pre-wrap;">🔹 </span>**Exemple :* `<em class="editor-theme-code editor-theme-italic">/claim</em>`*

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/scaled-1680-/1seimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2025-11/1seimage.png)

---

##### **/close**

**Ferme un ticket.**  
Cette commande clôture le ticket en cours.  
Selon la configuration du bot, le salon peut être archivé ou supprimé automatiquement.  
<span style="white-space:pre-wrap;">🔹 </span>**Exemple :* `<em class="editor-theme-code editor-theme-italic">/close</em>`*

---

##### **/rename**

**Renomme le ticket.**  
Permet de modifier le nom du salon du ticket pour une meilleure organisation.  
<span style="white-space:pre-wrap;">🔹 </span>**Exemple :* `<em class="editor-theme-code editor-theme-italic">/rename nouveau-nom</em>`*

---

##### **/topic**

**Sélectionne ou change le sujet du ticket.**  
<span style="white-space:pre-wrap;">Vous pouvez choisir parmi les </span>**sujets configurés dans le panel**<span style="white-space:pre-wrap;"> ou définir un </span>**sujet personnalisé**.  
<span style="white-space:pre-wrap;">🔹 </span>**Exemple :* `<em class="editor-theme-code editor-theme-italic">/topic</em>` *→ choisir un sujet prédéfini**  
<span style="white-space:pre-wrap;">🔹 </span>**Exemple :* `<em class="editor-theme-code editor-theme-italic">/topic autre</em>` *→ définir un sujet librement**

---

##### **/wait**

**Met le ticket en attente.**  
Permet de signaler que le ticket nécessite une action future (réponse du client, information en attente, etc.).  
Le ticket reste ouvert mais marqué comme “en attente”.  
<span style="white-space:pre-wrap;">🔹 </span>**Exemple :* `<em class="editor-theme-code editor-theme-italic">/wait</em>`*