> 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/webhook-hinzufugen-beta.md).

# Webhook hinzufügen (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 %}

***

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Webhook erstellen** in der rechten oberen Ecke der [Webhook-Übersicht](/docs/manual/bedienung-der-plattform/alarme-beta/webhooks-beta.md#webhook-ubersicht), um einen neuen Webhook zu erstellen. Es öffnet sich die Ansicht **Alarme** → **Webhook** → **Hinzufügen**.

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

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Webhook erstellen**, nachdem du alle Einstellungen vorgenommen hast, um den neuen Webhook zu speichern und erstellen.&#x20;

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Zurück**, um zurück zur Listenübersicht zu gelangen.

{% hint style="danger" %}
**Bitte beachte**: Verlässt du diese Ansicht, ohne auf **Webhook erstellen** zu klicken, sind alle vorgenommenen Einstellungen unwiederbringlich verloren!
{% endhint %}

***

## Grundeinstellungen

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

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.71484375">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Name</td><td>Gib dem Webhook einen aussagekräftigen Namen.</td></tr><tr><td>Beschreibung</td><td><p>Beschreibe den Webhook genauer. </p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Dieses Feld ist optional.</p></div></td></tr><tr><td>Ziel-URL</td><td><p>Gib die Ziel-URL ein, an die die Webhook-Anfrage gesendet werden soll.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Bitte beachte</strong>: Welche URL hier erforderlich ist, hängt von der Drittanbieter-Anwendung ab, die du mit dem Alarm verknüpfen möchtest.</p></div></td></tr><tr><td>HTTP-Methode</td><td><p>Lege fest, mit welcher HTTP-Methode die Anfrage an die Ziel-URL gesendet werden soll.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>HTTP-Methode</strong>, um eine Liste aller verfügbaren Optionen auszuklappen.<br></p><p>Folgende Optionen stehen zur Verfügung:</p><ul><li><strong>POST</strong>: Diese Methode erstellt neue Daten im Zielsystem oder übermittelt Daten an das Zielsystem.</li><li><strong>GET</strong>: Diese Methode ruft Daten vom Zielsystem ab.</li><li><strong>PATCH</strong>: Diese Methode aktualisiert bestehende Daten im Zielsystem teilweise.</li><li><strong>PUT</strong>: Diese Methode aktualisiert bestehende Daten im Zielsystem vollständig.</li><li><strong>DELETE</strong>: Diese Methode löscht bestehende Daten im Zielsystem.</li></ul></td></tr><tr><td>Content-Typ</td><td><p>Lege fest, in welchem Format der Inhalt der HTTP-Anfrage (der Payload) übermittelt werden soll.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Der standardmäßig ausgewählte Content-Typ ist <strong>application/json</strong>. Aktuell steht kein weiterer Content-Typ zur Auswahl zur Verfügung.</p></div></td></tr></tbody></table>

***

## Payload

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

Gib bei Bedarf einen benutzerdefinierten Payload im für den ausgewählten Content-Typ erforderlichen JSON-Format ein.

{% hint style="success" icon="lightbulb" %}
Mehr Informationen, wie du benutzerdefinierte Webhook-Payloads mit dynamischen Platzhaltern erstellst, findest du in unserer Knowledge Base: [Wie erstelle ich für Enginsight Alarme eigene Webhook-Payloads mit dynamischen Platzhaltern?](https://docs.enginsight.com/docs/knowledge-base/alarme/wie-erstelle-ich-fur-enginsight-alarme-eigene-webhook-payloads-mit-dynamischen-platzhaltern)
{% endhint %}

Lasse das Feld leer, wenn du das Standard-Template für Webhook-Payloads verwenden möchtest.

{% hint style="success" icon="lightbulb" %}
Mehr Informationen, welche Standard-Templates es für Webhook-Payloads gibt, findest du in unserer Knowledge Base: [Welche Standard-Templates für Webhook-Payloads gibt es bei Enginsight Alarmen?](https://docs.enginsight.com/docs/knowledge-base/alarme/welche-standard-templates-fur-webhook-payloads-gibt-es-bei-enginsight-alarmen)
{% endhint %}

***

## HTTP-Header

Hier kannst du HTTP-Header definieren, die du als Zusatzinformation an die Ziel-URL übergeben möchtest.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Weitere hinzufügen**, um Eingabefelder für HTTP-Header anzuzeigen.

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

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.71484375">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Schlüssel</td><td>Gib die Bezeichnung des HTTP-Headers ein.</td></tr><tr><td>Wert</td><td>Gib den zugehörigen Wert des HTTP-Headers ein.</td></tr></tbody></table>

{% hint style="warning" %}
**Bitte beachte**: Welche Werte hier erforderlich sind, hängt von der Drittanbieter-Anwendung ab, die du mit dem Alarm verknüpfen möchtest.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das **Löschen**-Symbol <i class="fa-trash">:trash:</i> neben einem hinzugefügten HTTP-Header, um ihn wieder zu entfernen.

***

## Aufrufe der Webhook-URL

{% hint style="warning" %}
**Bitte beachte**: Hier werden nur Informationen angezeigt, wenn du dich in der [Bearbeitungsansicht](/docs/manual/bedienung-der-plattform/alarme-beta/webhooks-beta.md#webhook-bearbeitungsansicht) eines bereits erstellten Webhooks befindest. Wenn du einen Webhook neu erstellst, ist diese Ansicht leer.
{% endhint %}

***

## Weitere Ressourcen

**Knowledge Base**

* [Welche Standard-Templates für Webhook-Payloads gibt es bei Enginsight Alarmen?](https://docs.enginsight.com/docs/knowledge-base/alarme/welche-standard-templates-fur-webhook-payloads-gibt-es-bei-enginsight-alarmen)
* [Wie erstelle ich für Enginsight Alarme eigene Webhook-Payloads mit dynamischen Platzhaltern?](https://docs.enginsight.com/docs/knowledge-base/alarme/wie-erstelle-ich-fur-enginsight-alarme-eigene-webhook-payloads-mit-dynamischen-platzhaltern)

***