Home Assistant Telegram Integration

Ich weiß, ich weiß… Telegram hat auf dem ersten Blick einen schlechten Ruf. Jedoch kann die Home Assistant Telegram Integration gewisse Vorteile gegenüber der normalen App Benachrichtigung haben. In diesem Beitrag zeige ich euch, wie ihr die Integration in Home Assistant einbindet und konfiguriert.

Installiert euch dafür Telegram aufs Handy und erstellt dort einen Account. Installiert außerdem die Telegram Bot Integration in Home Assistant.

Bot erstellen

In Telegram startet ihr nun einen neuen Chat mit dem Chat Bot „BotFather“. Alternativ könnt ihr auf diesen Link klicken: https://t.me/botfather

Beginnt den Chat mit /start und erstellt anschließend mit dem Befehl /newbot einen neuen Bot.
Nun werdet Ihr nach dem Namen des Bots gefragt. Denkt euch hier einen Namen aus. Dieser darf jedoch noch nicht vergeben sein. Achtet zudem darauf, dass der Name nur kleine Buchstaben und Unterstriche enthalten darf. Zudem muss er mit „bot“ enden. Anschließend erhaltet Ihr einen API Key. Diesen bitte gut aufbewahren. Den benötigt wir in den kommenden Schritten.

Diesen Bot fügt man zu dem Chat hinzu, in dem die Home Assistant Benachrichtigungen ankommen sollen.
Das kann ein privater Chat sein. Es kann aber auch ein Gruppenchat sein.

Chat ID erhalten

Als Nächstes benötigen wir die ID des Chats. Dafür fügen wir den Bot „GetGroupId“ zu deinem Chat hinzu.
Um die Chat ID zu erhalten, gibst du im Chat /getgroupid ein. Als Antwort erhältst du die Chat-ID. Diese ebenfalls gut aufbewahren.

Home Assistant konfigurieren

In Home Assistant geht ihr nun auf die zuvor installierte Telegram Bot Integration und klickt auf „Eintrag hinzufügen“. Wählt bei „Plattform“ „Polling“ aus und tragt die API, welche ihr vom BotFather erhalten habt, bei „API-Token“ ein.
Klickt jetzt auf „Zulässige Chat-ID hinzufügen“ und tragt dort die Chat-ID von GetGroupID ein. Bitte beachten: Wenn die ID ein Minus enthält, muss das ebenfalls mit eingegeben werden.

Um anschließend eine Benachrichtigung versenden zu können, müssen wir in der configuration.yaml einen Notifier erstellen. Der sieht beispielhaft so aus:

notify:
  - platform: telegram
    name: "Mein Telegram Chat"
    chat_id: 44441111

Ersetzt den Namen und die Chat-ID, klickt auf Speichern und startet Home Assistant neu.

Nach einem Neustart von Home Assistant könnt ihr in der Automation als Benachrichtigung den Telegram Chat auswählen.

Vorteile

OK, schön. Aber was macht Telegram jetzt besser als die Home Assistant Benachrichtigung?

Ihr habt in Telegram einen Nachrichtenverlauf. Ihr seht also die genaue Uhrzeit, wann eine Benachrichtigung reinkam und könnt Sie auch lesen, nachdem Ihr die Benachrichtigung weggewischt habt.

Telegram kann Nachrichten, die älter als z.B. 1 Woche sind, automatisch löschen. So bleibt der Chatverlauf sauber

Man kann Bilder von z.B. einer Überwachungskamera anhängen und im Chat reinzoomen. Das geht in der einfachen Benachrichtigung nicht. Dazu muss bei der Benachrichtigung folgendes im Bereich „data“ stehen:

photo:
  - file: /stoage/images/bild.jpg
    caption: Kamera Haustür

Die Gruppenchat Funktion finde ich auch sehr praktisch. So können mehrere Personen eine Benachrichtigung erhalten, wenn z.B. die Waschmaschine fertig ist.

Wenn das Handy gewechselt wird, bleibt der administrative Aufwand minimal. Normalerweise müsste jede Automation mit der Benachrichtigung angepasst werden. Jetzt muss nur Telegram installiert werden, einloggen und das wars

Der jedoch größte Vorteil für mich: Man kann sich die Benachrichtigungen in Android Auto vorlesen lassen. Dafür muss nicht mal etwas separat konfiguriert werden. Telegram, wie auch Whatsapp ist eine normale Chat-App und bietet diese Funktion von Hause aus.