Les Webhooks intégrés à Discord constituent un moyen simple d'envoyer des messages automatisés et des mises à jour de données à un salon de texte de votre serveur. Considérez-les comme l'un de ces tubes pneumatiques sophistiqués dans lesquels vous aimiez envoyer de l'argent dans une banque et regardez disparaître, mais au lieu de ne plus jamais revoir votre argent, vous envoyez en fait des messages dans Discord à partir d'une autre plate-forme.
En créant un point de terminaison Webhook sur votre serveur, vous générez une URL Webhook que vous pourrez déposer dans un certain nombre d'autres services différents pour lier les deux.
Alors que tout le monde aime absolument les tubes pneumatiques (100% vrai), il est important de noter que les webhooks nécessitent un autre site Web à utiliser (bien que les utilisateurs enclins à la programmation puissent créer eux-mêmes leur propre tube pneumatique). Certains services et sites Web sont conçus pour intégrer facilement des webhooks et envoyer des messages vers l'extérieur, mais certains ne le sont pas. Voici une petite liste de références pratique :
Peut utiliser des webhooks : | Ne peut pas vraiment utiliser les webhooks : |
GitHub | Twitch / YouTube |
CircleCI | Nelly The Hamster |
DataDog |
FAIRE UN WEBHOOK
Dans cet esprit, si vous souhaitez mettre à jour votre serveur Discord avec les commits GitHub et les demandes d'extraction ou suivre les analyses de DataDog ou quelque chose de similaire, voici comment !
- Ouvrez l'onglet Webhook de vos paramètres de serveur :
- Cliquez sur le bouton pour créer un nouveau webhook !
Vous aurez quelques options ici. Vous pouvez :
- Modifier l'avatar : En cliquant sur l'avatar à côté du Nom en haut à gauche
- Choisir le salon dans lequel le Webhook sera publié : En sélectionnant le salon textuel souhaité dans le menu déroulant.
- Nommer votre Webhook : bon pour distinguer plusieurs webhooks pour plusieurs services différents.
Vous avez maintenant votre propre URL pratique / schoomp-er de tube pneumatique que vous pouvez lier à plus de sites Web pour recevoir des messages.
EXEMPLE RAPIDE : INTÉGRATION DU WEBHOOK GITHUB
Étant donné que les webhooks ne peuvent pas vraiment fonctionner seuls et doivent être liés à un autre site Web pour fonctionner comme prévu, j'ai pensé qu'il serait préférable d'inclure un exemple d'intégration pour tous les passionnés de GitHub et les pousseurs de code. Vous pouvez utiliser les webhooks de Discord pour envoyer n'importe quelle fusion de code ou pousser les mises à jour dans un de vos référentiels vers un salon textuel sur votre serveur.
1. Obtenez l'URL du webhook pour le serveur/salon sur lequel vous souhaitez recevoir des messages:
Sur mon serveur, j'ai créé un salon textuel intitulé #gitupdates. Je veux que mes mises à jour de référentiel publient des messages ici, donc je vais saisir l'URL du webhook pour ce salon :
2. Ajoutez l'URL du webhook dans vos paramètres de référentiel GitHub
Choisissez le référentiel à partir duquel vous souhaitez obtenir des mises à jour sur votre serveur Discord. Une fois le référentiel sélectionné, rendez-vous dans le menu paramètres > webhooks :
Cool. Cliquez sur le bouton "Ajouter un webhook" et entrez l'URL générée par Discord dans le champ "URL de charge utile".
Pour que le webhook affiche correctement les messages, il est vraiment vraiment vraiment vraiment très important que vous ajoutiez '/github' à la fin. Oui, genre cinq, c'est vraiment important.
En plus de l'URL, vous avez le choix entre d'autres options spécifiques à GitHub. Pour le type de contenu, restez avec application/json. Le format webhook de Discord aime vraiment JSON. Dans la section suivante, vous pouvez choisir de personnaliser le type d'événements qui déclenchent les messages de webhook.
Cliquez sur le dernier bouton "Ajouter un webhook" sous l'option de personnalisation des notifications d'événements, et vous êtes prêt ! Pousser toutes les mises à jour dans le référentiel (y compris la modification du fichier readme) apparaîtra dans votre salon textuel :
Et vous êtes prêt ! GitHub n'est qu'un exemple d'intégration capable de publier des messages via un webhook. Si vous avez un don pour la création d'applications JSON ou les requêtes HTTP POST et que vous souhaitez personnaliser vos propres webhooks, vous pouvez trouver plus d'informations dans nos documents pour développeurs.