Webhook-Kanal

Webhook-Benachrichtigungskanal

Mit dem Webhook-Kanal sendet LoadFocus einen HTTP POST mit JSON-Body an eine beliebige URL, sobald sich der Status einer überwachten Prüfung ändert. Es ist der flexibelste Kanal: alles, was eingehende JSON-Webhooks akzeptiert, etwa Zapier, n8n, Make oder Ihr eigener Dienst, kann LoadFocus-Benachrichtigungen empfangen. PagerDuty und Opsgenie haben eigene Kanäle (kostenpflichtige Tarife), die das jeweils erwartete Format senden.

Webhook-Kanal anlegen

Öffnen Sie die Alarmkanäle und klicken Sie auf + New Alert Channel.
Wählen Sie Webhook.
Vergeben Sie einen Namen (erscheint in der Kanalliste) und fügen Sie die HTTPS-URL ein, die den POST erhalten soll.
Klicken Sie auf Kanal speichern, aktivieren Sie den Kanal an einer Prüfung und wählen Sie über die Routing-Schalter, welche Ereignisse er erhalten soll.

Wann LoadFocus Ihren Webhook aufruft

LoadFocus sendet bei folgenden Ereignissen einen POST an Ihre URL:

Ereignis	`event`-Wert	Wann es ausgelöst wird
Check fehlgeschlagen	`check.failed`	Eine Prüfung wechselt in den Fehlerzustand (Assertion, Fehler oder Timeout).
Check erholt	`check.recovered`	Eine zuvor fehlgeschlagene Prüfung ist wieder erfolgreich.
Check degradiert	`check.degraded`	Die Antwortzeit überschreitet den Degraded-Schwellwert, ohne fehlzuschlagen.
SSL-Ablauf	`ssl.expiry`	14, 7 und 3 Tage vor Ablauf eines überwachten HTTPS-Zertifikats sowie am Ablauftag.
Domain-Ablauf	`domain.expiry`	Die Registrierung einer überwachten Domain läuft bald ab.
Test	`test`	Sie klicken die Schaltfläche Test neben dem Kanal.

Welche dieser Ereignisse einen Kanal erreichen, steuern die Schalter Fail / Recover / Degraded / SSL / Domain unter dem Kanal auf der Bearbeitungsseite der Prüfung. Standardmäßig sind alle aktiviert. Das Ereignis test wird immer gesendet, wenn Sie auf Test klicken.

Payload

Der POST-Body ist application/json und wird mit dem Header User-Agent: LoadFocus-Webhook/1.0 gesendet:

{
  "source": "loadfocus",
  "event": "check.failed",
  "check": {
    "id": "75be9e45e858177eea4a18bbdc765472",
    "name": "Designerbox",
    "url": "https://designerbox.ai"
  },
  "status": "failed",
  "location": "us-east-1",
  "timestamp": "2026-06-07T12:00:00.000Z"
}

Feldreferenz:

source: immer loadfocus. Damit erkennen Sie den Absender.
event: eines von check.failed, check.recovered, check.degraded, ssl.expiry, domain.expiry, test.
check.id / check.name / check.url: der Monitor, der die Benachrichtigung ausgelöst hat (null bei einem test-Ereignis).
status: der Prüfstatus zum Sendezeitpunkt (failed, passed, degraded oder null bei SSL-, Domain- und Test-Ereignissen).
location: die Region, aus der die Prüfung lief (null bei SSL-, Domain- und Test-Ereignissen).
timestamp: ISO-8601-UTC-Zeit des Ereignisses.

SSL-Ablauf-Ereignisse ergänzen ein details-Objekt, Domain-Ablauf-Ereignisse eines mit domain, daysRemaining, expiresAt und source, und ein test-Ereignis hat einen Text details.message. Das SSL-Beispiel:

{
  "source": "loadfocus",
  "event": "ssl.expiry",
  "check": { "id": "...", "name": "...", "url": "https://..." },
  "status": null,
  "location": null,
  "timestamp": "2026-06-07T12:00:00.000Z",
  "details": { "daysRemaining": 7, "validTo": "Jun 14 23:59:59 2026 GMT" }
}

Sicherheit und Voraussetzungen

Nur HTTPS. Webhook-URLs müssen mit https:// beginnen. Reine http-URLs werden abgelehnt.
Private Adressen werden blockiert. Zum Schutz vor Server-Side Request Forgery löst LoadFocus Ihren Hostnamen auf und ruft keine privaten, Loopback-, Link-local- oder CGNAT-Adressen auf (z. B. 10.0.0.0/8, 127.0.0.1, 169.254.0.0/16, 192.168.0.0/16). Ihr Endpunkt muss öffentlich erreichbar sein.
Keine Weiterleitungen. LoadFocus folgt bei Webhook-Aufrufen keinen HTTP-Redirects, geben Sie die finale URL an.
Timeout. Jeder Aufruf läuft nach 10 Sekunden ab. Es gibt keinen automatischen Retry, Ihr Empfänger sollte die Payload schnell annehmen und einreihen.
Funktion prüfen. Senden Sie mit Test ein test-Ereignis, bevor Sie sich auf den Kanal verlassen. Ein kostenloser Dienst wie webhook.site eignet sich, um die genaue Payload zu prüfen.

Integrationsbeispiele

Zapier / Make / n8n: Starten Sie einen Workflow über einen "Catch Hook"- oder Webhook-Trigger und verzweigen Sie auf dem event-Feld, um in den Chat zu posten, Tickets anzulegen oder eine Statusseite zu aktualisieren.
Eigener Dienst: Nehmen Sie den POST an, prüfen Sie source === "loadfocus" und reagieren Sie auf event.
PagerDuty und Opsgenie: Nutzen Sie deren eigene Alarmkanäle (kostenpflichtige Tarife), nicht den Webhook-Kanal.

Verwandt

Benachrichtigungskanäle: Überblick über alle Kanaltypen und das Ereignis-Routing pro Kanal.

Zurück

Speichern und Ausführen

Weiter

Letzte Fehler