Telegram Inline Keyboard in Home Assistant: Automatisierungen auslösen & Smart Home steuern

Was macht dieses Snippet? Telegram Inline Keyboard in Home Assistant

Mit diesem Snippet kannst du ein sogenanntes Inline Keyboard in Telegram-Nachrichten aus Home Assistant heraus nutzen. Ein Inline Keyboard ist eine Tastatur mit Schaltflächen, die direkt unter einer Telegram-Nachricht angezeigt werden. Damit kannst du Benutzerinteraktionen ermöglichen, zum Beispiel um Automatisierungen auszulösen oder externe Links zu öffnen. Besonders praktisch ist das für schnelle Rückmeldungen oder zur Steuerung deines Smart Homes direkt aus dem Chat heraus.

Beispiel: Telegram-Nachricht mit Inline Keyboard und Links

Im folgenden YAML-Beispiel wird eine Telegram-Nachricht mit zwei Schaltflächenreihen gesendet. Jede Schaltfläche öffnet beim Antippen einen Link – etwa zur Home Assistant App oder zu Google. Du kannst die Beschriftungen und Links beliebig anpassen. Das ist nützlich, wenn du häufig genutzte Webseiten oder Smart-Home-Oberflächen direkt erreichbar machen möchtest.

service: telegram_bot.send_message

metadata: {}

1data:
2  parse_mode: markdown
3  message: >-
4    Hey there. This is a telegram message directly out of your 
5    Home Assistant instance. React with the following buttons!
6  inline_keyboard:
7    - - - "App öffnen"
8        - https://www.home-assistant.io/ios
9      - - "Google"
10        - https://google.de
11    - - - "App öffnen"
12        - https://www.home-assistant.io/ios
13      - - "Google"
14        - https://google.de

Du kannst die Reihenfolge, Anzahl und Ziel-URLs der Schaltflächen nach deinen Bedürfnissen anpassen. Die Nachricht erscheint dann mit den gewünschten Buttons in deinem Telegram-Chat.

Beispiel: Telegram Inline Keyboard zum Auslösen von Aktionen

Im nächsten Beispiel wird eine Schaltfläche eingebaut, die beim Antippen kein Link öffnet, sondern einen sogenannten Callback an Home Assistant sendet. Das ist sinnvoll, wenn du direkt aus Telegram heraus Automatisierungen oder Aktionen in deinem Smart Home starten möchtest.

service: telegram_bot.send_message

metadata: {}

1data:
2  parse_mode: markdown
3  message: >-
4    Hey there. This is a telegram message directly out of your 
5    Home Assistant instance. React with the following buttons by firing events!
6  inline_keyboard:
7    - - - "Play Ping Pong"
8        - /ping

Hier wird beim Drücken der Schaltfläche ein Callback mit dem Wert /ping an Home Assistant geschickt. Das ist die Grundlage, um darauf mit einer Automatisierung zu reagieren.

Beispiel: Automatisierung für Telegram Callback

Mit dieser Automatisierung reagiert Home Assistant auf das Telegram Callback-Event mit dem Datenwert /ping. Sobald du im Chat auf die entsprechende Schaltfläche tippst, wird automatisch eine Antwortnachricht gesendet. So kannst du beliebige Aktionen anstoßen, zum Beispiel Geräte schalten, Szenen starten oder Informationen abfragen.

description: "Automation template to react to the callbacks event"

1mode: single
2trigger:
3  - platform: event
4    event_type: telegram_callback
5    event_data:
6      data: '/ping' 
7condition: []
8action:
9  - service: telegram_bot.send_message
10    metadata: {}
11    data:
12      parse_mode: markdown
13      message: Pong!
14alias: "Play Ping Pong"

Du kannst das Callback-Event und die Aktionen beliebig anpassen, um dein Smart Home flexibel und interaktiv per Telegram steuern zu können. Besonders praktisch ist das für schnelle Rückmeldungen, Statusabfragen oder die Steuerung unterwegs.