diff --git a/docs/2.modules/9.logs.md b/docs/2.modules/9.logs.md index daa2750b8..ff759ecec 100644 --- a/docs/2.modules/9.logs.md +++ b/docs/2.modules/9.logs.md @@ -67,6 +67,70 @@ Les logs sont des embeds qui sont envoyés non pas par **DraftBot**, mais par de :: :: +## Configuration des destinations + +Chaque log peut être envoyé vers différentes destinations. + +### Choix de la destination + +::tabs + ::tab{ label="Via le panel" } + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/logs) + + ![Configuration d'un module de log depuis le panel](../assets/logs/panel_module.png) + + Vous pouvez choisir la destination d'envoi des logs en cliquant sur **Modifier** puis choisir le type de destination parmi [ces options](#les-options). + :: + + ::tab{ label="Via la commande /config" } + Si vous souhaitez effectuer toute la configuration directement depuis Discord, vous pouvez le faire via la commande /config, puis en vous rendant dans l'onglet "Logs". Le menu ressemble alors à ceci : + + ![Configuration d'un module de log depuis le /config](../assets/logs/config_moderation.png) + + Vous pouvez choisir la destination d'envoi des logs en cliquant sur **Destination** puis choisir le type de destination parmi [ces options](#les-options). + :: +:: + +### Les options + +::tabs + ::tab{ label="Serveur" } + Les logs sont envoyés dans un salon du serveur via un webhook géré automatiquement par **DraftBot**. + + Un webhook vous permet d'envoyer un message avec une photo de profil, un nom et un contenu personnalisé. + + > ***DraftBot** gère ses propres webhooks et l'envoi des messages avec ses derniers. Si vous supprimez son webhook de logs, il le recréera automatiquement lors de l'envoi du prochain log.* + :: + + ::tab{ label="Autres serveurs" } + Les logs sont envoyés vers un autre serveur Discord à l'aide d'un **webhook Discord** externe. + + > Exemple : + > https://discord.com/api/webhooks/ + + ::hint{ type="warning" } + Vous devez être propriétaire du serveur en question afin de pouvoir configurer cette fonctionnalité. + :: + :: + + ::tab{ label="API Externe" } + Les logs sont envoyés vers une URL externe (API, site web, service tiers). + + | Type | Description | Exemple | + |------|-------------|---------| + | **URL personnalisée** | URL vers laquelle les données sont envoyées. Elle doit être valide et commencer par http:// ou https://. | https://example.com/webhook | + | **Headers HTTP personnalisés** | Paires clé/valeur ajoutées à la requête HTTP (authentification, options…). Jusqu'à 3 headers sont autorisés. | X-API-Key: YOUR_API_KEY | + + ::hint{ type="info" } + Cette fonctionnalité est réservée aux serveurs [premium](/premium) <:icon_premium_:1096140508625125417>. + :: + + ::hint{ type="warning" } + Vous devez être propriétaire du serveur en question afin de pouvoir configurer cette fonctionnalité. + :: + :: +:: + ## Configuration par module ::tabs @@ -115,3 +179,5 @@ Les logs sont des embeds qui sont envoyés non pas par **DraftBot**, mais par de :: :: + + diff --git a/docs/assets/logs/config_moderation.png b/docs/assets/logs/config_moderation.png new file mode 100644 index 000000000..bda10070c Binary files /dev/null and b/docs/assets/logs/config_moderation.png differ diff --git a/docs/assets/logs/panel_module.png b/docs/assets/logs/panel_module.png index 4967373e9..0cd30a623 100644 Binary files a/docs/assets/logs/panel_module.png and b/docs/assets/logs/panel_module.png differ