# 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:

<table><thead><tr><th width="219.953125">Bereich</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>Webhooks (linke Seite)</strong></td><td>Zeigt alle eingerichteten Webhooks in tabellarischer Form. Hier siehst Du auf einen Blick den <em>Status</em>, die <em>Webhook-ID</em> und den <em>Zeitpunkt des letzten ausgelösten Ereignisses</em>. Über das Plus-Symbol kannst Du einen neuen Webhook hinzufügen.</td></tr><tr><td><strong>Details (rechte Seite)</strong></td><td>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.</td></tr></tbody></table>

***

## Detailansicht eines Webhooks

In der Detailansicht findest Du folgende Informationen:

<table><thead><tr><th width="220.1875">Feld</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>ID</strong></td><td>Eindeutige Kennung des Webhooks.</td></tr><tr><td><strong>Externe ID</strong></td><td>Optionales Feld zur Referenzierung in externen Systemen.</td></tr><tr><td><strong>Status</strong></td><td>Gibt an, ob der Webhook aktiv ist.</td></tr><tr><td><strong>Endpunkt</strong></td><td>URL des Zielsystems, an das die Ereignisse gesendet werden.</td></tr><tr><td><strong>Ereignistypen</strong></td><td>Auflistung aller Ereignisse, bei denen der Webhook ausgelöst wird (z. B. rental.resourceAssignment.in.completed).</td></tr><tr><td><strong>Letztes Ereignis</strong></td><td>Zeitpunkt der letzten erfolgreichen Benachrichtigung.</td></tr><tr><td><strong>Custom Headers</strong></td><td>Optional: zusätzliche HTTP-Header, die bei jeder Übertragung mitgesendet werden.</td></tr><tr><td><strong>Secret</strong></td><td>Optionaler Sicherheitsschlüssel, um Nachrichten zu signieren und deren Herkunft zu prüfen.</td></tr></tbody></table>

***

## Aktionen zu Webhooks

Über das Menü ⋮ in der Detailansicht können folgende Aktionen ausgeführt werden:

<table><thead><tr><th width="220.8984375">Aktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>Bearbeiten</strong></td><td>Anpassung von Externer ID, Status, Endpunkt, Auswahl der Ereignistypen sowie Eintragung von Custom Headers.</td></tr><tr><td><strong>Löschen</strong></td><td>Entfernt den Webhook dauerhaft.</td></tr><tr><td><strong>Secret setzen</strong></td><td>Erstellt den geheimen Schlüssel zur Signaturprüfung.</td></tr><tr><td><strong>Secert löschen</strong></td><td>Entfernt den geheimen Schlüssel zur Signaturprüfung.</td></tr><tr><td><strong>Testevent senden</strong></td><td>Sendet ein Beispielereignis an den definierten Endpunkt, um die Integration zu testen.</td></tr></tbody></table>

{% hint style="success" %}
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.
{% endhint %}