> 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/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-webhook.md).

# Geräte über Webhook verbinden

## Vorgehen

Bei einer Verbindung über Webhook fungiert BuildingPro Suites als Server. Ein Client, z. B. ein Gateway, an das Geräte angeschlossen sind, überträgt Informationen per HTTP an BuildingPro Suites.

Zu diesem Zweck wird in BuildingPro Suites ein Endpunkt erstellt. Der Client sendet Daten an diesen Endpunkt.

## Übersicht

<figure><img src="/files/8c09795bf1f6e1e1c4a342c68a0d56fa868aca93" alt=""><figcaption></figcaption></figure>

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

<table data-full-width="true"><thead><tr><th width="67.53331502278644">Symbol</th><th width="183.20001220703125">Beschreibung</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Menü „Verbindungen“</td><td>Klicken Sie, um das Menü „Verbindungen“ zu öffnen</td></tr><tr><td><strong>[B]</strong></td><td>Registerkarte</td><td>Zugriff auf die jeweiligen Schnittstellen</td></tr><tr><td><strong>[C]</strong></td><td>Arbeitsbereich</td><td>Zeigt eine Liste der vorhandenen Endpunkte (falls vorhanden)</td></tr><tr><td><strong>[D]</strong></td><td>Endpunkt</td><td>Vorhandene Endpunkte</td></tr><tr><td><strong>[E]</strong></td><td>Verbindung anhalten/fortsetzen</td><td>Klicken, um eine Verbindung anzuhalten oder fortzusetzen</td></tr><tr><td><strong>[F]</strong></td><td>Verbindungsstatus</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>Schutz</td><td>Zeigt den Schutzstatus des jeweiligen Endpunkts</td></tr><tr><td><strong>[J]</strong></td><td>Format</td><td>Zeigt das Format an, das auf die ausgewählten Daten angewendet 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 ↗Endpunktdetails</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 Tenants verwendet wird, wird sie dort ebenfalls gelöscht.</td></tr><tr><td><strong>[N]</strong></td><td>Endpunktdetails</td><td>Klicken Sie, um die Details des jeweiligen Endpunkts zu bearbeiten.</td></tr></tbody></table>

## Einen neuen Endpunkt erstellen/einen bestehenden Endpunkt anpassen

<figure><img src="/files/e6c4abec6517d7da617d798fede89ed269e82c70" alt=""><figcaption><p>Abb. 3 – Das Menü „Endpunkt konfigurieren“</p></figcaption></figure>

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 zu erstellen **⇄ ODER** Klicken Sie auf **\[N]** um einen bestehenden Endpunkt zu bearbeiten.

   ▷ Das Menü „Endpunkt konfigurieren“ öffnet sich.
4. In **\[O]**, geben Sie dem Endpunkt einen Namen. Der Endpunkt wird unter diesem Namen in **\[G]**.
5. In **\[P]**, geben Sie einen Pfad ein. Der Client sendet Informationen an diesen Pfad. ♢ Der Pfad besteht aus 2 Teilen: einer nicht bearbeitbaren Basis-URL und einem Teil, den Sie ändern können.
6. Optional: In **\[Q]**, geben Sie einen Autorisierungsschlüssel ein. Wenn Sie hier einen Wert eingeben, muss der entsprechende Wert vom Client in der Anfrage gesendet werden. Andernfalls wird die Anfrage nicht akzeptiert. Wenn Sie keinen Autorisierungsschlüssel vergeben möchten: Lassen Sie das Feld leer.
7. In **\[R]**, wählen Sie das Format aus, das auf die eingehenden Daten angewendet wird.
8. Optional: Klicken Sie auf **\[S]** bis [↗ ein neues Format erstellen](/collection/german/pflichtbasis/platform-core/connect-hub/data-processing-function-formats/configure-a-format.md#create-a-format)
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/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-webhook.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.