> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide de configuration du bot de tickets

> De la clé de licence à un bot de tickets Discord en ligne en environ 10 minutes.

EchoAuth Tickets héberge ton bot de tickets Discord pour toi. Tu crées un compte avec ta clé de licence, tu configures le bot dans ton navigateur et tu le déploies en un clic. Tu n'as besoin ni de serveur ni de savoir coder.

> [!NOTE]
>
> **Avant de commencer, prépare ces éléments :**
>
> * La clé de licence de ta facture SellAuth (elle ressemble à `ECHO-XXXXX-XXXXX-XXXXX-XXXXX`)
> * Un accès administrateur à ton serveur Discord
> * Un compte Discord pouvant créer des applications dans le [Discord Developer Portal](https://discord.com/developers/applications)

## 1. Créer ton compte

**1. Ouvrir la page d'inscription**

Ouvre le panel EchoAuth Tickets et clique sur **Create an account** sous le formulaire de connexion. Si tu as utilisé le lien de ta facture, ta clé de licence est déjà renseignée.

**2. Saisir ta clé de licence et tes identifiants**

Colle ta **clé de licence**, choisis un **nom d'utilisateur** (3 à 32 caractères : lettres, chiffres, `.`, `_` et `-`) et un **mot de passe** d'au moins 8 caractères. Clique ensuite sur **Create account**.

![Le formulaire Create your account avec les champs clé de licence, nom d'utilisateur et mot de passe](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/register.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=963b556456e896df44c36bf5111ac365)

Inscris-toi avec la clé de licence de ta facture SellAuth

**3. Vérifier ton tableau de bord**

Tu arrives sur le tableau de bord. Il affiche le nombre de jours restants de ta licence, l'état de ton bot et une checklist **Getting started**. Chaque élément de la checklist ouvre le paramètre concerné.

![Tableau de bord avec une licence active, un bot pas encore déployé et la checklist Getting started](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/dashboard.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=afdb4921c1fac548a8e7ea01642dcfdb)

Le tableau de bord juste après l'inscription. La configuration est à 0/6

## 2. Créer ton bot Discord

Ton bot de tickets fonctionne sur ta propre application Discord. Tu la crées une seule fois dans le Discord Developer Portal.

**1. Créer une application**

Va sur le [Discord Developer Portal](https://discord.com/developers/applications), clique sur **New Application**, donne-lui un nom (par exemple le nom de ta boutique) et crée-la.

**2. Activer les intents privilégiés**

Ouvre l'onglet **Bot**. Sous **Privileged Gateway Intents**, active les trois :

* **Presence Intent**
* **Server Members Intent**
* **Message Content Intent**

Clique sur **Save Changes**.

> [!WARNING]
>
> Si ces intents sont désactivés, le bot ne peut pas démarrer ou ne peut pas lire les messages dans les tickets.

**3. Copier le token du bot**

Toujours dans l'onglet **Bot**, clique sur **Reset Token** et copie le token. Tu le colleras dans le panel dans la section suivante.

> [!WARNING]
>
> Le token de ton bot fonctionne comme un mot de passe. Ne le partage pas et ne le publie nulle part. S'il fuite, réinitialise-le ici et colle le nouveau dans le panel.

**4. Inviter le bot sur ton serveur**

Ouvre **OAuth2 → URL Generator**. Sélectionne les scopes `bot` et `applications.commands`, puis la permission **Administrator**. Ouvre l'URL générée et ajoute le bot à ton serveur.

**5. Activer le mode développeur dans Discord**

Dans Discord, va dans **User Settings → Advanced** et active **Developer Mode**. Tu peux alors faire un clic droit sur les serveurs, salons, catégories et rôles et choisir **Copy ID**. Tu auras besoin de ces ID dans les étapes suivantes.

## 3. Configurer ton bot

Clique sur **Configuration** dans la barre latérale. Les paramètres sont regroupés en onglets. L'**Live preview** à droite montre en direct l'apparence de tes messages dans Discord pendant que tu tapes.

Dès que tu modifies quelque chose, une barre apparaît en bas de la page. Clique sur **Save** pour conserver tes modifications, ou sur **Save & Deploy** pour enregistrer et redémarrer immédiatement le bot avec les nouveaux paramètres.

**1. General : ajouter ton token et l'ID du serveur**

Dans l'onglet **General**, renseigne :

* **Bot Token** : le token du Developer Portal
* **Server ID** : fais un clic droit sur l'icône de ton serveur et choisis **Copy Server ID**
* **Owner User ID** (facultatif) : ton propre ID d'utilisateur Discord. Cet utilisateur a toujours accès aux commandes d'administration SellAuth.
* **Owner Role ID** (facultatif) : un rôle autorisé à utiliser `/refund`, `/remove_password`, `/add_customer_balance`, `/redo_delivery` et `/replace`

![Onglet de configuration General avec token du bot, ID du serveur et Owner User ID renseignés, et la barre des modifications non enregistrées](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/general.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=c550d06ff7725d8856d3712e44097982)

Onglet General avec le token et l'ID du serveur renseignés. La barre d'enregistrement apparaît en bas

**2. Ticket Behavior : choisir un salon de logs**

Dans l'onglet **Ticket Behavior**, définis la **Logs channel ID**. Le bot y publie les logs des tickets, et `/panel` ne fonctionne pas sans elle. Fais un clic droit sur le salon dans Discord et choisis **Copy Channel ID**.

Tu peux aussi définir combien de tickets un utilisateur peut avoir ouverts, un délai d'attente, si seul le staff peut fermer les tickets, et si les tickets fermés sont archivés au lieu d'être supprimés.

![Onglet Ticket Behavior avec l'ID du salon de logs renseigné](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/ticket-behavior.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=b73fdb6598b4fd49b20c56671d6b65ca)

Onglet Ticket Behavior. Le salon de logs est obligatoire

**3. Categories : définir où les tickets s'ouvrent et qui peut y répondre**

Dans l'onglet **Categories**, sélectionne une catégorie à gauche (par exemple **General Support**) et renseigne :

* **Discord category ID** : la catégorie de salons où les nouveaux tickets sont créés. Fais un clic droit sur la catégorie dans Discord et choisis **Copy Category ID**.
* **Support roles** : colle un ID de rôle et appuie sur **Enter**. Les membres de ces rôles peuvent voir et répondre aux tickets de cette catégorie.

Répète l'opération pour chaque catégorie que tu utilises. Pour en utiliser davantage, ouvre-en une et active **Enabled**. Le mode boutons affiche jusqu'à 5 catégories et le mode menu déroulant jusqu'à 8. Sous **Form**, tu peux ajouter jusqu'à 5 questions auxquelles les utilisateurs répondent avant l'ouverture du ticket.

![Onglet Categories avec l'ID de catégorie Discord et un rôle de support renseignés, à côté d'un aperçu du message du ticket](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/categories.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=82fa0f8f57ffe9b5cd68eaf5b5c1b4d3)

Catégorie 1 avec un ID de catégorie Discord et un rôle de support

> [!TIP]
>
> Définis la **Function** du champ de formulaire sur **SellAuth invoice lookup** pour que le bot retrouve automatiquement la commande quand un client saisit son ID de facture.

**4. Ticket Panel : concevoir le message sur lequel les membres cliquent**

Dans l'onglet **Ticket Panel**, modifie le titre, le message, la couleur, les images et le pied de page du panel. Active **Use a dropdown menu** pour afficher les catégories dans un menu déroulant plutôt qu'en boutons. L'aperçu se met à jour pendant que tu tapes.

![Onglet Ticket Panel à côté d'un aperçu Discord du panel Support Center avec un menu déroulant de catégories](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/ticket-panel.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=8eb97253931ed5ad11efb96f41c8cbba)

Onglet Ticket Panel avec l'aperçu Discord en direct

**5. SellAuth (facultatif) : connecter ta boutique**

Pour utiliser les commandes SellAuth (`/invoice`, `/refund`, `/replace` et d'autres) et les recherches de factures, ouvre l'onglet **SellAuth** et saisis ta **API key** (dash.sellauth.com → Account → Developers), ton **Shop ID**, ta **Shop currency** et ton **Shop domain**.

![Onglet d'intégration SellAuth avec clé API, Shop ID, devise et domaine](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/sellauth.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=27f8ddc2f4a8db61dabb08029b3130cb)

Onglet SellAuth

## 4. Déployer ton bot

Retourne sur le **Dashboard**. Quand les cinq premiers éléments de la checklist sont cochés, clique sur **Deploy**. Ton bot démarre en quelques secondes et se met en ligne sur ton serveur.

![Tableau de bord avec cinq étapes sur six terminées et le bouton Deploy](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/dashboard-ready.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=e7426998aad99958eb32136d3d4b948f)

Tous les paramètres sont faits. Il ne reste que l'étape de déploiement

Après le premier déploiement, utilise **Save & Deploy** sur la page Configuration pour appliquer les modifications ultérieures.

> [!NOTE]
>
> Si le déploiement échoue, ouvre **Logs** dans la barre latérale. Les causes les plus fréquentes sont un mauvais token de bot ou des intents désactivés dans le Developer Portal.

## 5. Publier le panel de tickets dans Discord

Sur ton serveur Discord, va dans le salon où les membres doivent ouvrir leurs tickets et exécute :

```text theme={null}
/panel
```

Tu as besoin de la permission **Administrator** pour exécuter cette commande. Le bot publie le panel dans ce salon. Les membres choisissent alors une catégorie, remplissent le formulaire, et un salon de ticket privé s'ouvre pour eux et tes rôles de support.

## Renouveler ou prolonger ta licence

Ouvre **License & Account** dans la barre latérale. Colle une nouvelle clé sous **Redeem a license key** et clique sur **Redeem**. Le temps est ajouté à ta date d'expiration actuelle, tu peux donc prolonger à l'avance sans perdre de jours. Tu peux aussi changer ton mot de passe sur cette page.

![Page License et Account avec le formulaire pour utiliser une clé de licence, le formulaire de changement de mot de passe et l'historique des licences](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/account.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=ae5f1857dd2f29e1320e152fe5a2ff17)

Page License & Account

> [!WARNING]
>
> Quand ta licence expire, ton bot est arrêté. Ta configuration et tes transcriptions sont conservées. Utilise une nouvelle clé et redéploie pour remettre le bot en ligne.

## Dépannage

> [accordion] Le bot est en ligne mais les commandes slash n'apparaissent pas
>
> Vérifie que tu as invité le bot avec le scope `applications.commands` et que **Slash commands** est activé dans **Configuration → General → Commands**. Discord peut mettre quelques minutes à afficher les nouvelles commandes. Redémarrer Discord aide souvent.

> [accordion] /panel ne fait rien
>
> Vérifie que la **Logs channel ID** de l'onglet **Ticket Behavior** pointe vers un salon qui existe sur ton serveur et que tu as la permission Administrator.

> [accordion] Les tickets s'ouvrent au mauvais endroit ou le staff ne les voit pas
>
> Vérifie la **Discord category ID** et les **Support roles** de cette catégorie dans l'onglet **Categories**. Chaque catégorie a ses propres paramètres. Assure-toi que le rôle du bot a la permission de gérer les salons dans cette catégorie.

> [accordion] Je ne peux pas créer de compte avec ma clé
>
> Copie la clé exactement comme elle apparaît sur ta facture. Chaque clé ne peut être utilisée qu'une seule fois. Si tu as déjà un compte, connecte-toi et utilise la clé sous **License & Account** à la place.

Toujours bloqué ? Ouvre un ticket sur notre [serveur de support](https://discord.echoauth.dev).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.