Automatisations Faciles avec les Webhooks et Homey Pro en utilisant Raccourcis d’Apple

Qu’est-ce qu’un Webhook ?

Un webhook est un moyen de communication permettant à une application ou un script d’envoyer des informations en temps réel à une autre application, sans que cette dernière ait besoin de solliciter constamment des mises à jour. En d’autres termes, un webhook est une requête automatisée permettant à une application de « pousser » des données vers une autre application dès qu’un événement précis se produit.

Un webhook repose sur des requêtes HTTP, ce qui le rend compatible avec de nombreuses plateformes et applications. Par exemple, lorsqu’un événement particulier se produit dans un système de domotique (tel que l’ouverture d’une porte), un webhook peut être déclenché pour initier une action précise, telle que l’allumage des lumières, l’envoi d’une notification ou l’exécution d’un scénario.

Je vous propose un exemple simple qui illustre comment un petit Raccourcis, placé dans un Mac ou dans un iPhone, peut être configuré pour envoyer une information précise à Homey Pro. Cette information, une fois reçue par Homey, sera utilisée de manière efficace pour déclencher une action spécifique ou un script bien défini dans le système de domotique.

Par exemple, vous pourriez programmer votre Raccourcis pour envoyer une notification lorsqu’une certaine condition est remplie, comme le lever du soleil ou l’arrivée d’un message. Cela permet non seulement d’automatiser des tâches quotidiennes, mais aussi d’améliorer l’interaction entre vos appareils Apple et votre environnement connecté, rendant votre expérience encore plus fluide et intuitive.

Exemple : Créer un Raccourci qui Interroge un Webhook dans Homey Pro

Voyons maintenant comment créer un raccourci avec l’application Raccourcis d’Apple, qui permettra de solliciter un webhook préalablement configuré sur Homey Pro.

Étape 1 : Création d’un Webhook dans Homey Pro

1. Configuration d’un Flow sur Homey : Connectez-vous à l’interface de Homey Pro.
2. Création d’un Flow (Scénario) : Créez un nouveau flow qui sera déclenché par l’appel à un webhook.

• Dans la section « Quand », choisissez l’option « Un webhook est reçu ».
• Donnez un nom unique à ce webhook, par exemple « allumer_lumiere ».

1. Définir les Actions du Flow : Ajoutez une action, par exemple « Allumer la lumière du salon ».

Étape 2 : Récupération de l’URL du Webhook

Après avoir configuré le flow, vous obtiendrez une URL de webhook que vous utiliserez pour solliciter Homey Pro. Cette URL aura une forme semblable à celle-ci :

https://webhook.homey.app/your_homey_id/my_event?tag=my_tag

Cette URL contient toutes les informations nécessaires pour déclencher le flow sur Homey Pro. Attention, cette URL est unique et doit rester confidentielle, afin d’éviter toute utilisation non autorisée. Notez qu’il n’existe pas de mécanisme de sécurité intégré pour un webhook.

Accès local ou au travers d’internet ?

Il existe deux syntaxes, la première pour utiliser les webhooks localement sur votre propre machine, ce qui permet un développement et un test rapides sans dépendre d’une connexion Internet, et la seconde pour les utiliser avec Internet (Cloud), ce qui facilite l’intégration d’applications à distance et la communication entre différents services en ligne.

Locale avec Homey Pro 2023:
http://mon_homey_ip/webhook?event=my_event&tag=my_tag

Au travers du Cloud avec Homey pro 2023 :
https://webhook.homey.app/your_homey_id/my_event?tag=my_tag

Étape 3 : Création d’un Raccourci sur iPhone pour Interroger le Webhook

1. Ouvrir l’Application Raccourcis : Lancez l’application Raccourcis sur votre iPhone ou iPad.
2. Créer un Nouveau Raccourci :

• Appuyez sur le bouton « + » pour créer un nouveau raccourci.

1. Ajouter l’Action HTTP :

• Dans le moteur de recherche des actions, saisissez « URL » et choisissez l’option « Obtenir le contenu de l’URL ».
• Collez l’URL du webhook Homey que vous avez récupérée précédemment. Attention, vous devez vous arrêter à /my_events?. Le reste de l’URL sera construit grâce au corps de la requête.
  

• Dans la section « Méthode », optez pour « POST », ce qui correspond à une commande permettant d’envoyer des informations vers le webhook.
• Ensuite, dans la section « Corps de la requête », cliquez sur le « + » pour ajouter une ligne. Sur la gauche, saisissez le mot « tag » et sur la droite, entrez la valeur que vous souhaitez passer à l’URL du webhook.

1. Personnaliser le Raccourci :

• Donnez un nom à votre raccourci, par exemple « Allumer Lumière Salon ».
• Vous pouvez également ajouter ce raccourci à l’écran d’accueil, le déclencher avec Siri, ou l’associer à une automatisation.

Étape 4 : Tester le Raccourci

Désormais, vous pouvez exécuter ce raccourci directement depuis l’application Raccourcis ou via Siri. Une fois activé, votre Homey Pro recevra la requête via le webhook et le flow configuré (dans notre exemple, l’allumage de la lumière du salon) s’exécutera.

Étape 5 : Construire la Logique dans Homey Pro

Dans Homey Pro, il est crucial de prendre en compte les différentes valeurs que le webhook peut recevoir. Par exemple, le webhook peut envoyer un tag tel que « allumer_le_salon » ou « eteindre_le_salon ».

Il est donc nécessaire d’analyser le contenu du tag et d’exécuter les actions ou flows appropriés en fonction de ce dernier. Pour cela, vous utiliserez une carte logique dans la section « Et ». Vous pouvez ainsi indiquer : lorsque le tag est exactement égal à « allumer_le_salon », alors exécuter le flow « allumer le salon ».

Ce principe permet de construire des automatisations sophistiquées, adaptées à différents scénarios d’usage dans votre installation domotique.

Point d’attention sur la Sécurité de l’URL de Webhook au travers d’Internet

Vous ne pouvez disposer que d’une seule URL de webhook. Si celle-ci est partagée publiquement, il ne sera pas possible de la régénérer. L’URL est constituée de l’ID de votre Home, que vous trouverez dans la section « Cloud » du menu « Général ».

Cet identifiant est unique et ne peut pas être réinitialisé. Vous ne devez en aucun cas partager cet identifiant, car une fois exposé, il pourrait permettre un accès non autorisé à vos automatisations. Assurez-vous de protéger cette information pour préserver l’intégrité de votre installation domotique.

Accessibilité des Webhooks avec Homey Pro localement et au travers d’internet :

Notez également que le service de webhook est disponible avec Homey Pro, et que l’URL est accessible aussi bien lorsque vous êtes à domicile qu’à l’extérieur. Cela offre une grande flexibilité pour contrôler vos appareils depuis n’importe où.

À titre de comparaison, sur Home Assistant, cette fonctionnalité n’est disponible qu’en souscrivant à l’abonnement « Nabu Casa », ce qui signifie que Homey Pro offre un accès plus direct et intégré, sans coût supplémentaire pour la fonctionnalité de webhook.

Un webhook est un moyen simple et efficace de permettre la communication entre différents systèmes de façon automatisée. En utilisant Homey Pro et l’application Raccourcis, il est possible de créer des automatisations intégrées entre l’écosystème Apple et votre système de domotique, facilitant ainsi les interactions entre vos appareils.

Vous pouvez étendre ces automatisations pour répondre à divers besoins de votre quotidien. C’est un bon moyen pour envoyer des informations nettes les deux écosystèmes, et le résultat est tres bon.

Je l’utilise en particulier entre mon NAS Synology et Homey. Même s’il existe une très bonne application dans le Store Homey, je remonte certaines informations et alertes par ce biais dans Homey Pro, ce qui me permet de lancer des automatisations spécifiques.

N’hésitez pas à me faire savoir si vous souhaitez des précisions sur certaines étapes ou des conseils pour d’autres scénarios.

Bonne automatisation !

HDR