Übersicht

Webhooks ermöglichen es, externe Systeme in Echtzeit über Ereignisse in Stampfactory zu informieren. Bei bestimmten Aktionen (z.B. Stempelung, Abwesenheitsantrag) wird automatisch eine HTTP-Anfrage an eine von Ihnen definierte URL gesendet.

Webhook erstellen

Navigieren Sie zu Einstellungen > Webhooks und klicken Sie auf Neuer Webhook.

Geben Sie die Ziel-URL ein, an die Ereignisse gesendet werden sollen.

Wählen Sie die Ereignisse, bei denen der Webhook ausgelöst werden soll.

Der Webhook wird sofort aktiviert.

Sicherheit

Alle Webhook-Anfragen werden mit HMAC-SHA256 signiert. Der Signaturwert wird im Header X-Stamp-Signature mitgesendet. Zusätzlich enthält jede Anfrage eine eindeutige Request-ID im Header X-Stamp-Request-Id.

Signatur verifizieren

# Beispiel: Signatur mit dem Webhook-Secret verifizieren
echo -n "$PAYLOAD" | openssl dgst -sha256 -hmac "$WEBHOOK_SECRET"

Wichtig

Verifizieren Sie immer die Signatur, um sicherzustellen, dass die Anfrage tatsächlich von Stampfactory stammt.

Zustellungsprotokoll

Jede Webhook-Zustellung wird protokolliert:

Feld	Beschreibung
Zeitpunkt	Wann die Zustellung ausgelöst wurde
Ereignis	Welches Ereignis den Webhook ausgelöst hat
Status	HTTP-Statuscode der Antwort
Antwortzeit	Dauer bis zur Antwort des Zielsystems

Wiederholung

Fehlgeschlagene Zustellungen (HTTP-Status >= 400 oder Timeout) werden automatisch wiederholt. Nach mehreren Fehlversuchen wird der Webhook deaktiviert und Sie erhalten eine Benachrichtigung.

Webhook deaktivieren / löschen

Webhooks können jederzeit deaktiviert oder gelöscht werden. Das Zustellungsprotokoll bleibt auch nach dem Löschen erhalten.

Webhooks