Notification Telegram pour HA

Bonjour !

Telegram est populaire parmi les personnes soucieuses de la protection de leur vie privée et qui souhaitent disposer d'une application de messagerie sécurisée. Elle compte plus de 500 millions d'utilisateurs actifs dans le monde. Telegram est largement reconnu comme un canal sécurisé pour les communications en ligne.

Nous pouvons utiliser des bots Telegram pour envoyer et recevoir des messages ou des commandes vers/depuis Home Assistant.

• Créez un bot dans Telegram pour les notifications de Home Assistant. Pour cela, nous utilisons le bot officiel de Telegram "@BotFather". Recherchez "@BotFather" dans Telegram et utilisez la commande "/newbot" dans le menu de sélection pour créer votre robot. Le bot vous guidera pas à pas - vous devrez d'abord choisir un nom pour votre bot et ensuite un nom d'utilisateur.

Ici, j'utilise :

⇒ Nom du bot : "Door Open Alert ⚠️"

⇒ Nom d'utilisateur du bot : "bibinmadhavan_bot"

(Le nom du bot et le nom d'utilisateur sont deux choses différentes. Le nom du bot sera le nom du chat apparaissant sur votre télégramme. Contrairement au nom du bot, votre nom d'utilisateur doit toujours se terminer par le mot "bot")

• Une fois votre robot créé, BoatFather vous fournira un jeton API et un lien pour votre chatbot nouvellement créé. Cliquez sur le lien du chatbot et activez votre bot en appuyant sur start.

• Ensuite, nous devons collecter l'identifiant de chat du télégramme. L'ID de Chat est utilisé par le bot de Telegram pour envoyer des messages directs. Pour obtenir votre ID de chat, envoyez un message direct au bot "Get My ID" (recherchez-le comme vous l'avez fait pour BotFather) et le bot vous répondra immédiatement avec votre ID d'utilisateur et votre ID de chat (les deux valeurs sont les mêmes, vous pouvez donc utiliser n'importe laquelle d'entre elles). Vous pouvez également utiliser "GetIDs Bot", qui vous donnera tous les détails de votre bot, et pas seulement l'ID.

• Allez dans le fichier "configuration.yaml" de home-assistant et ajoutez les lignes de code suivantes.

                
                  telegram_bot:
                    - platform: polling
                      api_key: "xxxxxxxxxxxxxxxxxx"    # APIfrom “BotFather”
                      allowed_chat_ids:
                        - 1123456                      # Chat ID from “Get My ID”
                
              

(Note : Clé API de "BotFather" et Chat ID de "Get My ID".)

Cela permettra d'intégrer le service de robots de Telegram dans HA.

• Ensuite, nous devons créer un service de notification pour le télégramme, et pour cela ajouter le morceau de code suivant au fichier "configuration.yaml".

                notify:
                  - platform: telegram
                    name: "bibin"           # Use any name you want
                    chat_id: 123456

              

• Redémarrer Home Assistant

Si vous avez tout fait correctement, vous pouvez voir un nouveau service de notification "notify.any_name" sous Developer Tools → Services.

Nous devons maintenant vérifier si le service de notify fonctionne ou non.

• Allez dans Developer Tools → Services et sélectionnez "notify.bibin" (utilisez le nom du service que vous avez choisi pour créer le service de notification).
• Tapez votre message et cliquez sur "CALL SERVICE".

Pour plus d'un utilisateur :

Si vous souhaitez inclure d'autres personnes de la famille, il vous suffit d'ajouter leurs identifiants de chat Telegram aux sections "telegram_bot :" et "notify :" du fichier configuration.yaml.

• Partagez le lien du bot précédemment créé (obtenu à partir de BotFather ou directement à partir du chat lui-même) avec le membre de la famille que vous souhaitez ajouter. Demandez-lui d'utiliser le lien pour démarrer le chatbot sur son appareil.

• Collecter les identifiants de chat pour les utilisateurs individuels à partir du bot "Get My ID" sur leurs appareils, comme nous l'avons fait précédemment.
• Enfin, ajoutez les identifiants des utilisateurs au fichier configuration.yaml.

Vous pouvez vérifier le service créé pour la deuxième personne de la même manière que précédemment, sous Outils de développement → Services.

Notofocation du groupe :

Ce que nous avons fait ici est de donner à chacun un nouveau service de notification, ce qui n'est pas pratique si vous voulez créer un automatisme pour les notifier tous en même temps puisque nous avons besoin d'appeler plusieurs services de notification. Dans de tels scénarios, nous pouvons utiliser les "groupes de notification". Nous pouvons combiner plusieurs services de notification en un seul service en utilisant les "Notify Groups".

• Ajoutez le code suivant pour créer un groupe de notification dans le fichier "configuration.yaml" sous l'en-tête "notify :".
• Recharger toute la configuration yaml de HA à partir de l'onglet service. (Il est recommandé de redémarrer HA)

                notify:
                  - name: "Family Group"
                  platform: group
                  services:
                    - service: notify.bibin      # 1st notify service
                    - service: notify.office     # 2nd notify service

              

Voilà, c'est fait. Vous pouvez maintenant utiliser le service "notify.family_group" pour envoyer des notifications Telegram à tous les utilisateurs en même temps.