SRS-Client Webhooks

Tipp

Der Webhook wird für die Gebäudesteuerung (z.B. Türsteuerung, Lichtsteuerung) benötigt, über einen Webhook kann ein Event in Ihrem Smart Home ausgelöst werden.

Webhook anlegen

Nachfolgend wird Ihnen erklärt, wie Sie einen Webhook für einen SRS-Client anlegen.

Schritt-für-Schritt Anleitung

1. Öffnen Sie die SRS-Verwaltung.
2. Klicken Sie auf Verwaltung.
3. Klicken Sie auf App-Zugänge.
4. Klicken Sie auf SRS-Clients.
5. Klicken Sie auf den gewünschten Client.
6. Klicken Sie auf Webhook.
7. Klicken Sie auf Webhook hinzufügen.
8. Geben Sie folgende Informationen an:
   • Bezeichnung: Vergeben Sie eine eindeutige Bezeichnung für den Webhook.
   • URL: Geben Sie die Ziel-URL des Webhooks ein.
   • HTTP-Methode: Wählen Sie die gewünschte HTTP-Methode aus.
     • POST
     • GET
   • Auslöser: Wählen Sie aus, wann der Webhook ausgelöst werden soll.
     • Einsatzbeginn
     • Einsatzende
     • Manuell
   • Query-Parameter: Geben Sie bei Bedarf Query-Parameter an.
   • Body: Geben Sie bei Bedarf den Inhalt des Request-Body im JSON-Format an.
   • Timeout in Sekunden: Legen Sie fest, nach wie vielen Sekunden der Webhook-Aufruf als fehlgeschlagen gilt.
   • Wiederholungen nach Auftreten eines Fehlers: Legen Sie fest, wie oft der Webhook im Fehlerfall erneut ausgeführt werden soll.
   • Verzögerung der Ausführung in Sekunden: Legen Sie eine optionale Verzögerung in Sekunden fest, bevor der Webhook ausgeführt wird.
9. Klicken Sie auf Speichern.
10. Der Webhook ist korrekt konfiguriert und einsatzbereit.

Beispiel Webhook Trigger

Hinweis

Wir verwenden für dieses Beispiel den bereits angelegten Webhook aus Webhook anlegen, zusätzlich haben wir einen identisch Webhook angelegt nur mit dem Auslöser Einsatzende. Dieser soll bei einem Einsatzbeginn und Einsatzende einen Query-Parameter an unser Tool senden, damit ein konfiguriertes Event z.B. Türöffnung, Lichteinschalten-/ausschalten ausgelöst wird.

Nachfolgend wird Ihnen erklärt, wie der Webhook als Auslöser für ein Event verwendet werden kann.

Vorschau eines Events vom Webhook

Webhook Einsatzende

Webhook Events