> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german-14.2-freezed/connectivity-as-a-service/gerate-mit-abb-buildingpro-verbinden/gerate-per-webhook-verbinden.md).

# Geräte per Webhook verbinden

## Vorgehen

Bei einer Verbindung über Webhook fungiert Eliona als Server. Ein Client, z.B. ein Gateway an welches Geräte angeschlossen sind, übermittelt per HTTP Informationen an Eliona.

Dazu wird in Eliona ein Endpunkt erstellt. An diesen Endpunkt sendet der Client Daten.

## Überblick

<div data-full-width="true"><figure><img src="/files/cW1nD1BXkhZz5v2rv0Qd" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/aZOe57RwsUivyDdnSQmS" alt=""><figcaption></figcaption></figure></div>

<table><thead><tr><th width="100.33333333333331">Symbol</th><th width="212">Beschreibung</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Menü „Verbindungen“</td><td>Klicken, um das Menü „Verbindungen“ aufzurufen</td></tr><tr><td><strong>[B]</strong></td><td>Reiter</td><td>Zugriff auf die jeweiligen Schnittstellen</td></tr><tr><td><strong>[C]</strong></td><td>Arbeitsbereich</td><td>Zeigt eine Liste der bestehenden Endpunkte an (wenn vorhanden)</td></tr><tr><td><strong>[D]</strong></td><td>Endpunkt</td><td>Bestehende Endpunkte</td></tr><tr><td><strong>[E]</strong></td><td>Verbindung pausieren/wieder aufnehmen</td><td>Klicken, um eine Verbindung zu pausieren bzw. wieder zu starten</td></tr><tr><td><strong>[F]</strong></td><td>Status der Verbindung</td><td>Zeigt den aktuellen Status der Verbindung an</td></tr><tr><td><strong>[G]</strong></td><td>Name</td><td>Name des Endpunkts</td></tr><tr><td><strong>[H]</strong></td><td>Pfad</td><td>Der Pfad an den die Informationen gesendet werden</td></tr><tr><td><strong>[I]</strong></td><td>Protection</td><td>Zeigt den Schutzstatus des jeweiligen Endpunkts an</td></tr><tr><td><strong>[J]</strong></td><td>Format</td><td>Zeigt das Format an, das auf die ausgewählten Daten angewandt wird</td></tr><tr><td><strong>[K]</strong></td><td>Kopieren</td><td>Klicken, um den Endpunkt zu duplizieren</td></tr><tr><td><strong>[L]</strong></td><td>Neuen Endpunkt hinzufügen</td><td>Klicken, um einen neuen Endpunkt hinzuzufügen. Öffnet die ↗Endpunkt-Details</td></tr><tr><td><strong>[M]</strong></td><td>Endpunkt löschen</td><td>Löscht den jeweiligen Endpunkt. ⚠ Achtung: Wenn die Verbindung auch in anderen Projekten genutzt wird, wird sie dort ebenfalls gelöscht.</td></tr><tr><td><strong>[N]</strong></td><td>Endpunkt-Details</td><td>Klicken, um die Details des jeweiligen Endpunkts zu bearbeiten.</td></tr></tbody></table>

## Einen neuen Endpunkt anlegen/Einen bestehenden Endpunkt anpassen&#x20;

<div data-full-width="true"><figure><img src="/files/0DWYoAwNqB5MoIOBf4Ms" alt=""><figcaption><p>Abb. 3 – Das Menü "Endpunkt konfigurieren" </p></figcaption></figure></div>

1. Klicken Sie auf **Verbindungen \[A]** \
   ▷ Das Fenster Verbindungen öffnet sich
2. Klicken Sie auf **Webhook \[B]**
3. Klicken Sie auf **\[L]**, um einen neuen Endpunkt anzulegen \
   \&#xNAN;**⇄ ODER**\
   Klicken Sie auf **\[N]**, um einen bestehenden Endpunkt zu bearbeiten. \
   ▷ Das Menü „Endpunkt konfigurieren“ öffnet sich.
4. Geben Sie dem Endpunkt in **\[O]** einen Namen. Unter diesem Namen wird der Endpunkt in **\[G]** angezeigt.
5. Geben Sie in **\[P]** einen Pfad ein. An diesen Pfad wird der Client Informationen senden. \
   ♢ Der Pfad besteht aus 2 Teilen: einer nicht editierbaren Base-URL und einem Teil, den Sie ändern können.
6. Optional: Geben Sie in **\[Q]** einen Authorization Key an. Wenn Sie hier einen Wert eintragen, muss der entsprechende Wert vom Client in der Anfrage mitgesendet werden. Ansonsten wird die Anfrage nicht akzeptiert. \
   Wenn Sie keinen Authorization Key vergeben wollen: Lassen Sie das Feld leer.
7. Wählen Sie in **\[R]** das Format aus, das auf die eingehenden Daten angewandt wird.
8. Optional: Klicken Sie auf **\[S]**, um ein [↗ neues Format zu erstellen](/collection/german-14.2-freezed/connectivity-as-a-service/gerate-mit-abb-buildingpro-verbinden/ein-format-konfigurieren.md)
9. Klicken Sie auf **\[T]**, um die Einstellungen zu speichern.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/german-14.2-freezed/connectivity-as-a-service/gerate-mit-abb-buildingpro-verbinden/gerate-per-webhook-verbinden.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.