Webhooks konfigurieren
Echtzeit-Monitoring für Minecraft, CS2 & Rust
Warum Webhooks nutzen?
ServerPulse sendet automatisch HTTP-POST-Anfragen an deine eigene URL, sobald sich der Status deines Servers ändert. Verbinde das mit Discord, Slack, PagerDuty oder einem eigenen Service — und reagiere in Sekunden statt Minuten.
Offline-Erkennung
Erhalte eine sofortige Benachrichtigung, wenn dein Minecraft-Server auf offline wechselt. Ideal für Teams, die 24/7-Uptime garantieren müssen.
Spieler-Spitzen melden
Lass dich informieren, wenn dein CS2-Server auf 64/64 Spieler springt — oder wenn Rust-Server wie EmeraldRP ihre Kapazität überschreiten. Perfekt für Community-Manager.
Plugin-Updates tracken
ServerPulse erfasst Versionswechsel im MOTD. Ein Webhook feuert, sobald EssentialsX 2.20.1 gegen 2.21.0 getauscht wurde — du siehst jede Änderung live.
Einrichtung im Dashboard
In vier Schritten von der Registrierung bis zum ersten ausgelösten Event.
Schritt 1 — Webhook-URL angeben
Navigiere zu Dashboard → Einstellungen → Webhooks. Trage eine gültige HTTPS-URL ein, die POST-Anfragen empfangen kann. Beispiel:
https://hooks.example.com/servers/pulse-incoming
Die URL muss auf Port 443 lauschen und innerhalb von 5 Sekunden mit einem 2xx-Status antworten.
Schritt 2 — Event-Filter wählen
Aktiviere nur die Events, die du brauchst. Deaktiviere unnötige, um Rate-Limits zu vermeiden:
server.status_change # online ↔ offline
server.player_count # Spielerzahl überschreitet Schwellwert
server.version_update # MOTD oder Spielversion ändert sich
server.latency_spike # Ping > 200 ms für > 30 Sekunden
Schritt 3 — Authentifizierung setzen (optional)
Schütze deinen Endpoint mit einem Header-Token. ServerPulse fügt den Token als X-ServerPulse-Signature-Header hinzu:
# Im Dashboard unter "Authentifizierung" eingeben:
Token: sp_live_8f3a2c1d9e7b4f6a0c5d8e2f1a3b7c9d
Schritt 4 — Test-Webhook absenden
Klicke auf „Test senden". ServerPulse feuert ein Dummy-Event innerhalb von 2 Sekunden. Prüfe dein Log — du solltest eine Antwort mit 200 OK sehen.
Beispiel-Payload
So sieht eine typische Benachrichtigung aus, wenn dein Minecraft-Server CrystalDungeon-01 auf offline wechselt:
{
"event": "server.status_change",
"timestamp": "2025-01-14T18:32:07Z",
"server": {
"id": "srv_mc_4a8f2e1b",
"name": "CrystalDungeon-01",
"game": "minecraft",
"ip": "185.234.219.47",
"port": 25565,
"version": "1.20.4 Paper",
"previous_status": "online",
"current_status": "offline",
"players": {
"online": 0,
"max": 120,
"last_online": 47
}
},
"metadata": {
"downtime_since": "2025-01-14T18:31:59Z",
"last_uptime_hours": 183.4,
"region": "eu-central"
}
}
Für CS2-Server enthält das Payload zusätzlich "game": "cs2" und "port": 27015. Rust-Server liefern außerdem ein "wipe_date"-Feld im metadata-Objekt, z. B. "2025-01-18T00:00:00Z" für den nächsten Server-Wipe.