> 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/webhooks.md).

# Webhooks

{% hint style="warning" %}
**Bitte beachte**: Für diese Ansicht ist eine neue Version im Beta-Status verfügbar. Du findest sie unter [Alarme (BETA)](/docs/manual/bedienung-der-plattform/alarme-beta.md) → [Webhooks (BETA)](/docs/manual/bedienung-der-plattform/alarme-beta/webhooks-beta.md).

Um die neue Ansicht nutzen zu können, musst du die Option **Beta-Funktionalitäten aktivieren** unter Einstellungen → [Benutzerkonto](/docs/manual/administration/einstellungen/benutzerkonto.md#erweiterte-einstellungen) aktivieren.
{% endhint %}

***

Webhooks bieten dir die Möglichkeit, Alarme mit Drittanbieter-Software 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 keine Webhook erstellt hast, ist diese Ansicht leer.

<figure><img src="/files/VTWDBtRZNl7iQ0FBghIS" 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).

***

## Weitere Aktionen für Listenelemente

Du findest weitere Aktionen für Listenelemente am Ende der Zeile jedes Listenelements:

<table><thead><tr><th width="200.30859375">Aktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Bearbeiten</td><td><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Bearbeiten</strong>-Symbol <i class="fa-pencil">:pencil:</i> um die <a href="#webhook-bearbeitungsansicht">Bearbeitungsansicht</a> des entsprechenden Webhooks zu öffnen.</td></tr><tr><td>Löschen</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Löschen</strong>-Symbol <i class="fa-trash">:trash:</i> und bestätige die Meldung, die erscheint, mit der Eingabe von <strong>DELETE</strong>, um den Webhook 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 Webhooks sind unwiederbringlich verloren!</p></div></td></tr></tbody></table>

***

## Webhook: Übersicht

<figure><img src="/files/OAYd07c8ocmBjQsB3H4u" 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 Bearbeitungsansicht zu navigieren. Hier kannst du <a href="/pages/43VrhDhzxu4BUYAdwDsd#grundeinstellungen">vorgenommene Einstellungen</a> 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>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/webhooks/webhook-hinzufugen.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/webhooks/webhook-hinzufugen.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>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>
