De ingebouwde webhooks van Discord maken het gemakkelijk om automatisch berichten en updates te sturen naar een tekstkanaal in je server. Denk aan van die buizenpost bij de bank waar je geld in kunt stoppen, met als grote verschil dat je het geld vervolgens nooit meer terugziet, terwijl de berichten bij Discord worden gekopieerd vanaf een ander platform.
Schoomp
Door een webhook-eindpunt in je server te creëren, wordt er een webhook-URL gegenereerd die je voor verschillende andere diensten kunt gebruiken om de twee zo te linken.
Iedereen houdt van buizenpost (echt waar!), maar het is belangrijk te weten dat er voor webhooks een andere website nodig is om ze te kunnen gebruiken (alhoewel aspirerende programmeurs mogen proberen hun eigen ‘buizensysteem’ te maken). Bij sommige diensten en websites kun je heel gemakkelijk gebruik maken van webhooks, bij andere is dit iets lastiger:
| Kan webhooks gebruiken: | Kan niet echt webhooks gebruiken: |
| GitHub | Twitch / YouTube |
| CircleCI | Nelly The Hamster |
| DataDog |
Mocht je GitHub commits of gegevens van DataDog of iets vergelijkbaars op je Discord server willen plaatsen, dan doe je dit zo:
1. Open het tabblad Webhook in je serverinstellingen
2. Klik op de groene knop om een nieuwe webhook te creëren!
Je hebt hier verschillende opties:
- Profielafbeelding bewerken: klik op de afbeelding naast de naam in de linkerbovenhoek
- Kies in welk kanaal de webhook berichten moet plaatsen: selecteer het gewenste tekstkanaal uit de lijst
- Geef je webhook een naam: handig als je meerdere webhooks voor verschillende diensten gebruikt.
Nu heb je je eigen handige pneumatische buis a.k.a URL waarmee je naar websites kunt linken om berichten van te ontvangen
Voorbeeld: GitHub-webhookintegratie
Aangezien webhooks niet werken als een op zichzelf staand iets, nemen we GitHub als voorbeeld om te laten zien hoe je de webhooks van Discord kunt gebruiken. Voor de programmeerliefhebbers onder ons is het mogelijk om code-updates van een Github-repository naar een tekstkanaal in een Discord-server te sturen.
1. Kopieer de webhook-URL voor de server en het kanaal waarop je de berichten wilt ontvangen:
In mijn server heb ik een tekstkanaal genaamd #gitupdates gecreëerd. Ik wil dat de updates van Github hier naartoe worden gestuurd, dus ik kopieer de webhook-URL van dit kanaal:
2. Plak de webhook-URL in de instellingen van je GitHub-repository
Kies de repository waarvan je updates voor je Discord-server wilt ontvangen. Ga vervolgens naar het webhooksmenu in de instellingen:
Mooi. Klik op de knop ‘Webhook toevoegen’, en plak de Discord-URL in het veld genaamd ’Payload URL’.
Om ervoor te zorgen dat de webhook de berichten juist weergeeft is het heel heel heel heel HEEL erg belangrijk dat je ‘/github’ aan het einde toevoegt. Ja, zo belangrijk dat er vijf keer ‘heel’ voor nodig is.
Behalve de URL, zijn er ook nog een aantal andere GitHub-opties waar je uit kunt kiezen. Voor het inhoudstype is application/json goed. De webhooks van Discord werken het beste met JSON. In het volgende onderdeel, kun je instellen welk soort activiteit webhook-berichten op gang zet.
Klik op de ‘Webhook toevoegen’-knop onder de opties voor meldingen, en klaar is kees! Alle updates in de repository (inclusief aanpassingen aan het readme-bestand) verschijnen nu in je tekstkanaal:
GitHub is slechts één voorbeeld van de vele mogelijkheden voor integratie met webhooks.