# Geräte über Webhook verbinden

## Vorgehen

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

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

## Übersicht

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fsj8HqMlpNxukz0OK1sWL%2FDocs_Verbindungen%20-%20Verbindungen%20Webhook.png?alt=media&#x26;token=e6892ce8-27e2-4b60-8c95-4d88adbfb4e2" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FqAwp9PTzGlgFah0atHXo%2FDocs_Verbindungen%20-%20Verbindungen%20Webhook%201.png?alt=media&#x26;token=0e91702c-22ff-4259-a181-056736d823f8" alt=""><figcaption></figcaption></figure></div>

<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 an (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 pausieren/wieder aufnehmen</td><td>Klicken, um eine Verbindung zu pausieren oder wieder aufzunehmen</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 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 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>

## Einen neuen Endpunkt erstellen/einen bestehenden Endpunkt anpassen

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FQ9GDixpkkIn0ApcBBPND%2FDocs_Verbindungen%20-%20Verbindungen%20Webhook%202.png?alt=media&#x26;token=e84fb143-3c27-47bc-82e8-c904d4bf2e7e" alt=""><figcaption><p>Abb. 3 – Das Menü „Endpunkt konfigurieren“</p></figcaption></figure></div>

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 bestehenden Endpunkt zu bearbeiten.

   ▷ Das Menü „Endpunkt konfigurieren“ wird geöffnet.
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 editierbaren 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]** zu [↗ ein neues Format erstellen](https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/data-processing-function-formats/configure-a-format#create-a-format)
9. Klicken Sie auf **\[T]** um die Einstellungen zu speichern.