Was ist ein Slack-Webhook?
Ein Slack-Webhook – offiziell Incoming Webhook – ist eine eindeutige URL, über die ein externer Dienst Nachrichten in einen Slack-Kanal posten kann. Sie müssen weder einen Bot-Token noch einen OAuth-Ablauf implementieren: Der Dienst sendet eine HTTP-POST-Anfrage mit einer JSON-Payload, und die Nachricht erscheint im Kanal. Damit ist ein Slack-Webhook der einfachste Weg, Ihrem Team Website-Monitoring-Alarme in dem Moment zu zeigen, in dem etwas ausfällt.
So funktionieren Incoming Webhooks
Jede Webhook-URL gehört zu einer Slack-App und ist an den einen Kanal gebunden, den Sie beim Erstellen ausgewählt haben. Erkennt Ihr Monitoring-Dienst ein Problem, sendet er eine POST-Anfrage mit einem JSON-Body wie {"text": "example.com ist nicht erreichbar"} an diese URL. Slack postet die Nachricht in den Kanal. Nachrichten können reiner Text sein oder Block Kit für umfangreichere Layouts nutzen.
So erstellen Sie einen Slack Incoming Webhook
Die Einrichtung läuft bei Slack heute über eine Slack-App, die Sie unter api.slack.com/apps anlegen. Das dauert etwa fünf Minuten. Die Oberfläche von Slack ist englischsprachig, daher nennen wir die Bezeichnungen im Original.
Sie benötigen die Berechtigung, Apps in Ihrem Slack-Workspace zu installieren. Schränkt Ihr Workspace App-Installationen ein, fordert Slack Sie auf, die Freigabe bei einem Workspace-Admin anzufragen.
- 1
Slack-App erstellen
Öffnen Sie api.slack.com/apps und klicken Sie auf „Create New App“. Wählen Sie „From scratch“, geben Sie der App einen Namen wie „Website Monitor“, wählen Sie den Workspace für die Alarme und klicken Sie auf „Create App“.
- 2
Incoming Webhooks aktivieren
Öffnen Sie in den App-Einstellungen in der linken Seitenleiste „Incoming Webhooks“ und schalten Sie „Activate Incoming Webhooks“ ein.
- 3
Webhook zum Workspace hinzufügen
Scrollen Sie nach unten und klicken Sie auf „Add New Webhook to Workspace“. Slack fragt, in welchen Kanal die App posten soll – wählen Sie einen eigenen Kanal wie #alerts – und bestätigen Sie die Anfrage.
- 4
Webhook-URL kopieren
Zurück auf der Seite „Incoming Webhooks“ erscheint Ihre neue URL unter „Webhook URLs for Your Workspace“. Sie sieht so aus: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX. Kopieren Sie sie und behandeln Sie sie wie ein Passwort.
Slack-Webhook testen
Bevor Sie einen Monitoring-Dienst verbinden, prüfen Sie den Webhook mit einer Testnachricht aus dem Terminal. Ersetzen Sie die URL durch Ihre eigene:
curl -X POST -H 'Content-type: application/json' \
--data '{"text":"Test alert from my monitoring setup"}' \
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXIst alles richtig eingerichtet, antwortet Slack mit „ok“ und die Nachricht erscheint in Ihrem Kanal.
Slack-Webhook mit nanokoi.io verbinden
Slack-Alarme sind in jedem nanokoi.io-Tarif enthalten, auch im Free-Tarif. Sobald Sie Ihre Webhook-URL haben:
- 1Öffnen Sie die Benachrichtigungseinstellungen in Ihrem nanokoi.io-Konto
- 2Aktivieren Sie „Slack-Benachrichtigungen aktivieren“
- 3Fügen Sie Ihre Webhook-URL in das Feld „Slack Webhook URL“ ein
- 4Klicken Sie auf „Webhook testen“ und prüfen Sie, ob die Testnachricht im Kanal ankommt
Ab dann postet nanokoi.io in den Kanal, sobald eine Prüfung fehlschlägt. Alarme können vom Uptime-Monitoring, von der SSL-Zertifikatsüberwachung oder vom DNS-Monitoring kommen, und Sie können E-Mail- und generische Webhook-Alarme parallel zu Slack nutzen.
Grenzen von Slack Incoming Webhooks
Incoming Webhooks sind bewusst einfach gehalten. Behalten Sie diese Grenzen bei der Planung Ihrer Alarme im Blick:
- Jeder Webhook postet in genau einen Kanal. Legen Sie pro Kanal einen Webhook an, wenn Alarme in mehrere Kanäle gehen sollen
- Kanal, Benutzername und Icon lassen sich nicht über die Payload überschreiben – sie ergeben sich aus der App und dem gewählten Kanal
- Über einen Webhook gesendete Nachrichten können später nicht bearbeitet oder gelöscht werden
- Slack begrenzt Incoming Webhooks auf etwa eine Nachricht pro Sekunde, kurze Spitzen sind erlaubt
- Die älteren „Incoming WebHooks“-Custom-Integrations sind eine Legacy-Funktion – nutzen Sie für neue Setups eine Slack-App
Häufige Fehler bei Slack-Webhooks
Kommt eine Nachricht nicht an, verrät die Antwort von Slack den Grund. Die häufigsten Fehler sind:
invalid_payload
Der JSON-Body ist fehlerhaft. Prüfen Sie Anführungszeichen, Escaping und den Header Content-type: application/json.
no_text
In der Payload fehlt das erforderliche Feld text.
no_service
Der Webhook wurde deaktiviert oder entfernt, oder die URL ist falsch. Erstellen Sie einen neuen Webhook und aktualisieren Sie die URL in Ihrem Monitoring-Dienst.
channel_is_archived
Der Kanal wurde archiviert. Stellen Sie ihn wieder her oder legen Sie einen neuen Webhook für einen anderen Kanal an.
action_prohibited
Ein Workspace-Admin hat das Posten über diese App oder in diesen Kanal eingeschränkt.
Best Practices für Monitoring-Alarme in Slack
Mit ein paar Gewohnheiten bleiben Slack-Alarme nützlich statt nervig:
- Halten Sie die Webhook-URL geheim: Sie enthält einen Token, committen Sie sie daher nie in ein öffentliches Repository. Slack spürt geleakte Webhook-URLs aktiv auf und widerruft sie
- Nutzen Sie einen eigenen Alarm-Kanal, damit Vorfälle nicht im Tagesgeschäft untergehen
- Leiten Sie kritische Alarme und Routinemeldungen in verschiedene Kanäle – mit einem Webhook pro Kanal
- Testen Sie den Webhook nach jeder Änderung an Ihrer Slack-App, am Kanal oder an den Workspace-Berechtigungen
- Lassen Sie E-Mail-Alarme als Rückfallebene für einen Slack-Ausfall aktiviert
- Entfernen Sie nicht mehr genutzte Webhooks aus Ihrer Slack-App
Häufige Fragen zu Slack-Webhooks
Sind Slack Incoming Webhooks kostenlos?
Ja. Sie können eine Slack-App und Incoming Webhooks in jedem Slack-Tarif erstellen, auch im kostenlosen.
Kann ein Slack-Webhook in mehrere Kanäle posten?
Nein. Jeder Incoming Webhook ist an den Kanal gebunden, den Sie beim Hinzufügen gewählt haben. Für mehrere Kanäle fügen Sie Ihrer Slack-App pro Kanal einen Webhook hinzu.
Was tun, wenn meine Webhook-URL öffentlich geworden ist?
Entfernen Sie den Webhook auf der Seite „Incoming Webhooks“ Ihrer App, legen Sie einen neuen an und aktualisieren Sie die URL überall, wo sie verwendet wird. Slack widerruft außerdem Webhook-URLs, die öffentlich auffindbar sind.
Muss ich programmieren, um nanokoi.io-Alarme an Slack zu senden?
Nein. Fügen Sie die Webhook-URL in Ihre nanokoi.io-Benachrichtigungseinstellungen ein und klicken Sie auf „Webhook testen“ – nanokoi.io formatiert und versendet die Alarmmeldungen für Sie.
Website-Alarme direkt in Slack
Überwachen Sie bis zu 5 URLs kostenlos und erhalten Sie Alarme per Slack, E-Mail oder Webhook, wenn eine Prüfung fehlschlägt. Sie brauchen kürzere Intervalle oder mehr URLs? Vergleichen Sie die Tarife.
Kostenlos mit dem Monitoring startenKeine Kreditkarte erforderlich