Discords eingebaute Webhooks-Funktion ist eine einfache Möglichkeit, automatische Nachrichten und Updates in einen Text-Kanal auf deinem Server zu schicken. Stell dir das einfach als eine dieser alten, pneumatischen Röhrchen vor, mit denen man früher Geld in eine Bank schicken konnte. Aber anstatt dass du dein Geld nie wiedersehen wirst, schickst du in diesem Fall tatsächlich Nachrichten von einer anderen Plattform nach Discord.
Durch das Erstellen eines Webhook-Endpunktes auf deinem Server erstellst du eine Webhook-URL, welche du in bestimmte andere Dienste einbinden kannst, um diese mit Discord zu verknüpfen.
Auch wenn wirklich absolut jeder pneumatische Röhrchen liebt (100% die Wahrheit), so ist es dennoch wichtig zu beachten, dass die Webhooks eine andere Internetseite zur Benutzung brauchen (Andererseits können programmierfreudige Nutzer auch ihre eigenen Röhrchen-Schoomper erstellen). Einige Dienste und Webseiten sind aufgebaut, um Webhooks und gesendete Nachrichten einzubinden, aber manche sind es nicht. Hier ist eine hilfreiche Referenzliste:
Kann Webhooks benutzen: |
Kann keine Webhooks benutzen: |
GitHub |
Twitch / YouTube |
CircleCI |
Nelly The Hamster |
DataDog |
|
EINEN WEBHOOK ERSTELLEN
Wenn du deinen Discord Server also mit GitHub commits and "pull"-Anfragen, Track-Analytik von DataDog oder ähnlichen Optionen updaten willst, dann erklären wir dir hier, wie es geht!
- Öffne deinen Webhook-Reiter in den Servereinstellungen:
- Klicke auf den blau lilanen Knopf, um einen neuen Webhook zu erstellen!
Du hast ein paar Optionen hier. Du kannst:
- Den Avatar editieren: Indem du einfach auf den Avatar neben dem Namen oben links drückst.
- Auswählen, in welchen Kanal der Webhook schreiben wird: Wähle den gewünschten Text-Kanal einfach im Dropdown-Menü aus.
- Den Webhook benennen: Hilfreich, wenn du mehrere Webhooks für verschiedene Dienste auseinander halten willst.
Du hast jetzt deine eigene, nützliche URL / pneumatische Röhre, die du auf verschiedene Webseiten verlinken kannst, um von dort Nachrichten zu erhalten.
EIN KURZES BEISPIEL: GITHUB WEBHOOK INTEGRATION
Da Webhooks nicht unabhängig ausgeführt werden können und für die gewünschte Funktion auf andere Webseiten verlinkt werden müssen, ist es vermutlich am besten, wenn ich ein Beispiel für euch GitHub-Enthusiasten und Code-Pusher einfüge. Du kannst Discords Webhooks verwenden, um jegliche Code Merges oder push Updates aus deiner Ablage in einen Text-Kanal deines Servers zu schicken.
- Erhalte die Webhook-URL für den Server/Kanal, auf dem du Nachrichten erhalten möchtest:
In meinem Server habe ich dafür einen Text-Kanal mit dem Namen #gitupdates erstellt. Ich möchte, dass Updates meiner Ablage hier Nachrichten schreiben, also schnappe ich mir die Webhook-URL für diesen Kanal:
- Füge die Webhook-URL in deine GitHub Ablage-Einstellungen ein
Wähle die Ablage aus, von welcher du Updates auf deinen Discord-Server bekommen möchtest. Sobald du diese ausgewählt hast, gehe in das Menü unter "Einstellungen > Webhooks":
Sauber. Klicke auf den "Webhook hinzufügen"-Button und gib die von Discord erstellte URL in das leere "Payload URL"-Feld ein.
Damit der Webhook die Nachrichten anständig anzeigt, ist es wirklich wirklich wirklich WIRKLICH wirklich wichtig, dass du am Ende noch "/github" hinzufügst. Ja, so wichtig, dass wir das gleich fünfmal wiederholen.
Zusätzlich zu der URL hast du noch ein paar weitere, GitHub-spezifische Optionen zur Auswahl. Für den Inhalts-Typ solltest du bei application/json bleiben. Discords Webhook-Format mag JSON wirklich sehr. Im nächsten Abschnitt kannst du individuell anpassen, welche Art von Ereignissen Webhook-Nachrichten auslösen sollen.
Klicke auf den letzten "Webhook hinzufügen"-Button unter den Anpassungsoptionen für Ereignis-Benachrichtigungen, und alles sollte bereit sein! Updates in der Ablage (inklusive Änderungen in der Readme-Datei) werden in deinem Text-Kanal dann wie folgt angezeigt:
Und das war's! GitHub ist natürlich nur ein Beispiel einer möglichen Integration, die über einen Webhook Nachrichten posten kann. Wenn du dich mit JSON Apps oder HTTP POST Requests auskennst und deinen Webhook individuell anpassen willst, dann kannst du in unseren Entwickler Dokumenten weitere Informationen finden.