Recevoir les alertes de domaine dans Discord

Créez un webhook de salon Discord et reliez-le à Domain Sentinel pour recevoir expirations, changements DNS et alertes de disponibilité sous forme d'embeds.

Beaucoup de petites équipes et de projets perso vivent déjà sur Discord. Domain Sentinel peut poster chaque alerte dans un salon via un webhook de salon : rien à héberger, une URL à coller. Comptez cinq minutes.

Ce que vous obtenez

Chaque alerte arrive sous forme d'embed : un titre lié au domaine dans Domain Sentinel, le résumé, une couleur par type d'alerte (vert quand un domaine se libère, ambre pour un rappel d'expiration, rouge pour un certificat sur le point d'expirer), et des champs pour l'événement, le domaine et la liste des changements quand il y en a. Rappels d'expiration, alertes de disponibilité et d'enregistrement, changements registre et DNS, expiration de certificat et rapport périodique passent par le même salon, et vous choisissez lesquels il reçoit.

Étape 1 : créer le webhook dans Discord

Ouvrez les paramètres du salon (la roue à côté de son nom, ou Modifier le salon).
Allez dans Intégrations, puis Webhooks, et cliquez sur Nouveau webhook.
Donnez-lui un nom (il apparaît comme expéditeur, « Domain Sentinel » convient) et vérifiez qu'il vise le bon salon.
Cliquez sur Copier l'URL du webhook. Elle commence par https://discord.com/api/webhooks/.

Cette URL est un secret : quiconque la possède peut écrire dans le salon. Traitez-la comme un mot de passe.

Étape 2 : ajouter l'endpoint dans Domain Sentinel

Dans le tableau de bord, ouvrez Notifications, Réglages, puis Webhooks (ou allez directement sur Webhooks).
Cliquez sur Ajouter un webhook, donnez un libellé, collez l'URL Discord et choisissez le format Discord.
Choisissez les filtres. Rien de coché signifie tous les types d'alerte. Le périmètre permet de n'envoyer que certains domaines, par groupe de monitoring ou choisis un par un.
Enregistrez, puis cliquez sur Envoyer un test sur la ligne. Un embed de test doit apparaître aussitôt dans le salon.

Le format Discord envoie un embed et aucun en-tête de signature, Discord n'en vérifie pas. Si vous avez besoin du JSON brut, utilisez le format JSON.

Conseils

Un webhook par salon, un salon par sujet. Un salon pour les expirations seulement (cochez « Un domaine expire bientôt »), un autre pour les changements DNS des domaines de production (changements DNS, limité au groupe Production).
Coupez l'e-mail si Discord suffit. Dans les réglages de notification, l'interrupteur Email arrête les mails d'alerte ; les alertes restent dans l'application et continuent vers Discord.
Limites de débit. Discord accepte quelques messages par seconde et par webhook. Domain Sentinel envoie un message par alerte, même un gros portefeuille reste très en dessous.

Si ça ne marche pas

« HTTP 400 » au test : l'URL n'est pas un webhook Discord, ou le format est resté sur JSON. Passez le format sur Discord.
« HTTP 401 » ou « HTTP 404 » : le webhook a été supprimé côté Discord. Créez-en un nouveau et mettez l'URL à jour.
L'endpoint affiche « Coupé après échecs » : dix envois consécutifs ont échoué, Domain Sentinel a cessé d'essayer. Réparez le récepteur, puis cliquez sur Activer ; le compteur repart de zéro.

Pour Slack, voir Recevoir les alertes de domaine dans Slack. Pour le contenu des alertes elles-mêmes, voir Alertes de surveillance de domaine.