Home Assistant notificaties via Telegram

  • door

Om nog beter gebruik te kunnen maken van Home Assistant, kan het handig zijn om notificaties in te stellen.

Wat heb je nodig om dit uit te kunnen voeren:

  • Werkende Home Assistant instantie;
  • Telegram app geinstalleerd.

Telegram bots

Zelf ben ik een fervent gebruiker van de chat app Telegram. Telegram heeft ondersteuning voor bots.

Bots are simply Telegram accounts operated by software – not people – and they’ll often have AI features. They can do anything – teach, play, search, broadcast, remind, connect, integrate with other services, or even pass commands to the Internet of Things

Je kunt zelf een bot maken en deze koppelen aan je Home Assistant instantie. Dit is relatief makkelijk op te zetten.

Stap 1: Maak een bot aan (als je al een bot hebt, kan je deze stap overslaan)

Het aanmaken van een Telegram bot gaat via de Botfather. Open een nieuwe chat met de @Botfather account:

Open een chat met de Botfather-bot

Type vervolgens het /newbot commando in, en volg de stappen op het scherm. Als het goed is krijg je vervolgens een succes-melding, met daarin een API code die je kunt gebruiken om via HTTP met je Bot te praten.

Bot succesvol aangemaakt

 Stap 2: Home Assistant configureren

Nu je een bot hebt, kun je Home Assistant configureren om te werken met Telegram.

Mocht je al wel een bot hebben, maar je API code niet weten:

  • Open een chat met de @Botfather;
  • Type het /mybots commando en kies je bot;
  • Kies de ‘API Token’ optie’.

Voeg de onderstaande code toe aan je configuration.yaml om de communicatie tussen Home Assistant en Telegram op te zetten:
notify:
- name: NotifyTelegram
platform: telegram
api_key: <bot_api_key>
chat_id: <chat_id>

Vul bij <bot_api_key> de API key van de bot in. Om achter je <chat_id> te komen, navigeer dan naar de volgende URL (vervang <bot_api_key> door je eigen bot key): https://api.telegram.org/bot<bot_api_key>/getUpdates

Herstart Home Assistant om de wijziging in effect te laten gaan.

Stap 3: Notificaties!

Het triggeren van een notificatie kan op meerdere manieren. Bijvoorbeeld een melding wanneer er een nieuw apparaat met je WiFi verbindt. Uitgaande hierbij dat je al een presence detection hebt toegevoegd om dit te kunnen detecteren (bijvoorbeeld via ASUSWRT). Voeg de volgende automation toe aan je configuratie:
automation:
- alias: "New Device Detected"
trigger:
platform: event
event_type: 'device_tracker_new_device'
action:
service: notify.NotifyTelegram
data:
message: "Nieuw apparaat gedetecteerd!"

Als er nu een apparaat verbindt met je WiFi netwerk wat niet in je known_devices.yaml staat, dan krijg je daar een melding van via je Telegram bot!

Eureka!!

En voilà, je hebt Home Assistant geconfigureerd om te werken met Telegram notificaties!