Home Assistant Telegram-Bot – das Haus schreibt dir

Passende Hardware im Überblick

Basis – Home Assistant muss durchlaufen, sonst schweigt der Bot:
Raspberry Pi 5 mit 8GB RAM – die Empfehlung (Link)*
Raspberry Pi 5 mit 16GB RAM – wenn Kameras dazukommen (Link)*
Raspberry Pi 5 mit 4GB RAM – reicht für ein normales Haus (Link)*
Home Assistant Green – das Fertiggerät ohne Bastelei (Link)*
Offizielles 27-W-Netzteil für den Pi 5 (Link)*
Geekworm X1001 M.2-HAT für NVMe-Betrieb (Link)*
Intenso M.2 NVMe SSD 500GB (Link)*
SanDisk Extreme A2 128GB – wenn es günstig sein soll (Link)*

Funk und Sensoren – ohne Auslöser keine Nachricht:
Sonoff Zigbee-Stick MG24 – der Klassiker (Link)*
Home Assistant Connect ZBT-2 für Zigbee und Thread (Link)*
Aqara Tür- und Fensterkontakte im 3er-Set (Link)*
Aqara FP2 Präsenzmelder (Link)*
Shelly Plug S Gen3 – misst, wann die Waschmaschine fertig ist (Link)*

Bild und Alarm – das, was sich als Foto im Chat lohnt:
Reolink RLC-810A PoE-Kamera (Link)*
Reolink Video-Türklingel PoE (Link)*
X-Sense Rauchmelder-Set mit Basisstation (Link)*

Kurz gesagt: Was bringt ein Telegram-Bot in Home Assistant?

Wer Home Assistant mit Telegram koppelt, gibt dem Haus eine Stimme: Es meldet sich von selbst, schickt Fotos mit und nimmt auf Knopfdruck Befehle entgegen. Die wichtigsten Punkte vorab:

• Was es ist: Ein eigener Telegram-Bot, den Home Assistant über die Integration telegram_bot ansteuert – kostenlos, ohne Cloud-Abo und ohne zusätzliche Hardware.
• Warum überhaupt Telegram: Gruppen-Chats für die ganze Familie, Bilder und Videos im Verlauf, anklickbare Schaltflächen und Rückkanal – all das kann eine gewöhnliche Push-Nachricht nicht.
• Zwei Zutaten: Ein API-Token vom @BotFather und die numerische Chat-ID des Empfängers. Mehr braucht die Einrichtung nicht.
• Keine Portfreigabe nötig: Im Modus Polling holt Home Assistant die Nachrichten selbst ab. Der Router bleibt zu, von außen führt kein Weg ins Netz.
• Der Rückkanal ist der eigentliche Trick: Ereignisse wie telegram_callback und telegram_command machen aus jeder Nachricht eine Fernbedienung – die Antwort im Chat löst wieder eine Automation aus.
• Sicherheit: Nur freigegebene Chat-IDs dürfen etwas auslösen. Der Token gehört behandelt wie ein Passwort.

Home Assistant Telegram-Bot: was der Messenger im Smart Home leistet

Ein Smart Home, das nur auf Knopfdruck reagiert, ist halb fertig. Richtig nützlich wird es erst, wenn es von sich aus Bescheid sagt – und zwar dort, wo ohnehin ständig hingeschaut wird. Genau das ist die Rolle des Telegram-Bots: Er verwandelt einen Messenger, den viele ohnehin geöffnet haben, in den Melde- und Steuerkanal des Hauses.

Technisch steckt dahinter die offizielle Bot-Schnittstelle von Telegram. Ein Bot ist kein Benutzerkonto, sondern ein Dienst mit eigenem Namen, eigenem Profilbild und einem geheimen Token. Home Assistant meldet sich mit diesem Token bei Telegram an und darf von da an Nachrichten in genau die Chats schreiben, die freigegeben wurden. Der Weg zurück funktioniert ebenso: Schreibt jemand dem Bot oder tippt auf eine Schaltfläche unter einer Nachricht, erzeugt Home Assistant daraus ein Ereignis, auf das Automationen reagieren können.

Der Vergleich mit der Home-Assistant-App fällt differenzierter aus, als er oft dargestellt wird. Die Companion-App ist für den Administrator die erste Wahl: Sie kennt kritische Benachrichtigungen, liefert Standortdaten und Sensoren vom Handy und braucht keinen fremden Dienst. Telegram spielt seine Stärken dagegen dort aus, wo mehrere Menschen dieselbe Information brauchen. Ein Familien-Chat, in dem die Waschmaschine „fertig“ meldet und der Türsensor am Abend an das offene Fenster erinnert, funktioniert auch auf dem Handy der Kinder, auf dem niemand die App einrichten und ein Konto anlegen möchte.

Dazu kommt der Verlauf. Push-Nachrichten verschwinden, sobald sie weggewischt sind. Ein Chat bleibt – mit Zeitstempel, mit dem Foto vom Bewegungsmelder und mit der Möglichkeit, drei Wochen später nachzuschauen, wann die Heizung eigentlich das letzte Mal Alarm geschlagen hat. Für viele Haushalte ersetzt dieser Chatverlauf ein halbes Dashboard.

Telegram-Bot in Home Assistant einrichten – Schritt für Schritt

Die Einrichtung läuft inzwischen vollständig über die Oberfläche. Die frühere Konfiguration in der configuration.yaml gilt als veraltet; wer sie noch nutzt, sollte auf den Dialog umstellen.

1. Bot erzeugen: In Telegram den Kontakt @BotFather anschreiben, /newbot senden, einen Anzeigenamen und einen eindeutigen Benutzernamen auf _bot vergeben. Als Antwort kommt der API-Token – eine lange Zeichenkette, die niemals in ein Forum, einen Screenshot oder ein öffentliches Repository gehört.
2. Chat-ID ermitteln: Am schnellsten geht das über einen ID-Bot wie @id_bot, der die eigene numerische ID zurückschickt. Alternativ dem eigenen Bot eine Nachricht senden und https://api.telegram.org/bot<TOKEN>/getUpdates im Browser aufrufen – die ID steht im JSON. Für Gruppen zuerst den Bot einladen; Gruppen-IDs beginnen mit einem Minuszeichen.
3. Integration hinzufügen: In Home Assistant unter Einstellungen > Geräte & Dienste > Integration hinzufügen nach Telegram bot suchen, den Token einfügen und als Plattform Polling wählen. Broadcast und Webhooks folgen weiter unten.
4. Chat-IDs freigeben: Ohne Freigabe passiert nichts. Über das Drei-Punkte-Menü der Integration den Punkt zum Hinzufügen einer erlaubten Chat-ID aufrufen und die Nummer eintragen. Je Chat-ID legt Home Assistant eine eigene notify-Entität an.
5. Testnachricht senden: In den Werkzeugen unter Aktionen die Aktion telegram_bot.send_message aufrufen, einen kurzen Text eintragen und ausführen. Kommt die Nachricht an, steht der Kanal.
6. In eine Automation einbauen: Als Aktion entweder direkt telegram_bot.send_message nutzen oder die passende notify-Entität ansteuern. Vorlagen machen die Meldung konkret, etwa eine Temperaturangabe direkt aus dem Sensor statt eines allgemeinen Hinweises.
7. Dateizugriff erlauben (optional): Sollen lokale Bilder verschickt werden, muss deren Verzeichnis in der configuration.yaml unter homeassistant: allowlist_external_dirs stehen – üblicherweise /media. Erst danach findet der Bot die Datei.
8. Absichern und sichern: Token nur in Home Assistant hinterlegen, die Integration ins Backup einschließen und nach jeder Änderung eine Testnachricht schicken.

Broadcast, Polling oder Webhook – der richtige Modus

Die Integration kennt drei Betriebsarten. Sie unterscheiden sich nicht in dem, was der Bot senden kann, sondern darin, wie er von eingehenden Nachrichten erfährt – und das entscheidet über Antwortzeit und Angriffsfläche.

In den allermeisten Haushalten ist Polling die richtige Wahl. Home Assistant fragt bei Telegram nach neuen Nachrichten und hält die Verbindung dabei kurz offen, sodass Antworten praktisch verzögerungsfrei ankommen. Weil die Verbindung immer von innen nach außen aufgebaut wird, ist keine Portfreigabe nötig – ein Sicherheitsgewinn, den man nicht leichtfertig aufgeben sollte.

Webhooks lohnen sich nur, wenn Home Assistant ohnehin über eine öffentliche Adresse erreichbar ist. Selbstsignierte Zertifikate akzeptiert Telegram nicht. Wer trotzdem von unterwegs auf sein System will, fährt mit einem VPN oder einem Cloudflare-Tunnel deutlich sicherer als mit einem offenen Port. Broadcast wiederum ist die sparsamste Variante: Der Bot redet, hört aber nicht zu – ideal für ein System, das ausschließlich Statusmeldungen abliefern soll.

Meldungen, die sich wirklich lohnen

Der häufigste Anfängerfehler ist Übermut: Wer jedes Ereignis meldet, hat nach zwei Wochen einen Chat, den niemand mehr liest. Berichte aus der Community laufen erstaunlich einheitlich auf dieselbe Faustregel hinaus – gemeldet wird nur, was eine Handlung auslöst oder wirklich beruhigt. Diese Kandidaten haben sich dabei durchgesetzt:

• Der Türwächter: Haustür oder Fenster länger als fünf Minuten offen, dazu die passenden Kontaktsensoren – eine der wenigen Meldungen, für die sich wirklich jeder bedankt.
• Foto statt Text: Bewegung im Garten löst einen Schnappschuss der Überwachungskamera aus, der direkt in den Chat wandert. In Kombination mit einer Objekterkennung wie Frigate kommt die Nachricht nur noch bei Personen statt bei jeder Katze.
• Waschmaschine und Trockner: Fällt der Verbrauch einer smarten Steckdose für einige Minuten unter einen Schwellwert, gilt der Vorgang als beendet – die Meldung geht an die Familiengruppe, nicht an eine Person.
• Der System-Doktor: Volle Festplatte, zu hohe CPU-Temperatur oder ein Ausfall, den Uptime Kuma bemerkt, landen in einem getrennten Admin-Chat. Diese Trennung ist wichtig: technische Meldungen und Familienmeldungen gehören nie in denselben Verlauf.
• Der Morgenbericht: Eine einzige Sammelnachricht um sieben Uhr mit Wetter, offenen Fenstern und Müllabfuhr ersetzt fünf Einzelmeldungen über den Tag verteilt.
• Abwesenheits-Check: Verlässt die letzte Person das Haus, kommt eine Zusammenfassung der noch aktiven Verbraucher – oft die eleganteste Art, den Herd im Blick zu behalten.

Fotos, Schaltflächen und Rückfragen im Chat

Über die reine Textnachricht hinaus bringt die Integration einen ganzen Werkzeugkasten mit. Neben telegram_bot.send_message gibt es unter anderem send_photo, send_video, send_document und send_media_group, dazu edit_message und delete_message. Letztere sind unterschätzt: Eine Statusmeldung lässt sich damit aktualisieren, statt den Chat mit zwanzig neuen Zeilen zu fluten.

Für Bilder aus dem Haus ist der Ablauf zweistufig. Zuerst legt die Aktion camera.snapshot ein Standbild in einem erlaubten Verzeichnis ab, danach schickt telegram_bot.send_photo genau diese Datei. Wichtig ist die Reihenfolge und eine kurze Wartezeit dazwischen – wird das Foto zu früh verschickt, kommt eine halbe oder gar keine Datei an. Alternativ nimmt send_photo auch eine URL entgegen, was bei Kameras mit Standbild-Adresse den Zwischenschritt spart.

Richtig mächtig wird der Bot durch Schaltflächen. Unter einer Nachricht lässt sich eine inline_keyboard definieren – jede Zeile eine Reihe von Knöpfen, jeder Knopf mit Beschriftung und einem Befehl dahinter. Tippt jemand darauf, feuert Home Assistant das Ereignis telegram_callback mit den hinterlegten Daten. Eine Automation fängt dieses Ereignis ab und macht daraus, was gewünscht ist: Sirene auslösen, Alarm ignorieren, Licht dimmen oder eine Szene starten. Sauber gemacht wird die Rückmeldung mit answer_callback_query quittiert, damit im Chat nicht ewig die Ladeanimation dreht.

Der zweite Rückkanal sind Befehle. Nachrichten, die mit einem Schrägstrich beginnen, erzeugen das Ereignis telegram_command samt Argumenten – aus /status wird so eine Abfrage aller Fenster, aus /heizung 21 eine Solltemperatur. Wer den Bot ausschließlich zum Melden nutzt, kann diesen Teil ignorieren; wer ihn als Fernbedienung will, findet hier die einfachste Bedienoberfläche, die ein Smart Home haben kann.

Fehler und Stolpersteine

• Chat-ID nicht freigegeben: Der mit Abstand häufigste Grund, warum nichts ankommt. Fehlt die numerische ID in der Freigabeliste, verwirft Home Assistant die Nachricht kommentarlos. Gruppen-IDs mit führendem Minus werden dabei gern falsch übertragen.
• Token in der falschen Datei: Wer den Token in eine Automation oder ein geteiltes Konfigurations-Repository schreibt, verschenkt ihn. Wird er versehentlich veröffentlicht, hilft nur eines: beim @BotFather zurückziehen und neu erzeugen.
• Verzeichnis nicht erlaubt: Fotos schlagen fehl, solange der Ordner nicht in allowlist_external_dirs steht. Die Fehlermeldung im Protokoll ist eindeutig, wird aber oft übersehen.
• Formatierung zerschossen: Sonderzeichen wie Unterstrich, Stern oder eckige Klammer bringen den Markdown-Parser aus dem Tritt, sodass die Nachricht gar nicht erst zugestellt wird. Bei Texten aus Sensoren ist plain_text die entspannteste Einstellung.
• Zu viele Meldungen: Ein Bot, der bei jeder Bewegung piept, wird stummgeschaltet – und schweigt dann auch im Ernstfall. Sinnvolle Verzögerungen und Bedingungen sind wichtiger als jede weitere Automation.
• Alte Anleitungen aus dem Netz: Viele Beiträge zeigen noch die Einrichtung über configuration.yaml mit allowed_chat_ids. Das führt heute zu Konflikten mit der Einrichtung über die Oberfläche.
• Kein Ersatzkanal: Fällt Telegram aus oder ist das Internet weg, schweigt der Bot. Für wirklich kritische Dinge – Rauchmelder, Wassermelder – gehört ein zweiter Weg dazu, etwa eine Sirene im Haus.

Häufige Fragen zum Telegram-Bot in Home Assistant

Kostet der Telegram-Bot etwas?
Nein. Sowohl Telegram als auch die Integration in Home Assistant sind kostenlos, ein Abo wie Home Assistant Cloud ist dafür nicht nötig. Anfallen können allenfalls Mobilfunkkosten für die Bilder.

Ist das sicher genug für ein Smart Home?
Für Meldungen und einfache Steuerbefehle ja, sofern nur bekannte Chat-IDs freigegeben sind und der Token geheim bleibt. Fremde können dem Bot zwar schreiben, lösen damit aber nichts aus. Türschlösser und Alarmanlagen sollte man trotzdem lieber nicht per Chatbefehl entsichern.

Brauche ich eine Portfreigabe oder DynDNS?
Im Polling-Modus nicht. Home Assistant baut die Verbindung selbst nach außen auf und holt die Nachrichten ab. Nur der Webhook-Modus verlangt eine öffentlich erreichbare HTTPS-Adresse mit gültigem Zertifikat.

Telegram oder die Home-Assistant-App?
Die App ist für den Administrator besser, weil sie kritische Benachrichtigungen und Handysensoren beherrscht. Telegram gewinnt bei Familiengruppen, Fotos, Schaltflächen und Zweitgeräten. Sehr viele Haushalte nutzen schlicht beides parallel.

Geht das auch mit Signal oder WhatsApp?
Signal lässt sich über ein Zusatzpaket auf Basis von signal-cli anbinden, verlangt aber deutlich mehr Bastelei. WhatsApp bietet keinen offiziellen Weg für private Automationen. Als quelloffene Alternative kommt sonst noch Matrix in Frage.

Warum kommt die Nachricht doppelt an?
Meist läuft die Integration zweimal – etwa als Altlast aus der YAML-Konfiguration und zusätzlich über die Oberfläche. Ein zweiter Grund sind zwei Home-Assistant-Instanzen mit demselben Token, was Telegram beim Polling ins Stolpern bringt.

Kann der Bot auch Sprachnachrichten oder Dateien schicken?
Ja, neben Fotos beherrscht er Videos, Dokumente, Sprachnachrichten und Standorte. Praktisch ist das etwa für ein tägliches Protokoll oder den Export einer Verbrauchsauswertung.

Fazit

Der Home Assistant Telegram-Bot ist eine der Ergänzungen mit dem besten Verhältnis von Aufwand zu Nutzen: eine halbe Stunde Einrichtung, keine laufenden Kosten, keine offene Tür im Router – und danach ein Haus, das nicht nur schaltet, sondern auch Bescheid sagt. Unsere klare Empfehlung dazu lautet: Polling einrichten, einen Familien-Chat und einen getrennten Admin-Chat anlegen und mit höchstens drei Meldungen starten. Genau die Meldungen, die zu einer Handlung führen, gehören in den Chat – alles andere gehört ins Dashboard. Wer dann noch Schaltflächen ergänzt, hat aus einem Messenger die vielleicht bequemste Fernbedienung gemacht, die ein Smart Home haben kann – und den Rest der Familie ganz nebenbei mit an Bord geholt. Die Basis dafür bleibt ein stabil laufendes Home Assistant auf dem Raspberry Pi.

* = Affiliate Link (raspi-config.de ist Teilnehmer des Partnerprogramms von Amazon EU, das zur Bereitstellung eines Mediums für Websites konzipiert wurde, mittels dessen durch die Platzierung von Werbeanzeigen und Links zu Amazon.de Werbekostenerstattung verdient werden kann.)