Les webhooks intégrés de Discord sont un moyen facile d'obtenir des messages automatisés et des mises à jour de données envoyées sur un salon textuel dans ton serveur.
Considère-les comme l'un de ces tubes pneumatiques fantaisistes auxquels tu aimais envoyer de l'argent dans une banque en le regardant disparaître. Mais au lieu de ne plus jamais voir ton argent, tu envoies en fait des messages sur Discord depuis une autre plateforme.
En créant un point de terminaison Webhook dans ton serveur, tu généreras une URL Webhook que tu pourras partager avec d'autres services différents pour lier les deux.
Bien que tout le monde adore les tubes pneumatiques (vrai à 100 % ), il est important de noter que les webhooks nécessitent un autre site web pour être utilisés (bien que les utilisateurs enclins à la programmation puissent créer leur propre tube schoomper eux-mêmes).
Certains services et sites web sont conçus pour intégrer facilement les Webhooks et envoyer des messages vers l'extérieur, mais d'autres ne le sont pas. Voici une petite liste de référence pratique :
| Peut utiliser les webhooks : | Ne peut pas vraiment utiliser les webhooks : |
| GitHub | Twitch / YouTube |
| CircleCI | Nelly The Hamster |
| DataDog |
Créer un webhook
Dans cet esprit, si tu souhaites mettre à jour ton serveur Discord avec les commits GitHub et les pull requests ou suivre les analyses de DataDog ou autre chose de similaire, voici comment !
- Ouvre les Paramètres du serveur et accède à l'onglet Intégrations :
- Clique sur le bouton « Création de webhook » pour créer un nouveau webhook !
Tu auras quelques options ici. Tu peux :
- Modifier l'avatar : en cliquant sur l'avatar à côté du Nom en haut à gauche
- Choisis le salon sur lequel le Webhook publie les posts : en sélectionnant le salon textuel souhaité dans le menu déroulant.
- Donne un nom à ton Webhook : bien pour distinguer plusieurs Webhooks pour plusieurs services différents.
Tu disposes à présent de ta propre URL / tube pneumatique pratique « schoomp-er » que tu peux relier à d'autres sites Web pour recevoir des messages.
Exemple rapide : intégration de webhook GitHub
Étant donné que les Webhooks ne fonctionnent pas seuls et doivent être liés à un autre site web pour fonctionner comme prévu, j'ai pensé qu'il serait mieux d'inclure un exemple d'intégration pour vous, les passionnés de GitHub et les développeurs de code.
Tu peux utiliser les webhooks de Discord pour envoyer toute fusion de code ou mise à jour en push dans l'un des dépôts que tu possèdes dans un salon textuel de ton serveur.
1. Obtiens l'URL du Webhook pour le serveur/salon avec lequel tu souhaites recevoir des messages :
Sur mon serveur, j'ai créé un salon textuel appelé #general-chat et je souhaite que les mises à jour de mon repo publient des messages ici !
Par conséquent, je vais récupérer l'URL du webhook pour ce salon en appuyant sur le bouton Copier l'URL du webhook :
2. Ajoute l'URL de webhook dans les paramètres de ton repo GitHub
Choisis le référentiel à partir de lequel tu souhaites recevoir les mises à jour dans ton Serveur Discord. Une fois que tu as sélectionné le repo, accède au menu Paramètres > Webhooks
Puis clique sur le bouton « Ajouter un webhook » et saisis l'URL générée par Discord dans l'espace « URL de la charge utile » vierge.
Pour que le webhook affiche correctement les messages, il est vraiment vraiment vraiment VRAIMENT vraiment important que tu ajoutes '/github' à la fin de celui-ci. Oui, c'est important comme cinq fois le mot « vraiment ».
En plus de l'URL, tu as d'autres options spécifiques à GitHub parmi lesquelles choisir. Pour le type de contenu, reste sur application/json. Le format de webhook de Discord aime beaucoup le JSON. Dans la section suivante, tu peux choisir de personnaliser le type d'événements qui déclenchent les messages de webhook.
Clique sur le dernier bouton « Ajouter un webhook » sous l'option de personnalisation des notifications d'événements, et tout est prêt ! Toute mise à jour dans le dépôt (y compris l'édition du fichier readme) sera affichée dans ton salon textuel :
Et le tour est joué ! GitHub n'est qu'un exemple d'intégration qui peut publier des messages via webhook. Si tu as un don pour la création d'applications JSON ou les requêtes HTTP POST et que tu souhaites personnaliser tes propres Webhooks, tu peux trouver plus d'informations dans notre documentation pour Développeur.