Home Assistant + Telegram : alertes et contrôle à distance depuis son téléphone

Chaque matin à 7h30, je reçois un message Telegram de mon homelab : consommation électrique de la nuit, état du chauffage, température extérieure. À la fin d’un cycle de machine à laver, une notification me le rappelle. Ces deux automatisations m’ont prouvé que Home Assistant + Telegram n’est pas un gadget — c’est un assistant qui fait vraiment gagner du temps.

Pourquoi Telegram

Home Assistant supporte des dizaines de canaux de notification : email, push natif, Slack, Discord, SMS… Telegram est mon choix pour ces raisons :

• Gratuit, sans limitations
• Bots Telegram : tu peux créer un bot privé qui envoie des messages ET reçoit des commandes. Bidirectionnel.
• Boutons inline : dans HA, tu peux envoyer des notifications avec des boutons cliquables — « Ouvrir les volets » dans la notification elle-même
• Fonctionne sans VPN : les notifications arrivent depuis le cloud Telegram, pas besoin d’accès à ton homelab
• Uptime Kuma aussi : un seul bot pour toutes tes alertes homelab

Créer un bot Telegram

Ouvre Telegram et cherche @BotFather. C’est le bot officiel Telegram (le service qui permet de créer et gérer des bots) pour créer des bots.

/newbot
→ Choisir un nom : "MaxHomelab"
→ Choisir un username : maxhomelab_bot
→ BotFather répond avec le TOKEN API : 1234567890:ABCdefGHIjklMNOpqrstUVWxyz

Note ce token — il te servira dans la configuration HA.

Obtenir ton chat_id

Envoie un message à ton bot (cherche-le par son username dans Telegram). Puis, dans un navigateur :

https://api.telegram.org/bot<TOKEN>/getUpdates

La réponse JSON contient ton chat.id (identifiant numérique unique de ta conversation avec le bot) — note-le.

Configuration dans Home Assistant

Ajouter Telegram à configuration.yaml

telegram_bot:
  - platform: polling   # polling = HA interroge Telegram régulièrement (plus simple que webhook pour un homelab)
    api_key: "1234567890:ABCdefGHIjklMNOpqrstUVWxyz"
    allowed_chat_ids:
      - 123456789   # ton chat_id personnel

notify:
  - name: telegram_maxime
    platform: telegram
    chat_id: 123456789

Redémarre Home Assistant. Tu peux maintenant envoyer des messages depuis les automatisations.

Notifications de base

alias: "Notification test"
trigger: []
action:
  - service: notify.telegram_maxime
    data:
      message: "Home Assistant fonctionne correctement !"
      title: "Test"

Notification avec photo

- service: notify.telegram_maxime
  data:
    message: "Mouvement détecté — jardin"
    data:
      photo:
        - url: "http://192.168.10.50/snapshot.jpg"
          caption: "Caméra jardin — {{ now().strftime('%H:%M') }}"

Notifications utiles que j’utilise

Résumé matinal

alias: "Résumé matin 8h"
trigger:
  - platform: time
    at: "08:00:00"
action:
  - service: notify.telegram_maxime
    data:
      message: |
        ? **Bonjour !**
        ? Salon : {{ states('sensor.temperature_salon') }}°C
        ⚡ Conso nuit : {{ states('sensor.energie_nuit') }} kWh
        ? Tesla : {{ states('sensor.tesla_battery_level') }}%
        ? Météo : {{ states('weather.maison') }}

Alerte porte de garage ouverte depuis 10 min

alias: "Garage ouvert alerte"
trigger:
  - platform: state
    entity_id: binary_sensor.porte_garage
    to: "on"
    for: "00:10:00"
action:
  - service: notify.telegram_maxime
    data:
      message: "⚠️ La porte de garage est ouverte depuis 10 minutes !"

Contrôle à distance avec les boutons inline

C’est la fonctionnalité la plus puissante. Tu peux envoyer une notification avec des boutons d’action qui déclenchent des scripts HA :

alias: "Notification avec action"
action:
  - service: notify.telegram_maxime
    data:
      message: "Tu n'as pas fermé les volets. Fermer maintenant ?"
      data:
        inline_keyboard:
          - - text: "✅ Fermer les volets"
              callback_data: "/fermer_volets"
            - text: "❌ Laisser ouverts"
              callback_data: "/ignorer"

Dans HA, écoute les callbacks Telegram :

alias: "Telegram - Callback fermer volets"
trigger:
  - platform: event
    event_type: telegram_callback
    event_data:
      data: "/fermer_volets"
action:
  - service: script.volets_mode_depart
  - service: telegram_bot.answer_callback_query
    data:
      callback_query_id: "{{ trigger.event.data.id }}"
      message: "Volets fermés ✅"

Commandes depuis Telegram

Tu peux aussi envoyer des commandes texte au bot pour contrôler HA :

alias: "Telegram commande /status"
trigger:
  - platform: event
    event_type: telegram_text
    event_data:
      text: "/status"
action:
  - service: notify.telegram_maxime
    data:
      message: |
        ? Status homelab :
        • HA : {{ states('sensor.ha_uptime') }}
        • Tesla : {{ states('sensor.tesla_state') }}
        • Alarme : {{ states('alarm_control_panel.maison') }}

Audits automatiques par thématique

Au-delà des alertes événementielles, j’ai mis en place des audits quotidiens programmés par thématique : chaque jour de la semaine déclenche une vérification différente du homelab. Un rapport Telegram arrive chaque matin avec exactement les métriques du jour — rien de plus, rien de moins.

Mon calendrier d’audits

Lundi     → Backups : dernier backup PBS, état des snapshots
Mardi     → Réseau : uptime services, expiration SSL, latence DNS
Mercredi  → Énergie : conso hebdo, production solaire, coût estimé
Jeudi     → Proxmox : RAM / CPU / stockage de chaque nœud
Vendredi  → Médias : espace Plex, files Sonarr/Radarr en attente
Samedi    → Batteries : état de toutes les piles Zigbee
Dimanche  → Sécurité : dernières connexions HA, alertes manquées

Exemple : audit piles Zigbee le samedi matin

J’ai une cinquantaine de capteurs Zigbee dans la maison — détecteurs de mouvement, capteurs de porte, température, vibration. Suivre manuellement leur niveau de batterie dans l’interface HA est une corvée. L’audit Telegram du samedi règle ça :

alias: "Audit Samedi — Batteries Zigbee"
trigger:
  - platform: time
    at: "09:00:00"
condition:
  - condition: time
    weekday:
      - sat
action:
  - variables:
      batteries_faibles: >
        {% set ns = namespace(liste=[]) %}
        {% for entity in states.sensor
           if 'battery' in entity.entity_id
           and entity.state not in ['unavailable','unknown']
           and entity.state | int < 20 %}
          {% set ns.liste = ns.liste + [entity.name ~ ' : ' ~ entity.state ~ '%'] %}
        {% endfor %}
        {{ ns.liste | join('
• ') }}
  - service: notify.telegram_maxime
    data:
      message: |
        🔋 **Audit batteries — {{ now().strftime('%d/%m/%Y') }}**

        {% if batteries_faibles %}
        ⚠️ Capteurs à remplacer :
        • {{ batteries_faibles }}
        {% else %}
        ✅ Toutes les batteries sont au-dessus de 20 %
        {% endif %}

Le samedi matin, Telegram m’envoie la liste exacte des capteurs sous 20 %. Pas besoin d’ouvrir l’interface — j’ai l’info avant le café.

Audit backups PBS le lundi

alias: "Audit Lundi — Backups PBS"
trigger:
  - platform: time
    at: "08:00:00"
condition:
  - condition: time
    weekday:
      - mon
action:
  - service: notify.telegram_maxime
    data:
      message: |
        💾 **Audit backups — {{ now().strftime('%d/%m/%Y') }}**

        Dernier backup : {{ states('sensor.pbs_last_backup') }}
        Espace utilisé : {{ states('sensor.pbs_storage_used') }} GB
        Snapshots actifs : {{ states('sensor.pbs_snapshot_count') }}

        {% if states('sensor.pbs_last_backup_status') == 'OK' %}
        ✅ Backup OK
        {% else %}
        🚨 Vérifier PBS immédiatement
        {% endif %}

Un Telegram par jour, une thématique — facile à lire, facile à agir. C’est ça la vraie valeur de HA + Telegram : pas juste des alertes, mais un système de veille qui tourne seul.

Sécuriser le bot

Le paramètre allowed_chat_ids dans la config HA limite le bot à répondre uniquement aux messages de tes chat_ids autorisés. Un inconnu qui trouve le username de ton bot ne peut pas interagir avec ton HA.

Pour les notifications critiques (alarme, intrusion), utilise un deuxième bot distinct — ça t’évite qu’une erreur de config dans le bot « quotidien » coupe aussi les alertes critiques.

? Pour aller plus loin : mes automatisations Home Assistant complètes, Uptime Kuma avec alertes Telegram, et Zigbee2MQTT pour les capteurs.

Telegram : l’interface secrète de ton homelab

L’intégration Telegram est bidirectionnelle sans ouvrir de port sur Internet. Pas de VPN requis pour envoyer une commande à HA depuis l’extérieur — le bot Telegram fait le pont.

Commence par les notifications, puis ajoute progressivement les boutons de contrôle. Et partage tes automatisations en commentaire — je suis curieux de voir ce que vous avez imaginé.

FAQ

Pour aller plus loin

• Installer Home Assistant sur Proxmox : guide complet
• Mes automatisations Home Assistant préférées
• Uptime Kuma : monitorer tout son homelab
• Beszel pour le monitoring