Discords inbyggda Webhookar fungerar som ett enkelt sätt att få automatiserade meddelanden och datauppdateringar skickade till en textkanal i din server.
Tänk på dem som en av de fina pneumatiska rörsakerna du brukade älska att skicka pengar till på en bank och se försvinna, men istället för att aldrig se dina pengar igen skickar du faktiskt meddelanden till Discord från en annan plattform.
Genom att skapa en webhook-slutpunkt i din server kommer du att generera en Webhook-URL som du kan släppa i ett antal olika andra tjänster för att länka de två.
Även om alla absolut älskar pneumatiska rör (100% sant) är det viktigt att notera att webhookar kräver en annan webbplats för att använda (även om programmeringsbenägna användare kan göra sin egen tube schoomper själva).
Vissa tjänster och webbplatser är byggda för att enkelt inkludera webhookar och skicka meddelanden utåt, men vissa är inte det. Här är en liten praktisk referenslista:
| Kan använda webhookar: | Kan inte riktigt använda webhookar: |
| GitHub | Twitch / YouTube |
| CircleCI | Nelly The Hamster |
| DataDog |
Skapa en Webhook
Med det i åtanke, om du vill uppdatera din Discord-server med GitHub-commits och pull requests eller spåra analys från DataDog eller något liknande, så här gör du!
- Öppna dina Serverinställningar och gå till fliken Integrationer:
- Klicka på knappen "Skapa webhook" för att skapa en ny webhook!
Du kommer att ha några alternativ här. Du kan:
- Ändra avataren: Genom att klicka på avataren bredvid namnet överst till vänster
- Välj vilken kanal din webhook postar till: Genom att välja önskad textkanal i rullgardinsmenyn.
- Namnge din Webhook: Bra för att skilja mellan flera webbhooks för flera olika tjänster.
Du har nu din egen praktiska URL / pneumatic tube schoomp-er som du kan länka till fler webbplatser för att få meddelanden från.
Snabbt exempel: GitHub-Webhook-integration
Eftersom Webhookar inte riktigt kan fungera på egen hand och måste länkas till en annan webbplats för att fungera som avsett, tyckte jag att det skulle vara bäst att inkludera en exempelintegration för någon av er GitHub-entusiaster och kodpushers.
Du kan använda Discords Webhookar för att skicka kodsammanslagningar eller push-uppdateringar i ett arkiv till en textkanal i din server.
1. Hämta webhook-URL:en för den server/kanal du vill få meddelanden:
I min server har jag skapat en textkanal märkt #general-chat och jag vill att mina repo-uppdateringar ska publicera meddelanden här!
Därför kommer jag att hämta webhook-URL:en för denna kanal genom att trycka på knappen Kopiera Webhook-URL:
2. Lägg till webhook-URL:en i dina GitHub-repo-inställningar
Välj det arkiv som du vill få uppdateringar från i din Discord-server. När du har valt ditt repo går du till menyn Inställningar > Webhookar
Och klicka sedan på knappen "Lägg till webhook" och ange den Discord-genererade URL:en i "Payload URL"-fältet.
För att få din webhook att visa meddelanden korrekt är det verkligen verkligen verkligen VERKLIGEN verkligen viktigt att du lägger till '/github' i slutet av den. Ja, som fem-verkligen-viktigt.
Förutom URL:en har du några mer GitHub-specifika alternativ att välja mellan. För Innehållstyp, håll dig till Applikation/json. Discords webhook-format gillar verkligen JSON. I nästa avsnitt kan du välja att anpassa vilken typ av event som utlöser webhook-meddelanden.
Klicka på den sista knappen "Lägg till webhook" under Option för Eventaviseringar, och du är redo! Att pusha eventuella uppdateringar i repon (inklusive redigering av readme-filen) kommer att visas i din Textkanal:
Sen är du klar! GitHub är bara ett exempel på en integration som kan skicka meddelanden via webbhook. Om Du har en talang för JSON-applikationsbyggande Eller HTTP post-förfrågningar och vill Anpassa dina egna Webhookar kan Du hitta mer Information i vår utvecklardokumentation.