Configurer un Webhook Discord

Ce guide explique pas à pas comment créer et récupérer une URL de Webhook Discord afin de permettre à Podcast Utilities de communiquer avec votre serveur.

🎯 Objectif

Dans l'écosystème de Podcast Utilities, l'intégration Discord permet au système d'envoyer automatiquement des messages (comme des alertes ou des notifications de publication) directement dans l'un de vos salons textuels.

Pour autoriser l'application à publier ces messages sans nécessiter un compte utilisateur complet, vous devez générer une URL unique appelée DISCORD_WEBHOOK_URL.

📝 Étapes à suivre

Ouvrez l'application Discord (sur ordinateur ou via votre navigateur) et rendez-vous sur votre serveur.
Identifiez le salon textuel dans lequel vous souhaitez recevoir les notifications (par exemple, un salon #annonces ou #logs-podcast).
Survolez le nom de ce salon avec votre souris et cliquez sur l'icône d'engrenage ⚙️ Modifier le salon.
Dans le menu latéral de gauche, cliquez sur l'onglet Intégrations.
Cliquez sur Créer un webhook (ou sur Voir les webhooks puis Nouveau webhook si vous en avez déjà d'autres).
Personnalisez votre webhook : donnez-lui un nom clair (ex: "Podcast Utilities") et ajoutez éventuellement le logo de votre projet.
Cliquez sur le bouton Copier l'URL du webhook.
N'oubliez pas de cliquer sur Enregistrer les modifications en bas de l'écran.

⚙️ Intégration dans le fichier .env

Retournez dans votre fichier .env à la racine de votre dossier de déploiement, et collez l'URL face à la variable correspondante :

DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/votre_identifiant/votre_cle_secrete

⚠️ Points d'attention

Sécurité : Toute personne en possession de cette URL peut envoyer des messages dans votre salon Discord. Gardez-la strictement confidentielle et ne publiez jamais votre fichier .env.
Maintien du lien : Si vous supprimez le webhook dans les paramètres de Discord ou si vous supprimez le salon textuel associé, l'URL deviendra obsolète et Podcast Utilities ne pourra plus envoyer de notifications.