De ingebouwde Webhooks van Discord bieden je een eenvoudige manier om geautomatiseerde berichten en data-updates naar een tekstkanaal in je Server te krijgen.
Zie ze als een van die chique pneumatische buizen waar je vroeger bij de bank graag geld in stopte om het te zien verdwijnen, maar in plaats van je geld nooit meer terug te zien, stuur je nu berichten naar Discord vanaf een ander Platform.
Door een webhook-eindpunt op je server te maken, genereer je een Webhook-URL die je kunt droppen in een aantal verschillende andere services om de twee te koppelen.
Hoewel iedereen dol is op pneumatische buizen (100% waar), is het belangrijk om te onthouden dat webhooks een andere website vereisen om te gebruiken (hoewel gebruikers die geïnteresseerd zijn in programmeren zelf hun eigen buisschoomper kunnen maken).
Sommige services en websites zijn ontworpen om eenvoudig webhooks te integreren en berichten naar buiten te versturen, maar sommige zijn dat niet. Hier is een handige referentielijst:
| Kunnen Webhooks gebruiken: | Kunnen Webhooks niet echt gebruiken: |
| GitHub | Twitch / YouTube |
| CircleCI | Nelly de hamster |
| DataDog |
Een webhook maken
Met dat in gedachten, als je je Discord-server wilt updaten met GitHub-commits en pull-verzoeken of analyses wilt bijhouden van DataDog of iets vergelijkbaars, lees je hier hoe je dat doet!
- Toegankelijk je serverinstellingen en ga naar het tabblad Integraties:
- Klik op de knop 'Webhook maken' om een nieuwe webhook te maken!
Hier heb je een paar opties. Je kunt:
- Bewerken de avatar: Door linksboven op de avatar naast de naam te klikken
- Kies in welk kanaal de webhook posts: Door het gewenste tekstkanaal te selecteren in het dropdownmenu.
- Naam je Webhook: Goed om meerdere webhooks voor meerdere verschillende services te onderscheiden.
Je hebt nu je eigen handige URL / pneumatische buisschoomp-er die je kunt linken naar meer websites om berichten te ontvangen.
Snel voorbeeld: GitHub-webhook-integratie
Omdat Webhooks niet echt op zichzelf kunnen functioneren en aan een andere website moeten worden gekoppeld om naar behoren te functioneren, leek het me het beste om een voorbeeldintegratie op te nemen voor GitHub-enthousiastelingen en code-pushers.
Je kunt de webhooks van Discord gebruiken om code-samenvoegingen te verzenden of pushupdates uit een repository van je naar een tekstkanaal van je server te verzenden.
1. Krijg de webhook-URL voor de server of het kanaal waarnaar je berichten wilt ontvangen:
Ik heb in mijn Server een Tekstkanaal gemaakt met de tag #general-chat en ik wil dat mijn repo-updates hier Berichten plaatsen!
Daarom pak ik de webhook-URL voor dit kanaal door op de knop Webhook-URL kopiëren te klikken:
2. Voeg de webhook-URL toe aan je GitHub-repo-instellingen
Kies de repository vanwaar je updates wilt ontvangen op je Discord-server. Nadat je de repo hebt Geselecteerd, ga je naar het menu Instellingen > Webhooks
Klik vervolgens op de knop 'Webhook toevoegen' en voer de door Discord gegenereerde URL in het lege veld 'Payload URL' in.
Om ervoor te zorgen dat de webhook Berichten correct weergeeft, is het echt echt echt ECHT echt belangrijk dat Jij aan het einde '/github' toevoegt. Ja, zoals vijf-keer-echt belangrijk.
Naast de URL heb je nog enkele andere GitHub-specifieke opties waaruit je kunt kiezen. Voor Content Soort, blijf bij Applicatie/json. De webhook-indeling van Discord houdt erg van JSON. In het volgende gedeelte kun Jij kiezen om aan te passen welk type Evenementen webhook berichten triggeren.
Klik op de laatste knop 'Webhook toevoegen' onder de optie 'Evenementmeldingen aanpassen'. En je bent klaar. Het pushen van updates in de repo (inclusief het bewerken van het readme-Bestand) zal worden getoond in je tekstkanaal:
Dat was alles! GitHub is slechts één voorbeeld van een integratie waarmee berichten via webhook kunnen worden geplaatst. Als je ervaring hebt met het bouwen van JSON-applicaties of HTTP POST-verzoeken en je eigen webhooks wilt aanpassen, kun je meer informatie vinden in onze documentatie voor ontwikkelaars.