> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/bedienung-der-plattform/alarme-beta/webhooks-beta.md).

# Webhooks (BETA)

{% hint style="warning" %}
**Bitte beachte**: Diese Ansicht befindet sich im **Beta-Status**. Benutzeroberfläche und Funktionalitäten können sich jederzeit ändern.

<i class="fa-eye">:eye:</i> Diese Ansicht ist nur sichtbar, wenn du die Option **Beta-Funktionalitäten aktivieren** unter Einstellungen → [Benutzerkonto](/docs/manual/administration/einstellungen/benutzerkonto.md#erweiterte-einstellungen) aktiviert hast.
{% endhint %}

***

Webhooks bieten dir die Möglichkeit, Alarme mit Drittanbieter-Anwendungen zu verknüpfen, um bspw. Benachrichtigungen auch außerhalb der Enginsight Plattform erhalten zu können.

***

<i class="fa-compass">:compass:</i> Navigiere zu **Alarme** → **Webhooks**, um eine Auflistung aller angelegten Webhooks anzuzeigen. Wenn du noch keinen Webhook erstellt hast, ist diese Ansicht leer.

<figure><img src="/files/Ar0ex1bg9jvPIITJagsR" alt=""><figcaption></figcaption></figure>

Du kannst der [Webhook-Übersicht](#webhook-ubersicht) unter anderem entnehmen:

* welche HTTP-Methode von einem Webhook verwendet wird.
* welche Ziel-URL für den Webhook hinterlegt wurde.

Des Weiteren hast du hier die Möglichkeit, Webhooks zu löschen sowie neue [Webhooks zu erstellen](#webhook-hinzufugen).

***

## Navigation&#x20;

<i class="fa-magnifying-glass">:magnifying-glass:</i> Klicke in das Feld **Freitextsuche** oberhalb der Liste und gib einen frei gewählten Suchbegriff ein, um bestimmte Listenelemente zu finden.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das **Aktualisieren**-Symbol <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i> oberhalb der Liste, um alle Listenelemente zu aktualisieren.

<i class="fa-computer-mouse-scrollwheel">:computer-mouse-scrollwheel:</i> Scrolle in der Liste nach unten oder passe die Ergebnisanzeige pro Seite an: ![](/files/2OyJnQuiS9EayPZHDbB3) um weitere Einträge in der Liste zu sehen.\
Nutze die Seitennavigation: ![](/files/IWrRD7h50XDr2neLTKmC) um zwischen mehreren Seiten zu wechseln.

### Listenelemente sortieren

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke im Tabellenkopf auf das **Sortieren**-Symbol <i class="fa-sort">:sort:</i> neben einem Spaltennamen, um nach der jeweiligen Spalte in aufsteigender Reihenfolge <i class="fa-angle-up">:angle-up:</i> oder in absteigender Reihenfolge <i class="fa-chevron-down">:chevron-down:</i> zu sortieren.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das **Sortieren**-Symbol <i class="fa-bars-sort">:bars-sort:</i> oberhalb der Liste, um die Priorität der vorgenommenen Sortierung anzupassen. Es öffnet sich ein Menü, in dem alle Spalten angezeigt werden, nach denen die Liste sortiert ist. Verschiebe die angezeigten Elemente per Drag-and-Drop, um die Sortierpriorität zu ändern.

### Weitere Aktionen für Listenelemente

<i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben einem Listenelement, um das entsprechende Element auszuwählen. Oder setze einen Haken in die Checkbox im Tabellenkopf, um alle Listenelemente gemeinsam auszuwählen.&#x20;

Neben dem Suchfeld erscheint nun die Anzahl der ausgewählten Listenelemente. Zudem werden mögliche Aktionen angezeigt.

Folgende Aktion steht zur Verfügung:

<table><thead><tr><th width="200.04296875">Aktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Löschen</td><td><p>Lösche alle ausgewählten Webhooks. Bestätige dazu die Meldung, die erscheint, mit <strong>Löschen</strong>.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Bitte beachte</strong>: Gelöschte Einstellungen sind unwiederbringlich verloren!</p></div></td></tr></tbody></table>

***

## Webhook: Übersicht

<figure><img src="/files/IdG7xPxWYHnLP0Ou2bqX" alt=""><figcaption></figcaption></figure>

Die Webhook-Übersicht ist als tabellarische Liste aufgebaut. Du kannst der Liste folgende Informationen entnehmen:

<table><thead><tr><th width="199.98046875">Spalte</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Name</td><td><p>Zeigt den benutzerdefinierten Namen des Webhooks. Zudem werden Erstelldatum und -uhrzeit sowie letztes Bearbeitungsdatum und -uhrzeit angezeigt.</p><p><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf den Namen eines Webhooks, um zur entsprechenden <a href="#webhook-bearbeitungsansicht">Bearbeitungsansicht</a> zu navigieren. Hier kannst du vorgenommene Einstellungen anpassen und den Webhook löschen.</p></td></tr><tr><td>Methode </td><td><p>Zeigt die für den Webhook gewählte HTTP-Methode.</p><p></p><p>Folgende Methoden können angezeigt werden:</p><ul><li><strong>GET</strong>: Der Webhook ruft Daten vom Zielsystem ab.</li><li><strong>POST</strong>: Der Webhook erstellt neue Daten im Zielsystem oder übermittelt Daten an das Zielsystem.</li><li><strong>PATCH</strong>: Der Webhook aktualisiert bestehende Daten im Zielsystem teilweise.</li><li><strong>PUT</strong>: Der Webhook aktualisiert bestehende Daten im Zielsystem vollständig.</li><li><strong>DELETE</strong>: Der Webhook löscht bestehende Daten im Zielsystem.</li></ul></td></tr><tr><td>Ziel</td><td>Zeigt die Ziel-URL, an die die Webhook-Anfrage gesendet wird.</td></tr><tr><td>Content-Typ</td><td>Zeigt das Format des Inhalts der Webhook-Anfrage.</td></tr></tbody></table>

***

## Webhook hinzufügen

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> W**ebhook erstellen** in der rechten oberen Ecke, um einen [neuen Webhook hinzuzufügen](/docs/manual/bedienung-der-plattform/alarme-beta/webhooks-beta/webhook-hinzufugen-beta.md).

***

## Webhook: Bearbeitungsansicht

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf den Namen eines Webhooks, um zur entsprechenden Bearbeitungsansicht zu navigieren. Hier kannst du [vorgenommene Einstellungen](/docs/manual/bedienung-der-plattform/alarme-beta/webhooks-beta/webhook-hinzufugen-beta.md#grundeinstellungen) anpassen und den Webhook löschen.

Folgende Aktionen stehen zur Verfügung:

<table><thead><tr><th width="200.39453125">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Änderungen speichern</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <strong>Änderungen speichern</strong>, nachdem du Einstellungen geändert hast.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Bitte beachte</strong>: Nicht gespeicherte Änderungen sind unwiederbringlich verloren!</p></div></td></tr><tr><td>Zurück</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <strong>Zurück</strong>, um die Bearbeitungsansicht zu verlassen.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Bitte beachte</strong>: Nicht gespeicherte Änderungen sind unwiederbringlich verloren!</p></div></td></tr><tr><td>Löschen</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <strong>Löschen</strong> und bestätige die Meldung, die erscheint, mit <strong>Löschen</strong>, um alle vorgenommenen Einstellungen zu löschen.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Bitte beachte</strong>: Gelöschte Einstellungen sind unwiederbringlich verloren!</p></div></td></tr></tbody></table>

### Aufrufe der Webhook-URL

Sobald eine Webhook-URL aufgerufen wurde, findest du auf der rechten Seite der Bearbeitungsansicht eine Liste aller Aufrufe.

<div align="left"><figure><img src="/files/ghWSkxG38dp00eNr0nlv" alt=""><figcaption></figcaption></figure></div>

Du kannst der Liste folgende Informationen entnehmen:

<table><thead><tr><th width="199.98046875">Spalte</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Status</td><td>Zeigt den HTTP-Status, der als Antwort auf die gesendete HTTP-Anfrage zurückgegeben wurde.</td></tr><tr><td>Methode </td><td>Zeigt die für den Webhook gewählte HTTP-Methode.</td></tr><tr><td>Ziel</td><td>Zeigt die Ziel-URL, an die die Webhook-Anfrage gesendet wurde.</td></tr><tr><td>Referenz</td><td>Zeigt den Host, durch den die Webhook-URL aufgerufen wurde.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf den Namen eines Hosts, um zur jeweiligen <a href="/pages/2A0M45TxgQaeD6tpDIkK">Host-Detailansicht</a> zu navigieren.</td></tr><tr><td>Erstellt am</td><td>Zeigt das Datum und die Uhrzeit, wann die Webhook-URL aufgerufen wurde.</td></tr></tbody></table>

***