Webhooks einrichten und testen
Übersicht
Über Webhooks meldet WORKSPACE.PM Ereignisse an Ihre eigenen Endpunkte. Sie wählen aus, welche Ereignisse gesendet werden, und können die Auswahl über Bedingungen einschränken. Ein Zustellprotokoll zeigt, was tatsächlich rausgegangen ist.
Voraussetzungen
- Administrationsrechte für den Mandanten
- Eine erreichbare Zieladresse
Schritt-für-Schritt-Anleitung
-
Webhook anlegen
- Administration, Integrationen, Webhooks
- "Neuer Webhook" wählen
- Zieladresse eintragen
- Ereignisse auswählen und bei Bedarf Bedingungen setzen
- Speichern
-
Testen
- Den Webhook öffnen und "Test senden" wählen
- Das Zustellprotokoll darunter zeigt Ergebnis und Antwort des Ziels
-
Betrieb überwachen
- Bei ausbleibenden Nachrichten zuerst das Zustellprotokoll prüfen
- Es unterscheidet zwischen nicht ausgelöst und nicht zugestellt
Häufige Fehler und Tipps
- Fehler: Es kommen zu viele Nachrichten an.
- Ereignisse entstehen bei jeder Änderung. Ohne Bedingungen meldet der Webhook auch Kleinigkeiten.
- Tipp: Zieladresse absichern.
- Behandeln Sie eingehende Aufrufe wie öffentliche Schnittstellen und prüfen Sie sie serverseitig.
- Tipp: Alternative Workflow.
- Wenn die Reaktion innerhalb von WORKSPACE.PM stattfinden soll, ist ein Workflow mit Ereignisauslöser der direktere Weg.