Webhooks
Senden Sie Ereignisse in Echtzeit an externe Systeme. Verbinden Sie Fesk mit Ihren eigenen Tools, Dashboards oder Automatisierungspipelines.
Einrichtung
Gehen Sie zu Einstellungen → Konnektoren und klicken Sie auf Webhook hinzufügen. Sie benötigen:
- Ziel-URL: der HTTPS-Endpunkt, der Ereignisse empfängt
- Ereignisse: welche Ereignisse abonniert werden sollen
- Secret (optional), ein HMAC-Schlüssel zur Signaturprüfung
Klicken Sie auf Test senden, bevor Sie Live-Ereignisse abonnieren. Fesk sendet eine Beispiel-Payload, mit der Sie die Verarbeitung durch Ihren Endpunkt prüfen können.
Verfügbare Ereignisse
| Ereignis | Wird ausgelöst, wenn |
|----------|---------------------|
| ticket.created | Ein neues Ticket erstellt wird |
| ticket.updated | Ticket-Felder sich ändern (Titel, Beschreibung, Priorität, Tags) |
| ticket.status_changed | Ein Ticket in einen anderen Status wechselt |
| ticket.assigned | Ein Ticket zugewiesen oder neu zugewiesen wird |
| comment.created | Ein neuer Kommentar zu einem Ticket hinzugefügt wird |
Wählen Sie ein oder mehrere Ereignisse pro Webhook. Sie können mehrere Webhooks mit unterschiedlichen URLs und Ereignis-Sets anlegen.
Payload
Jede Zustellung sendet einen JSON-Payload mit Ereignistyp, Zeitstempel und dem vollständigen Objekt (Ticket oder Kommentar) im aktuellen Zustand. Der Header X-Webhook-Event identifiziert den Ereignistyp.
Signaturprüfung
Jede Zustellung enthält einen X-Webhook-Signature-Header, den HMAC-SHA256-Hex-Digest des rohen Request-Bodys, signiert mit dem Secret Ihres Webhooks. (Wenn Sie beim Anlegen kein Secret angeben, erzeugt Fesk eines und zeigt es einmalig bei der Erstellung an.) Berechnen Sie auf Ihrer Seite HMAC-SHA256(secret, raw_body) und vergleichen Sie, um die Authentizität zu prüfen.
Wiederholungsverhalten
Fehlgeschlagene Zustellungen (kein 2xx-Status oder ein Timeout nach 10 Sekunden) werden mit exponentiellem Backoff wiederholt (bis zu 2 Wiederholungen, also insgesamt 3 Versuche pro Ereignis. Danach wird die Zustellung als fehlgeschlagen protokolliert; das Abonnement bleibt aktiv und empfängt weiterhin künftige Ereignisse) es gibt also kein automatisches Deaktivieren nach wiederholten Fehlern. Es gibt keine Replay-API: Wenn Ihr Endpunkt längere Zeit nicht erreichbar ist, gleichen Sie den Zustand nach der Wiederherstellung durch Abfragen der relevanten Endpunkte ab.