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

# Geräte über Webhook verbinden

## Vorgehensweise

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

Dazu wird in BuildingPro Suites ein Endpunkt erstellt. Der Client sendet Daten an diesen Endpunkt.

## Übersicht

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FowqiqQEDZV8e7ciFNniE%2FGroup%20570.png?alt=media&amp;token=b2fbffa4-5b65-44c7-a53f-7a0956919366" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2F6yni9bNmCSWidPs5nCX4%2FGroup%20571.png?alt=media&amp;token=233bc47e-9b15-4ab8-aa0b-fcec1d48c0ed" 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, 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 an</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 ↗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 Mandanten verwendet wird, wird sie dort ebenfalls gelöscht.</td></tr><tr><td><strong>[N]</strong></td><td>Endpunktdetails</td><td>Klicken, um die Details des jeweiligen Endpunkts zu bearbeiten.</td></tr></tbody></table>

## Neuen Endpunkt erstellen / vorhandenen Endpunkt anpassen

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fy1BH6KQW3teOe9Bq0lNJ%2FGroup%20572.png?alt=media&amp;token=d823d11b-fde6-4071-8f55-2f5d0abff3f6" alt=""><figcaption><p>Abb. 3 – Das Menü „Endpunkt konfigurieren“</p></figcaption></figure>

1. Klicken Sie auf **Verbindungen \[A]**\
   ▷ Das Fenster „Verbindungen“ wird geöffnet
2. Klicken Sie auf **Webhook \[B]**
3. Klicken Sie auf **\[L]** um einen neuen Endpunkt zu erstellen **⇄ ODER** Klicken Sie auf **\[N]** um einen vorhandenen Endpunkt zu bearbeiten.\
   ▷ Das Menü „Endpunkt konfigurieren“ wird geöffnet.
4. Geben Sie unter **\[O]**&#x65;inen Namen für den Endpunkt ein. Unter diesem Namen wird der Endpunkt in **\[G]**.
5. Geben Sie unter **\[P]**&#x65;inen Pfad ein. Der Client sendet Informationen an diesen Pfad. ♢ Der Pfad besteht aus zwei Teilen: einer nicht bearbeitbaren Basis-URL und einem Teil, den Sie ändern können.
6. Optional: Geben Sie unter **\[Q]**&#x65;inen Autorisierungsschlüssel ein. Wenn Sie hier einen Wert eingeben, muss der Client den entsprechenden Wert in der Anfrage mitsenden. Andernfalls wird die Anfrage nicht akzeptiert. Wenn Sie keinen Autorisierungsschlüssel vergeben möchten, lassen Sie das Feld leer.
7. Wählen Sie unter **\[R]**&#x64;as Format aus, das auf die eingehenden Daten angewendet wird.
8. Optional: Klicken Sie auf **\[S]** um [↗ ein neues Format zu erstellen](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-webhook.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
