Webhooks
Webhooks ermöglichen es, externe Systeme in Echtzeit über bestimmte Ereignisse in nexcore zu informieren.
Immer wenn ein definiertes Ereignis (z. B. das Erstellen, Ändern oder Abschließen eines Auftrags) auftritt, sendet nexcore automatisch eine Nachricht (HTTP-Request) an die hinterlegte Zieladresse (Endpoint).
Aufbau
Die Übersicht zeigt alle eingerichteten Webhooks. Für jeden Eintrag werden die wichtigsten Informationen angezeigt:
Webhooks (linke Seite)
Zeigt alle eingerichteten Webhooks in tabellarischer Form. Hier siehst Du auf einen Blick den Status, die Webhook-ID und den Zeitpunkt des letzten ausgelösten Ereignisses. Über das Plus-Symbol kannst Du einen neuen Webhook hinzufügen.
Details (rechte Seite)
Nach Auswahl eines Eintrags werden die Details des jeweiligen Webhooks angezeigt – darunter die Ziel-URL, die ausgewählten Ereignistypen, optionale Header und ggf. ein Sicherheits-Secret.
Detailansicht eines Webhooks
In der Detailansicht findest Du folgende Informationen:
ID
Eindeutige Kennung des Webhooks.
Externe ID
Optionales Feld zur Referenzierung in externen Systemen.
Status
Gibt an, ob der Webhook aktiv ist.
Endpunkt
URL des Zielsystems, an das die Ereignisse gesendet werden.
Ereignistypen
Auflistung aller Ereignisse, bei denen der Webhook ausgelöst wird (z. B. rental.resourceAssignment.in.completed).
Letztes Ereignis
Zeitpunkt der letzten erfolgreichen Benachrichtigung.
Custom Headers
Optional: zusätzliche HTTP-Header, die bei jeder Übertragung mitgesendet werden.
Secret
Optionaler Sicherheitsschlüssel, um Nachrichten zu signieren und deren Herkunft zu prüfen.
Aktionen zu Webhooks
Über das Menü ⋮ in der Detailansicht können folgende Aktionen ausgeführt werden:
Bearbeiten
Anpassung von Externer ID, Status, Endpunkt, Auswahl der Ereignistypen sowie Eintragung von Custom Headers.
Löschen
Entfernt den Webhook dauerhaft.
Secret setzen
Erstellt den geheimen Schlüssel zur Signaturprüfung.
Secert löschen
Entfernt den geheimen Schlüssel zur Signaturprüfung.
Testevent senden
Sendet ein Beispielereignis an den definierten Endpunkt, um die Integration zu testen.
Webhooks eignen sich ideal, um externe Systeme wie ERP-, BI- oder Serviceplattformen automatisch zu synchronisieren – ohne dass diese selbst API-Abfragen durchführen müssen.
Zuletzt aktualisiert