# Création et configuration du bot Discord

<span style="white-space: pre-wrap;">Dans cette section, nous allons vous accompagner étape par étape dans la création et la configuration d’un bot Discord destiné à l’administration et à la gestion des solutions </span>****Xelyos****.

<p class="callout warning">****Responsabilité de Xelyos :****<span style="white-space: pre-wrap;"> Xelyos ne peut être tenu responsable des actions du bot sur le serveur Discord. L’utilisation et la configuration du bot relèvent de la responsabilité de l’administrateur du serveur.</span></p>

<p class="callout info">****Permissions du bot :****<span style="white-space: pre-wrap;"> Le bot ne nécessite pas d’autorisations spécifiques pour effectuer des actions sur le serveur. Ses seuls accès requis concernent la lecture de la liste des utilisateurs et de leurs rôles, ainsi que la possibilité d’envoyer des notifications.</span></p>

<p class="callout info">****Création d’un bot dédié :****<span style="white-space: pre-wrap;"> Pour garantir la compatibilité et éviter toute interférence avec des bots existants, il est impératif de créer un bot exclusivement destiné au système, sans réutiliser les informations d’un bot préexistant.</span></p>

<u>Nous allons couvrir les étapes suivantes :</u>

- <span style="white-space: pre-wrap;">Création du bot via la plateforme </span>[Discord Developer Portal](https://discord.com/developers/applications).
- Configuration des permissions et paramètres nécessaires.
- Invitation du bot sur votre serveur !

L’objectif est de rendre le processus clair et accessible, même pour ceux qui découvrent la gestion de bots Discord. En suivant ce guide, vous serez en mesure de configurer votre bot rapidement.

<span style="white-space: pre-wrap;">Passons maintenant à la première étape : </span><span style="color: rgb(186, 55, 42);">la création du bot Discord</span>.

---

### Étape 1 : création du bot

##### 1. Accéder au Discord Developer Portal

<span style="white-space: pre-wrap;">Rendez-vous sur le site officiel du </span>[Discord Developer Portal](https://discord.com/developers/applications). C’est ici que vous gérerez votre bot et ses paramètres. Assurez-vous d’être connecté avec votre compte Discord.

##### 2. Créer une nouvelle application

Une fois sur le portail :

- <span style="white-space: pre-wrap;">Cliquez sur le bouton </span>****"New Application"****<span style="white-space: pre-wrap;"> ou </span>****"Créer une application"****<span style="white-space: pre-wrap;"> en haut à droite de l’écran.</span>
- Une fenêtre contextuelle s’affichera pour vous permettre de nommer votre application.

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

##### 3. Entrer le nom de l'application

- <span style="white-space: pre-wrap;">Donnez un nom à votre nouvelle application. Il peut s’agir de </span>****Dark Chat RP ou XelNews**** ou de tout autre nom représentatif de votre bot.
- <span style="white-space: pre-wrap;">Cliquez sur </span>****"Create"****<span style="white-space: pre-wrap;"> pour valider la création.</span>

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

##### 4. Ajouter les informations générales

Après avoir créé l’application, vous serez redirigé vers la page de gestion de votre bot.

- ****Logo****<span style="white-space: pre-wrap;"> : une image pour représenter votre bot (par exemple, un avatar lié au thème de votre serveur).</span>
- ****Nom****<span style="white-space: pre-wrap;"> : vérifiez ou modifiez le nom de votre bot.</span>
- ****Description****<span style="white-space: pre-wrap;"> : ajoutez une description facultative pour expliquer à quoi sert le bot ou pour donner des détails sur son rôle.</span>

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

---

### Étape 2 : inviter le bot sur votre Discord

Bien que cette étape soit réalisée assez tôt dans le processus, elle nous permettra de finaliser rapidement l'installation et de passer à la suite sans complication. Pas de panique, cette configuration initiale ne nécessite pas de permissions avancées pour le bot, sauf celle d'envoyer des messages aux utilisateurs.

****Instructions pour installer le bot :****

- ****Aller dans la partie "Installation"****
    - <span style="white-space: pre-wrap;">Dans le </span>[Discord Developer Portal](https://discord.com/developers/applications), accédez à l’application que vous venez de créer.
    - <span style="white-space: pre-wrap;">Dans le menu latéral, cliquez sur l'onglet </span>****Installation****.

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

- ****Définir les paramètres****
    - Définissez les paramètres comme sur l'image ci-dessous

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

- ****Inviter le bot sur votre serveur****
    - <span style="white-space: pre-wrap;">Copiez le lien d'invitation généré pour le bot dans la partie </span>****Installation****.
    - Collez ce lien dans votre navigateur pour inviter le bot sur le serveur Discord de votre choix.
    - <span style="white-space: pre-wrap;">Sélectionnez le serveur cible, puis cliquez sur </span>****Autoriser****.

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

---

### Étape 3 : Configuration du OAuth2

Cette étape est essentielle pour permettre l’authentification des utilisateurs pour les services Xelyos. Nous allons configurer les informations nécessaires pour que le bot puisse interagir correctement avec le site web.

##### 1. Récupérer les informations de Client ID et Client Secret

- ****Accéder aux informations OAuth2****
    - <span style="white-space: pre-wrap;">Depuis le </span>[Discord Developer Portal](https://discord.com/developers/applications), sélectionnez l’application que vous avez créée.
    - <span style="white-space: pre-wrap;">Cliquez sur l’onglet </span>****OAuth2****<span style="white-space: pre-wrap;"> dans le menu latéral.</span>

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

- ****Récupérer le Client ID****
    - <span style="white-space: pre-wrap;">Dans la section </span>****General Information****<span style="white-space: pre-wrap;">, localisez le champ </span>****Client ID****.
    - <span style="white-space: pre-wrap;">Cliquez sur le bouton </span>****Copy****<span style="white-space: pre-wrap;"> à côté pour copier l’identifiant unique de votre application.</span>
- ****Générer et récupérer le Client Secret****
    - <span style="white-space: pre-wrap;">Toujours dans la section </span>****General Information****<span style="white-space: pre-wrap;">, localisez le champ </span>****Client Secret****.
    - <span style="white-space: pre-wrap;">Cliquez sur </span>****Reset Secret****<span style="white-space: pre-wrap;"> pour générer un nouveau secret.</span>
    - <span style="white-space: pre-wrap;">Une fois généré, copiez le </span>****Client Secret****<span style="white-space: pre-wrap;"> affiché.</span>
- ****Intégrer les informations dans le formulaire****
    - <span style="white-space: pre-wrap;">Les valeurs </span>****Client ID****<span style="white-space: pre-wrap;"> et </span>****Client Secret****<span style="white-space: pre-wrap;"> sont indispensables pour configurer correctement le bot.</span>
    - <span style="white-space: pre-wrap;">Intégrez-les dans le </span>****GForm****<span style="white-space: pre-wrap;"> qui vous a été envoyé.</span>

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

- <span style="white-space: pre-wrap;">Collez le </span>****Client ID****<span style="white-space: pre-wrap;"> et le </span>****Client Secret****<span style="white-space: pre-wrap;"> dans les champs correspondants du formulaire.</span>

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

##### 2. Configuration de l'URL de redirection

Pour finaliser la configuration du OAuth2, nous devons définir une URL de redirection. Cette URL est utilisée pour vérifier et traiter les informations des utilisateurs après leur authentification via Discord.

- ****Accéder aux paramètres de redirection****
    - <span style="white-space: pre-wrap;">Toujours dans la section </span>****OAuth2****<span style="white-space: pre-wrap;"> du </span>[Discord Developer Portal](https://discord.com/developers/applications)<span style="white-space: pre-wrap;">, localisez la section </span>****Redirects****<span style="white-space: pre-wrap;"> ou </span>****URL de redirection****.

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

- ****Composer l'URL de redirection****
    - Prenez le nom de domaine associé à votre solution.
    - <span style="white-space: pre-wrap;">Ajoutez le préfixe </span>`<span class="editor-theme-code">https://</span>`<span style="white-space: pre-wrap;"> devant ce nom de domaine.</span>
    - <span style="white-space: pre-wrap;">Ajoutez ensuite </span>`<span class="editor-theme-code">/connect-discord/check</span>`<span style="white-space: pre-wrap;"> à la fin de l’URL.</span>
    
    ****Exemple :****  
    <span style="white-space: pre-wrap;">Si votre domaine est </span>`<span class="editor-theme-code">darkchatrp.xelyos.fr</span>`, votre URL de redirection sera :

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

---

### Étape 4 : Configuration des paramètres du bot

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

##### 1. Définir le nom, l'avatar et la bannière du bot

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

##### 2. Récupérer le token du bot

- ****Token :**** dans l’onglet Bot, copiez le token de votre bot.
- ****Intégration :**** collez ce token dans le GForm que nous vous avons envoyé.

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

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

<p class="callout warning">****Attention :****<span style="white-space: pre-wrap;"> Le token est confidentiel, ne le partagez pas ailleurs !</span></p>

---

### Étape 5 : Mon bot reste chez moi

Cette étape permet de faire en sorte que votre bot ne soit pas public et ne puisse être disponible que sur votre serveur Discord.

##### 1. Modifier le lien d'installation

- <span style="white-space: pre-wrap;">Allez dans l’onglet </span>****Installation****<span style="white-space: pre-wrap;"> du </span>[Discord Developer Portal](https://discord.com/developers/applications).
- <span style="white-space: pre-wrap;">Dans la section </span>****Install Link****<span style="white-space: pre-wrap;">, définissez </span>****none****<span style="white-space: pre-wrap;"> pour empêcher le bot d'être ajouté à d'autres serveurs.</span>

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

##### 2. Désactiver l'option Public Bot

- <span style="white-space: pre-wrap;">Ensuite, allez dans l’onglet </span>****Bot****.
- <span style="white-space: pre-wrap;">Décochez l'option </span>****Public Bot****.
- Cela empêchera votre bot d’être visible publiquement et donc ajouté à d’autres serveurs.

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