Die DoorLine Cam / Snap kann bei bestimmten Ereignissen selbstständig eine HTTP-Adresse aufrufen (Webhook). Damit lassen sich Drittsysteme direkt ansteuern, ohne Cloud und ohne zusätzliche Zentrale — zum Beispiel ein Shelly-Schaltaktor, eine Loxone-Steuerung oder ein Home-Assistant-Webhook.
Es lassen sich bis zu vier Aktionen einrichten. Jede Aktion besteht aus einem Auslöser und einer HTTP-Adresse.
Einrichtung
-
In der Weboberfläche „Einstellungen → Benachrichtigung → API-Aktionen" öffnen.
-
Für die gewünschte Aktion einen Auslöser wählen und die aufzurufende HTTP-Adresse eintragen.
-
Speichern.
Auslöser Liste
|
Auslöser |
Das Ereignis tritt ein … |
|
Türöffner für Klingeltaste 1 (intern) |
beim Türöffner-Kommando aus einem Ruf der internen Klingeltaste |
|
Türöffner für Klingeltaste 2 (extern) |
beim Türöffner-Kommando aus einem Ruf der externen Klingeltaste |
|
Türöffner für beide Klingeltasten |
beim Türöffner-Kommando aus einem beliebigen Ruf |
|
Bei Betätigung der Klingeltaste 1 (intern) |
bei Betätigung der integrierten Klingeltaste (Snap) |
|
Bei Betätigung der Klingeltaste 2 (extern) |
bei Betätigung der externen Klingeltaste am Schalteingang |
|
Bei Betätigung einer Klingeltaste |
bei Betätigung einer beliebigen Klingeltaste |
|
Schalteingang geschlossen |
wenn der potenzialfreie Eingang geschlossen wird |
|
Schalteingang geöffnet |
wenn der potenzialfreie Eingang geöffnet wird |
|
Aus / keine Funktion |
nie (Aktion deaktiviert) |
Für die Schalteingang-Auslöser muss der Schalteingang in den Einstellungen aktiviert sein (siehe Kapitel „4. Konfiguration → Eingänge").
Beispiel: Shelly Schaltaktor
Ein Shelly-WLAN-Schaltaktor (zum Beispiel Shelly Plus 1) kann bei einem Ereignis der DoorLine geschaltet werden — etwa um einen zusätzlichen Gong oder ein Außenlicht auszulösen.
-
Dem Shelly im Router eine feste IP-Adresse zuweisen. Wechselt die IP-Adresse, funktioniert der hinterlegte Aufruf nicht mehr.
-
In der DoorLine eine API-Aktion konfigurieren:
-
Auslöser: „Bei Betätigung einer Klingeltaste"
-
URL:
http://<ip-des-shelly>/relay/0?turn=on&timer=20(schaltet den Ausgang für 20 Sekunden ein)
-
-
Speichern und durch Betätigung der Klingeltaste prüfen.
Das genaue URL-Format hängt von Generation und Modell des Shelly ab und steht in der Dokumentation des Shelly-Herstellers.
Beispiel: Home-Assistant-Webhook
Ein Home-Assistant-Webhook startet eine beliebige Automation in Home Assistant.
-
In Home Assistant eine Automation mit dem Auslöser-Typ „Webhook" anlegen. Home Assistant erzeugt dabei eine Webhook-Kennung.
-
In der DoorLine eine API-Aktion konfigurieren:
-
Auslöser: gewünschtes Ereignis
-
URL:
http://<ip-des-home-assistant>:8123/api/webhook/<webhook-kennung>
-
-
Speichern.
Für die vollständige Einbindung in Home Assistant gibt es außerdem eine eigene Integration (siehe Abschnitt „Home Assistant").
Hinweis Ruhezeit:
Während einer aktiven Ruhezeit werden keine API-Aktionen ausgelöst.