DoorLine Key

Push-Benachrichtigung (optional mit Bild) bei falscher Code-Eingabe

In diesem Artikel wird beschrieben, wie mit Home Assistant und der neuen DoorLine-Integration eine Push-Benachrichtigung auf das Smartphone gesendet werden kann, sobald an der DoorLine Key ein falscher Code eingegeben wird. So ist sofort zu sehen, wenn jemand versucht, mit einem unbekannten Code die Tür zu öffnen.

Die Automation:

  • sendet bei jeder falschen Code-Eingabe eine Push-Benachrichtigung

  • kann optional im Moment der falschen Eingabe ein Kamerabild aufnehmen, in Home Assistant speichern und in der Benachrichtigung anzeigen

  • kann optional auf bestimmte Zeiten beschränkt werden, z. B. nur nachts

Hinweis: Diese Anleitung gilt für die neue DoorLine-Integration. Die Automation wird vollständig über die Oberfläche erstellt, YAML-Kenntnisse sind nicht erforderlich.

Voraussetzungen

  • Installierte DoorLine Key → siehe hierzu: Dokumentation der DoorLine Key

  • Ein laufendes Home Assistant System → siehe hierzu: https://www.home-assistant.io/installation/

  • Abgeschlossene Einrichtung der DoorLine-Integration mit der DoorLine Key in Home Assistant

  • Externe Code-Auswertung an der DoorLine Key aktiviert → siehe hierzu: Codes der DoorLine Key in Home Assistant auswerten

  • Home Assistant App auf dem Smartphone installiert und angemeldet, Mitteilungen für die App erlaubt → siehe hierzu: https://www.home-assistant.io/integrations/mobile_app/

  • Für das Kamerabild (optional): eine DoorLine Snap oder eine andere Kamera, die in Home Assistant eingebunden ist

Funktionsweise im Überblick

Funktionsweise_Falscher_Code_DoorLine_Key_v2.svg
  • Code-Eingabe: Ein Code wird am Tastenfeld der DoorLine Key eingegeben und mit der Schlüsseltaste bestätigt.

  • Weitergabe an Home Assistant: Ist der Code keinem lokalen Benutzer der DoorLine Key zugeordnet, gibt die Key ihn über die Externe Code-Auswertung an Home Assistant weiter.

  • Auswertung in Home Assistant: Passt der Code zu keinem HA-Benutzer, meldet die Ereignis-Entität Code-Eingabe das Ereignis Abgelehnt. Der Sensor Abgelehnte Code-Eingaben wird um 1 erhöht.

  • Automation: Die Automation reagiert auf das Ereignis Abgelehnt und sendet eine Push-Benachrichtigung, optional mit Kamerabild.

  • Codes von HA-Benutzern: Diese werden immer als Akzeptiert gemeldet und lösen keine Warnung aus.

Welche Eingaben zählen als falscher Code?

Als falsch bzw. abgelehnt zählen nur Codes, die weder lokal in der DoorLine Key noch als HA-Benutzer in Home Assistant angelegt sind.

Eingabe

Meldung in Home Assistant

Warnung

Unbekannter Code

Code-Eingabe: Abgelehnt

ja

Code eines HA-Benutzers

HA-Benutzer: Name: Akzeptiert

nein

Code eines HA-Benutzers, Automation ausgeschaltet (z. B. verbrauchter Einmalcode)

HA-Benutzer: Name: Akzeptiert

nein

Code eines HA-Benutzers außerhalb des Zeitfensters

HA-Benutzer: Name: Akzeptiert

nein

Zusätzlich zählt der Sensor Abgelehnte Code-Eingaben unter Diagnose der DoorLine Key die abgelehnten Eingaben mit.

1. Entitäten und Push-Aktion ermitteln

Funktion

Name im Gerät

Entität (Beispiel)

Alle Code-Eingaben

Code-Eingabe

Ereignis-Entität der DoorLine Key

Anzahl falscher Codes

Abgelehnte Code-Eingaben

Sensor unter Diagnose

Push-Aktion

–

notify.mobile_app_iphone

Die Entitäten sind unter Einstellungen > Geräte & Dienste > DoorLine > Gerät oder unter Entwicklerwerkzeuge > Zustände zu finden (Suche nach doorline).

Sind die Geräte einzelnen Bereichen zugeordnet, wird die Bezeichnung mit in die Entität aufgenommen z. B.:

sensor.doorline_key_abgelehnte_code_eingaben → sensor.entrance_doorline_key_abgelehnte_code_eingaben

Die Push-Aktion ist keine Entität. Sie wird in der Automation über den Suchbegriff mobile_app ausgewählt, siehe hierzu die Anleitung Push-Benachrichtigung mit Live-Bild und Türöffner.

2. Automation erstellen

Eine neue Automation erstellen unter Einstellungen > Automationen & Szenen > + Automation erstellen > Neue Automation erstellen.

Schritt 1 – Auslöser: Code abgelehnt

Im Abschnitt Sobald auf + Auslöser hinzufügen klicken, im Reiter Nach Ziel die DoorLine Key auswählen und Ereignis empfangen wählen.

Als Ziel ist zunächst das ganze Gerät DoorLine Key mit den zugehörigen Entitäten (z. B. 2) eingetragen. Das Gerät über X entfernen und über + Ziel hinzufügen nur die Entität Code-Eingabe auswählen.

  • Ziel: Code-Eingabe

  • Ereignistyp: Abgelehnt

Wichtig: Den Ereignistyp erst auswählen, nachdem das Ziel angepasst wurde, bzw. nach dem Ändern des Ziels prüfen, ob Abgelehnt noch ausgewählt ist. Ist das Feld leer, kann die Automation nicht gespeichert werden (Fehlermeldung required key not provided at 'options.event_type').

image-20260930-094811.png
image-20260930-095016.png


Schritt 2 – Aktion: Push-Benachrichtigung

Im Abschnitt Dann auf + Aktion hinzufügen klicken, im Suchfeld mobile_app eingeben und die Push-Aktion des eigenen Smartphones auswählen.

  • message (Nachricht): An der DoorLine Key wurde ein falscher Code eingegeben.

  • title (Titel): Häkchen setzen und DoorLine Key Warnung eintragen

Über ⋮ > Bei Fehler fortfahren aktivieren.

image-20260930-115738.png
image-20260930-115824.png


Schritt 3 – Speichern

Auf Speichern klicken und einen Namen vergeben, z. B. „DoorLine Key – Warnung bei falschem Code“.

Die Automation ist damit fertig. Weiter mit Schritt 3. Testen.

3. Testen

Am Tastenfeld der DoorLine Key einen Code eingeben, der weder lokal noch als HA-Benutzer angelegt ist, z. B. 000000, und mit der Schlüsseltaste bestätigen. Auf dem Smartphone erscheint die Push-Benachrichtigung. Unter Diagnose der DoorLine Key erhöht sich der Wert von Abgelehnte Code-Eingaben um 1.

Warnung nur nachts

Soll die Warnung z. B. nur nachts gesendet werden, im Abschnitt Und wenn auf + Bedingung hinzufügen klicken, im Suchfeld Zeit eingeben und Zeit wählen.

  • Nach: 22:00:00

  • Vor: 06:00:00

image-20260930-095441.png
image-20260930-095521.png


Liegt Nach später als Vor, gilt das Zeitfenster über Mitternacht hinweg.

Anzahl der falschen Eingaben in der Nachricht anzeigen

In der Nachricht kann zusätzlich angezeigt werden, wie oft bisher ein falscher Code eingegeben wurde. Dazu im Feld message den folgenden Text eintragen und die Entität durch den eigenen Sensor Abgelehnte Code-Eingaben ersetzen:

An der DoorLine Key wurde ein falscher Code eingegeben. Abgelehnte Eingaben: {{ states('sensor.doorline_key_abgelehnte_code_eingaben') }}

Die genaue Bezeichnung des Sensors steht unter Entwicklerwerkzeuge > Zustände (Suche nach abgelehnte).

image-20260930-095711.png

Anzahl für einen Zeitraum

Der Sensor Abgelehnte Code-Eingaben zählt alle falschen Eingaben seit dem Beginn. Mit einem Helfer kann die Anzahl zusätzlich für einen Zeitraum ermittelt werden, z. B. für die letzte Stunde oder für den aktuellen Tag.

Zeitraum

Helfer

Beispiel

gleitend, z. B. letzte Stunde

Statistik

Falsche Codes in den letzten 60 Minuten

fest, z. B. heute

Verbrauchszähler

Falsche Codes seit Mitternacht

Falsche Codes in der letzten Stunde (Statistik)

Unter Einstellungen > Geräte & Dienste > Helfer auf + Helfer erstellen klicken und Statistik auswählen.

  • Name: z. B. Falsche Codes letzte Stunde

  • Entität: Abgelehnte Code-Eingaben der DoorLine Key

Auf Weiter klicken.

  • Merkmal: Anzahl

Auf Weiter klicken.

  • Maximales Alter: 1 Stunde (01:00:00)

  • alle anderen Felder unverändert lassen

Mit Absenden bestätigen.

image-20260930-100215.png
image-20260930-100244.png


Der Helfer zählt, wie oft sich der Sensor Abgelehnte Code-Eingaben in der letzten Stunde erhöht hat. Eingaben, die länger als eine Stunde zurückliegen, fallen automatisch heraus.

Hinweis: Als Merkmal Anzahl wählen, nicht Veränderung. Veränderung berechnet die Differenz zwischen dem ältesten und dem neuesten Wert im Zeitraum und ergibt bei nur einer falschen Eingabe in der letzten Stunde den Wert 0.

Hinweis: Die Bezeichnungen der Felder können je nach Home Assistant-Version abweichen. Für einen anderen Zeitraum, z. B. die letzten 24 Stunden, bei Maximales Alter den entsprechenden Wert eintragen.

Falsche Codes heute (Verbrauchszähler)

Unter Einstellungen > Geräte & Dienste > Helfer auf + Helfer erstellen klicken und Verbrauchszähler auswählen.

  • Name: z. B. Falsche Codes heute

  • Eingangssensor: Abgelehnte Code-Eingaben der DoorLine Key

  • Zurücksetzungszyklus: Täglich

  • Periodisch zurückgesetzte Werte: aktivieren

Mit Absenden bestätigen.

image-20260930-101229.png

Der Zähler beginnt jeden Tag um Mitternacht wieder bei 0. Mit Stündlich, Wöchentlich oder Monatlich lassen sich auch andere feste Zeiträume einstellen.

Hinweis: Periodisch zurückgesetzte Werte sorgt dafür, dass der Zähler auch dann richtig weiterzählt, wenn der Sensor Abgelehnte Code-Eingaben z. B. nach einem Neustart der DoorLine Key wieder bei 0 beginnt.

Anzahl in der Nachricht anzeigen

Die Helfer erscheinen anschließend als eigene Sensoren. Da sie auf einem Sensor der DoorLine Key aufbauen, werden sie dem Gerät DoorLine Key zugeordnet und der Gerätename wird mit in den Namen der Entität aufgenommen, z. B. sensor.doorline_key_falsche_codes_letzte_stunde und sensor.doorline_key_falsche_codes_heute.

Ist die DoorLine Key einem Bereich zugeordnet, wird auch der Bereich mit aufgenommen, z. B.:

sensor.doorline_key_falsche_codes_letzte_stunde → sensor.entrance_doorline_key_falsche_codes_letzte_stunde

Die genauen Bezeichnungen stehen unter Entwicklerwerkzeuge > Zustände (Suche nach falsche). In den folgenden Texten die Beispiel-Entitäten durch die eigenen ersetzen.

image-20260930-100810.png

Im Feld message der Push-Benachrichtigung z. B. den folgenden Text eintragen:

An der DoorLine Key wurde ein falscher Code eingegeben. Letzte Stunde: {{ states('sensor.doorline_key_falsche_codes_letzte_stunde') }}, heute: {{ states('sensor.doorline_key_falsche_codes_heute') }}

Die Nachricht lautet dann z. B.: „An der DoorLine Key wurde ein falscher Code eingegeben. Letzte Stunde: 2, heute: 5“.

Warnung erst ab mehreren falschen Codes

Soll nicht bei jeder einzelnen falschen Eingabe gewarnt werden, sondern erst ab z. B. 3 falschen Codes innerhalb einer Stunde, wird in der Automation aus Schritt 2 der Auslöser ausgetauscht.

Den vorhandenen Auslöser Ereignis empfangen über ⋮ > Löschen entfernen. Anschließend auf + Auslöser hinzufügen klicken, im Suchfeld Numerischer Zustandsschwellenwert überschritten

eingeben und auswählen.

  • Entität: Falsche Codes letzte Stunde

  • Über: Option Feste Zahl wählen und 2 eintragen

  • Unter: leer lassen

image-20260930-114001.png
image-20260930-114014.png


Die Nachricht z. B. wie folgt anpassen:

Achtung: An der DoorLine Key wurden in der letzten Stunde {{ states('sensor.doorline_key_falsche_codes_letzte_stunde') }} falsche Codes eingegeben.

Hinweis: Der Auslöser Numerischer Zustandsschwellenwert überschritten löst nur einmal aus, wenn der Wert die Schwelle überschreitet, also beim 3. falschen Code. Weitere falsche Eingaben in derselben Stunde lösen keine neue Warnung aus. Erst wenn der Wert wieder auf 2 oder darunter gefallen ist, wird beim nächsten Überschreiten erneut gewarnt.

Tipp: Beide Automationen können auch parallel genutzt werden, z. B. eine Nachricht bei jeder falschen Eingabe nur nachts und zusätzlich eine Warnung ab 3 falschen Codes rund um die Uhr.

Warnung mit Kamerabild

Ist eine DoorLine Snap oder eine andere Kamera in Home Assistant eingebunden, kann im Moment der falschen Code-Eingabe ein Bild aufgenommen werden. Das Bild wird in Home Assistant unter Medien gespeichert und zusätzlich in der Push-Benachrichtigung angezeigt. So ist auch später noch nachvollziehbar, wer den falschen Code eingegeben hat.

image-20260930-120908.png

Dazu wird die Automation aus Schritt 2 um zwei Aktionen ergänzt und die Push-Benachrichtigung angepasst. Die Reihenfolge im Abschnitt Dann ist anschließend:

  1. Variablen definieren (neu)

  2. Kamera-Schnappschuss machen (neu)

  3. Push-Benachrichtigung (angepasst)

Kamera-Entität ermitteln

Funktion

Name im Gerät

Entität (Beispiel)

Kamera

Kamera

camera.doorline_snap_kamera

Schritt A – Aktion: Variablen definieren

Im Abschnitt Dann auf + Aktion hinzufügen klicken, den Reiter Bausteine öffnen und Variablen definieren auswählen. Für diesen Baustein gibt es keinen visuellen Editor, er wird direkt als YAML angezeigt. Den vorhandenen Inhalt vollständig durch den folgenden Text ersetzen:

variables:
  bild: "{{ now().strftime('%Y%m%d_%H%M%S') }}"

bild legt den Dateinamen aus Datum und Uhrzeit fest, z. B. 20260930_221514 für den 30.09.2026 um 22:15:14 Uhr. So wird jedes Bild unter einem eigenen Namen gespeichert und nichts überschrieben.

Den Baustein anschließend über das Symbol zum Verschieben (⠿) ganz nach oben an die erste Stelle im Abschnitt Dann ziehen.

image-20260930-114832.png
image-20260930-114843.png


Schritt B – Aktion: Bild speichern

Auf + Aktion hinzufügen klicken, im Suchfeld Schnappschuss eingeben und Kamera-Schnappschuss machen auswählen.

  • Ziele: + Entität auswählen und die Kamera der DoorLine Snap auswählen

  • Dateiname: den folgenden Text unverändert einfügen:

/media/doorline/falscher_code/{{ bild }}.jpg

Über ⋮ > Bei Fehler fortfahren aktivieren. So wird die Push-Benachrichtigung auch dann gesendet, wenn die Kamera kein Bild liefert.

Die Aktion an die zweite Stelle ziehen, direkt unter Variablen definieren und vor die Push-Benachrichtigung.

image-20260930-115002.png
image-20260930-115017.png


Hinweis: Die Bezeichnung der Aktion kann je nach Home Assistant-Version abweichen. Die Aktion lautet technisch immer camera.snapshot und lässt sich auch über den Suchbegriff snapshot finden. Home Assistant legt den Ordner falscher_code beim ersten Bild automatisch an.

Schritt C – Push-Benachrichtigung anpassen

Die vorhandene Push-Benachrichtigung öffnen, bei data (Daten) ein Häkchen setzen und den folgenden Text eintragen:

image: /media/local/doorline/falscher_code/{{ bild }}.jpg
image-20260930-115056.png

Anschließend auf Speichern klicken.

Hinweis: Beim Speichern ist der Pfad /media/doorline/…, in der Push-Benachrichtigung dagegen /media/local/doorline/…. Das ist beabsichtigt: /media/local/ ist die Adresse, unter der Home Assistant den Ordner /media für die App bereitstellt.

Ergebnis

Bei jeder falschen Code-Eingabe wird ein Bild aufgenommen und gespeichert, z. B. 20260930_221514.jpg. Die Push-Benachrichtigung zeigt genau dieses Bild. Alle Bilder sind unter Medien > My media > doorline > falscher_code abrufbar und können dort angesehen und heruntergeladen werden.

Aktionen als Code

Zur Kontrolle: So sieht der Abschnitt Dann über ⋮ > In YAML bearbeiten aus. Die Namen der Kamera und der Push-Aktion werden bei der Erstellung über die Oberfläche automatisch eingetragen.

actions:
  - variables:
      bild: "{{ now().strftime('%Y%m%d_%H%M%S') }}"
  - action: camera.snapshot
    continue_on_error: true
    target:
      entity_id: camera.doorline_snap_kamera
    data:
      filename: /media/doorline/falscher_code/{{ bild }}.jpg
  - action: notify.mobile_app_iphone
    continue_on_error: true
    data:
      title: DoorLine Key – Warnung
      message: An der DoorLine Key wurde ein falscher Code eingegeben.
      data:
        image: /media/local/doorline/falscher_code/{{ bild }}.jpg

Mehrere Bilder speichern

Sollen wie beim Klingeln mehrere Bilder im Abstand von ca. 1 Sekunde gespeichert werden, kann der Schnappschuss in einen Baustein Wiederholen gesetzt werden → siehe hierzu: (v2) Kamerasnapshots historisch speichern bei Klingeln. Die Push-Benachrichtigung zeigt dann das erste Bild, z. B. /media/local/doorline/falscher_code/{{ bild }}_01.jpg.

Alte Bilder automatisch löschen

Die Bilder bleiben dauerhaft gespeichert. Sollen alte Bilder automatisch gelöscht werden, kann der Befehl aus der Anleitung Kamerasnapshots historisch speichern bei Klingeln, Abschnitt Optional: Alte Bilder automatisch löschen, verwendet werden. Dort den Pfad /media/doorline durch /media/doorline/falscher_code und -type d durch -type f ersetzen, da hier einzelne Bilder statt Ordner gespeichert werden.

Fehlerbehebung

Fehlermeldung beim Speichern: „Message malformed: required key not provided at 'options.event_type'“ Im Auslöser Ereignis empfangen ist kein Ereignistyp ausgewählt. Den Auslöser öffnen, bei Ereignistyp Abgelehnt auswählen und erneut speichern.

Keine Push-Benachrichtigung bei falschem Code In der Automation oben rechts über ⋮ > Ablaufprotokoll prüfen, ob die Automation ausgelöst wurde. Wurde sie nicht ausgelöst, prüfen, ob an der DoorLine Key die Externe Code-Auswertung eingeschaltet ist und ob im Auslöser nur die Entität Code-Eingabe mit dem Ereignistyp Abgelehnt ausgewählt ist.

Keine Warnung bei einem bestimmten Code Der Code ist als HA-Benutzer oder als lokaler Benutzer in der DoorLine Key angelegt und zählt deshalb nicht als falsch, auch wenn er die Tür nicht öffnet (siehe Welche Eingaben zählen als falscher Code?).

Automation wurde ausgelöst, aber keine Nachricht auf dem Smartphone Den Namen der Push-Aktion prüfen und in der Home Assistant App prüfen, ob Mitteilungen erlaubt sind, siehe hierzu die Anleitung Push-Benachrichtigung mit Live-Bild und Türöffner.

Zu viele Nachrichten Wird mehrfach hintereinander ein falscher Code eingegeben, kommt für jede Eingabe eine Nachricht. Soll nach einer Nachricht für eine Weile Ruhe sein, am Ende der Aktionen im Reiter Bausteine Eine Zeit warten (Verzögerung) mit z. B. 00:05:00 hinzufügen. Der Modus der Automation bleibt dabei auf Einzeln. Weitere falsche Eingaben innerhalb der Wartezeit lösen dann keine neue Nachricht aus.

Kein Bild in der Push-Benachrichtigung Unter Medien > My media > doorline > falscher_code prüfen, ob das Bild gespeichert wurde.

  • Bild ist vorhanden: Im Feld data der Push-Benachrichtigung prüfen, ob der Pfad mit /media/local/ beginnt. Auf iOS außerdem unter iOS-Einstellungen > Home Assistant > Standort die Option Immer wählen, da die App sonst im Hintergrund das Bild nicht laden kann.

  • Bild fehlt: Im Ablaufprotokoll der Automation prüfen, ob bei Kamera-Schnappschuss machen ein Fehler angezeigt wird, und ob Variablen definieren an erster Stelle steht.

Bild heißt wörtlich „{{ bild }}.jpg“ Der Baustein Variablen definieren fehlt oder steht unterhalb von Kamera-Schnappschuss machen. Er muss als erste Aktion im Abschnitt Dann stehen.

Fehlermeldung „no access to path; allowlist_external_dirs may need to be adjusted“ Home Assistant darf nicht in den Ordner schreiben. Bei Home Assistant OS und Supervised ist /media automatisch freigegeben. Bei Home Assistant Container oder Core siehe Fehlerbehebung in der Anleitung Kamerasnapshots historisch speichern bei Klingeln.