Mit der Home Assistant Telegram Plattfrom lassen sich aus Home Assistant heraus Meldungen an Telegram Chats schicken. Dies kann sehr gut verwendet werden um z.B. als Funktion einer Alarmanlage beim Öffnen einer Tür oder Bewegung in einem Zimmer informiert zu werden.

Telegram einrichten

1. Telegram Bot erstellen und API Key erhalten: Zunächst must du einen Telegram Bot erstellen. Dazu gibt es den BotFather Bot. Du kannst diesen Bot einfach mit Telegram anchatten und ihm sagen das du einen neuen Bot erstellen möchtest. Dazu schickst du „/newbot“ und folgst den Anweisungen des BotFather. du must dann einen Namen und einen Usernamen der auf „bot“ endet vergeben. BotFather erstellt daraufhin deinen Bot und gibt dir einen HTTP Access Token (z.B. 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw) den du im weiteren Verlauf benötigst. Den Token must du sicher verwahren.


2. Bot kontaktieren: Telegram Bots können nicht einfach Nachrichten an Benutzer schicken. Zunächst muss immer eine Nachricht vom Benutzer zum Bot geschickt worden sein. D.h. du must in Telegram eine Nachricht an deinen neuen Bot schicken. Dazu einfach in Telegram nach dem vergebenen Bot Namen suchen und anchatten.


3. Chat ID ermitteln: Der schnellste Weg die eigene Chat ID zu ermitteln ist es den GetIDs Bot anzuchatten.


4. Home Assistant Konfiguration anpassen: In der Home Assistant Konfiguration muss nun noch der Telegram Bot eingetragen werden. Dazu benötigst du den oben erstellten API Key deines Bots und deine Chat ID. Nach der Konfigurationsanpssung must du Home Assistant neustarten.

   # --- Telegram Notfification ---------------------------------------------------
   telegram_bot:
     - platform: polling
       api_key: "API KEY"
       allowed_chat_ids:
         - CHAT ID
   
   notify:
     - name: telegram
       platform: telegram
       chat_id: CHAT ID
   



5. Erste Nachricht versenden: Nach der Einrichtung stehen nun neue telegram Services zur Verfügung. Am einfachsten testest du das Verschicken einer Nachricht über „Entwicklerwerkzeuge“ -> „Dienste“ und dort den Telegram Send Service (telegram_bot.send_message).

Beispiel Verwendung: Haustür Überwachung

Ein nützlicher Anwendungsfall ist z.B. die Tür-Überwachung im Rahmen einer Alarmanlage. Der Telegram Service sorgt in diesem Fall für die Meldung auf das Handy wenn die Tür geöffnet oder geschlossen wird. Unten ist ein Beispiel aufgeführt, welches in die „configuration.yaml“ aufgenommen werden kann. Der Binary Sensor „HOUSE_DOOR_SENSOR“ muss durch eine eigene Sensor Entity ausgetauscht werden.

automation:
  - alias: House door open
    trigger:
      platform: state
      entity_id: binary_sensor.HOUSE_DOOR_SENSOR
      to: 'on'
    action:
      service: telegram_bot.send_message
      data:
        message: "House door open"
  - alias: House door close
    trigger:
      platform: state
      entity_id: binary_sensor.HOUSE_DOOR_SENSOR
      to: 'off'
    action:
      service: telegram_bot.send_message
      data:
        message: "House door close"

Hardware

Bei der Auswahl einer Reolink Kamera für die Integration in Home Assistant muss etwas darauf aufgepasst werden, dass diese auch mit Home Assistant zusammen arbeitet. Bei dem in diesem Tutorial Plugin werden unten auf der Seite einige Modelle gelistet die nicht funktionieren. z.B. gibt es von der E1 Pro verschiedene Varianten. Die normale geht nicht, die „Zoom“ sollte aber funktionieren. Im wesentlichen liegt dies daran das Reolink bei einigen Kameras auf ein Hauseigenes Protokoll setzt. Es ist daher wichtig eine Kamera zu kaufen die das standardisierte RTSP (Real Time Streaming Protocol) unterstützt.

Kamera in das Netzwerk integrieren

Viele der Kameras können wahlweise über Ethernet Kabel oder WLAN angeschlossen werden.

• Ethernet: Hier empfiehlt sich der Reolink Client für Windows. Er kann die Kamera im Netzwerk finden und einrichten. Wichtig ist ihr eine feste IP-Adresse zu zuweisen, damit die Kamera immer unter der selben Adresse für Home Assistant erreichbar ist.
• WLAN: Die WLAN Einrichtung geht am einfachsten über die Handy App. Hierbei wird ein QR Code unter der Kamera gescannt. Anschließend werden die WLAN Zugangsdaten eingetragen und die APP generiert hieraus einen QR Code. Dieser beinhaltet die WLAN Zugangsdaten und wird dann mit der Kamera abgefilmt. Dieses liest die Zugangsdaten aus und wählt sich in das Netzwerk ein. Anschlie0end sollte der Kamera noch eine feste IP gegeben werden. Dies geht z.B. mit der oben beschriebenen Windows Anwendung

Home Assistant Integration

Wir nutzen für die Integration der Kamera die „Home Assistant Reolink custom integration“. Am einfachsten lässt sich diese mittels HACS in Home Assistant installieren. Dazu gehst du wie unten beschrieben vor. Alternativ kannst du die Integration auch manuell installieren. Diese muss letztlich nur in das Verzeichnis „/config/custom_components/reolink_dev“ der Home Assistant Installation kopiert werden. Dazu kannst du z.B. einen Samba Server auf dem Home Assistant einrichten und über Netzwerk zugreifen.

1. Klicke auf ACS im Home Assistant Menü
2. Klicke auf Integrationen
3. Klicke auf die drei Punkte in der oberen rechten Ecke
4. und wählst „Benutzerdefinierte Repositories“
5. Kopiere die Repository URL (https://github.com/fwestenberg/reolink_dev) in die DialogBox und
6. wähle Integration
7. Klicke Hinzufügen
8. Klicke unten rechts auf den Button „durchsuchen und herunterladen von Repositories“ und suche nach Reolink
9. Repostory hinzufügen und Home Assistant anschließend neu starten

Zum Hinzufügen der Kamera gehst du wie folgt vor:
Einstellungen -> Geräte & Dienste -> Integration hinzufügen (rechts unten) -> Reolink IP Camera eingeben und hinzufügen.

Anschließend musst du noch deine IP Adresse der Kamera einfügen und dessen Zugangsdaten. Nun sollte die Kamera als Entität in Home Assistant vorhanden sein.