# Newsletter

Depuis la version 3.1.0, les newsletters sont disponibles pour les domaines. Une newsletter est une liste qui permet d'enregistrer plusieurs adresses e-mail. Il est désormais possible d'ajouter plusieurs adresses e-mail à cette liste pour envoyer des e-mails à plusieurs destinataires sans avoir à toutes les saisir.

<p class="callout info">Les newsletters ne sont disponibles que pour les domaines privés, mais peuvent contenir tous types de domaines !</p>

**Pour ajouter une newsletter à un domaine :**

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

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

**Le code de la newsletter vous permettra de :**

- <span style="white-space: pre-wrap;">Interagir avec l'API : </span>[API Mail RP](https://api-doc.mail-rp.com/ajouter-une-newsletter.html)
- <span style="white-space: pre-wrap;">Permettre à vos membres Discord de s'inscrire à la newsletter directement : </span>[Gérer mes newsletters | WIKI XELYOS](https://wiki.xelyos.fr/books/interface-utilisateur/page/gerer-mes-newsletters)

#### Ajouter manuellement des adresses

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

<p class="callout success"><span style="white-space: pre-wrap;">Saisissez l'adresse et appuyez sur </span>**entrer**<span style="white-space: pre-wrap;"> pour valider</span></p>

#### Créer un formulaire de réaction sur Discord pour rejoindre une newsletter

<span style="white-space: pre-wrap;">Grâce à notre bot Discord, permettez à vos membres de s'inscrire directement à votre newsletter via un formulaire interactif, sans qu'ils aient besoin de connaître le code de la newsletter. </span>

##### Étapes pour configurer le formulaire d'inscription

- **Écrire un message informatif**

Commencez par rédiger un message expliquant l'objet de la newsletter. Ce message doit informer les utilisateurs de ce qu'ils recevront en s'abonnant, par exemple :

> <span style="white-space: pre-wrap;">📨 </span>**Rejoignez notre newsletter !**  
> Abonnez-vous pour recevoir les dernières nouvelles, des mises à jour exclusives et du contenu spécial directement dans votre boîte mail.

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/scaled-1680-/rwximage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/rwximage.png)

- **Créer le formulaire via le bot**

<span style="white-space: pre-wrap;">Utilisez la commande </span>`<span class="editor-theme-code">/newsletter</span>`<span style="white-space: pre-wrap;"> pour configurer le formulaire d'inscription. Cette commande permet de lier le message explicatif à un formulaire d'inscription qui apparaîtra sous forme de bouton interactif dans Discord.</span>

Voici les informations que vous devrez fournir lors de la création du formulaire :

- **Code de la newsletter (code)**<span style="white-space: pre-wrap;"> : C'est l'identifiant unique de votre newsletter. Il permet au bot de lier les inscriptions à la bonne liste.</span>
- **ID du message Discord (message)**<span style="white-space: pre-wrap;"> : C'est l'ID du message que vous avez publié avec l'explication de la newsletter (étape précédente). Cela permet d'ajouter le formulaire sous ce message.</span>

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/scaled-1680-/E8Uimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/E8Uimage.png)

- **Affichage du bouton d'inscription**

Une fois la commande exécutée, un bouton d'inscription sera automatiquement généré sous votre message explicatif. Ce bouton, intitulé "S'abonner", permet aux membres de cliquer pour entamer le processus d'inscription à la newsletter.

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/scaled-1680-/cunimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/cunimage.png)

- **Collecte des mails**

<span style="white-space: pre-wrap;">Après avoir cliqué sur le bouton, l'utilisateur sera invité à entrer son adresse e-mail dans une fenêtre de message privée avec le bot. </span>

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/scaled-1680-/WlYimage.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/WlYimage.png)

- **Confirmation d'inscription**

Une fois l'adresse saisie, le bot enverra une confirmation à l'utilisateur pour lui indiquer que son inscription a bien été prise en compte.

[![image.png](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/scaled-1680-/dU6image.png)](https://xelyos-wiki.s3.amazonaws.com/uploads/images/gallery/2026-01/dU6image.png)