Webhooks

Webhooks im Menü des Tenants (Owner und Admins) schicken eine Nachricht, wenn mit den Servern des Tenants etwas passiert: in einen Discord-Kanal oder als JSON an Home Assistant, n8n oder deinen eigenen Code.

Webhook hinzufügen

1. Add webhook: ein Name, die URL und die Events.
2. Format:
   • Automatic: eine Discord-Nachricht für Webhook-URLs von Discord, sonst JSON.
   • Discord message
   • JSON for your own code (signed): Das Signatur-Secret wird einmal angezeigt, nach dem Erstellen oder wenn es ersetzt wird.
3. Test schickt einen ping und zeigt die Antwort.

Die Karte jedes Webhooks listet seine letzten Zustellungen mit der Antwort, z. B. HTTP 400 oder den Grund, warum keine Verbindung zustande kam. Webhooks lassen sich später bearbeiten; eine Discord-URL wird gekürzt angezeigt, weil ihr Ende jedem das Posten erlaubt.

Events

Event	Wann
Server starts, stops or crashes	Der Server ist seit 15 Sekunden running, offline oder installFailed, und das unterscheidet sich von der letzten Nachricht (ein Neustart oder eine Neuinstallation löst keine Flut aus).
An install finished (or failed)	nach einer Installation oder Neuinstallation
A server was created
A server was deleted

Zustellung

• Jede Antwort 2xx gilt als zugestellt; sonst versucht es das Panel erneut nach 1, 2, 4 … bis 60 Minuten, insgesamt 8 Versuche.
• Weiterleitungen werden nicht befolgt.
• Private Adressen (LAN, Loopback, Cloud-Metadaten) werden abgelehnt, ausser Webhooks to the local network ist in Admin → Settings eingeschaltet (im Homelab standardmässig an, beim Hosting aus).

Das JSON-Format und wie man Signaturen prüft: Webhook-Events.