Intégration domotique IFTTT, gratuite et open source

Connecteur non officiel : déclenchez des applets IFTTT depuis les scènes, et l'inverse (Plus).

• Publiée par LM1LC3N7
• Appareils
• Version 0.1.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations externes

Connecteur non officiel, sans lien avec IFTTT. Il relie les scènes de Gladys au service Webhooks d'IFTTT : une scène peut déclencher n'importe quel applet à l'écoute d'un nom d'événement et, avec Gladys Plus, un applet peut lancer une scène Gladys. IFTTT est une marque d'IFTTT Inc.

Ce que vous obtenez

Surface	Contenu
Action de scène Déclencher un événement IFTTT	nom d'événement + value1, value2, value3 (les ingrédients de l'applet)
Action de scène Déclencher un événement IFTTT (JSON)	nom d'événement + un objet JSON (l'ingrédient « JSON payload » de l'applet)
Déclencheur de scène Événement IFTTT reçu	se déclenche quand un applet (ou tout client HTTP) appelle le webhook entrant relayé par Gladys Plus, avec le nom de l'événement, value1..3 et les autres champs
Widget Bouton IFTTT	un bouton qui déclenche un événement, avec confirmation facultative
Bouton Envoyer un événement de test	vérifie la clé et affiche l'URL entrante

Rien ne tourne en arrière-plan : l'intégration ne parle à IFTTT que quand une scène, un bouton ou un webhook le lui demande.

Installation

1. Sur ifttt.com/maker_webhooks, cliquez sur Documentation : la page affiche votre clé (« Your key is: ... »).
2. Installez l'intégration, collez la clé dans Clé Webhooks IFTTT, enregistrez, puis cliquez sur Envoyer un événement de test.
3. Dans IFTTT, créez un applet dont le If This est Webhooks → Receive a web request avec le nom d'événement de votre choix (lettres, chiffres et tirets bas, par exemple cafe_on), et le Then That que vous voulez.
4. Dans une scène Gladys, ajoutez l'action Déclencher un événement IFTTT avec ce nom. value1, value2 et value3 acceptent les variables de scène ({{device.salon.temperature}}).

Un compte IFTTT gratuit limite le nombre d'applets ; le service Webhooks lui-même ne limite pas le nombre d'événements.

D'IFTTT vers Gladys (Gladys Plus)

Une Gladys à la maison n'est pas joignable depuis Internet : Gladys Plus relaie les requêtes entrantes.

1. Liez Gladys Plus, ouvrez l'intégration et collez votre clé Open API dans le bloc Webhooks Gladys Plus : Gladys affiche l'URL publique du webhook « Événements IFTTT entrants » (le bouton Envoyer un événement de test la répète).

2. Dans IFTTT, créez un applet avec l'action Webhooks → Make a web request : URL = cette URL, méthode POST, content type application/json, corps :

   { "event": "depart_maison", "value1": "{{OccurredAt}}" }

   Toute autre clé du corps est relayée dans la variable payload (en JSON). Un GET avec ?event=depart_maison&value1=... fonctionne aussi.

3. Dans Gladys, créez une scène avec le déclencheur Événement IFTTT reçu et le nom de l'événement comme filtre (laissez vide pour réagir à tous). Les variables {{triggerEvent.data.value1}}, etc. sont disponibles dans les actions suivantes.

L'URL est un secret. Pour une vérification supplémentaire, renseignez un secret partagé dans la configuration et ajoutez "secret": "<valeur>" au corps envoyé par IFTTT : les requêtes sans lui sont ignorées.

Tableau de bord

Le widget Bouton IFTTT affiche un titre, une légende et un bouton qui déclenche l'événement de ses réglages (avec une value1 facultative). Cochez Demander une confirmation pour une action à conséquences.

Dépannage

• « IFTTT a refusé la clé Webhooks » : la clé est fausse ou révoquée ; recopiez-la depuis la page Documentation du service Webhooks.
• L'applet ne s'exécute pas : le nom d'événement doit être exactement celui saisi dans l'applet (sensible à la casse) ; vérifiez l'activité de l'applet sur IFTTT.
• « Les événements entrants nécessitent Gladys Plus » : sans Plus, le sens sortant fonctionne toujours ; seul le déclencheur a besoin du relais.
• Logs : le niveau de log de l'intégration se règle avec la variable LOG_LEVEL (debug montre chaque appel).

Confidentialité

L'intégration n'envoie à IFTTT que ce que vos scènes mettent dans les événements. La clé est stockée chiffrée par Gladys et ne quitte jamais votre instance, sauf pour joindre maker.ifttt.com.

Paramètres de configuration

Voici les paramètres demandés par IFTTT dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Webhooks IFTTT	section	Non	Connecteur non officiel, sans lien avec IFTTT. Vos scènes peuvent déclencher n'importe quel applet IFTTT dont le « If This » est le service Webhooks (nom d'événement + jusqu'à trois valeurs, ou une charge JSON), et, avec Gladys Plus, un applet IFTTT peut lancer une scène Gladys via le webhook entrant ci-dessous. Créez un applet avec le déclencheur Webhooks « Receive a web request » et copiez votre clé depuis la page des réglages Webhooks.
Clé Webhooks IFTTT	secret	Oui	La clé affichée après « Your key is: » sur la page des réglages Webhooks (ou la fin de l'URL après /use/). Stockée chiffrée par Gladys.
D'IFTTT vers Gladys (Gladys Plus)	section	Non	Pour lancer une scène Gladys depuis IFTTT, liez Gladys Plus et collez votre clé Open API dans le bloc « Webhooks Gladys Plus » : Gladys affiche alors l'URL publique à utiliser dans un applet IFTTT avec l'action « Webhooks: Make a web request » (POST, Content Type application/json, corps {"event": "mon_evenement", "value1": "..."}). Vos scènes utilisent ensuite le déclencheur « Événement IFTTT reçu ». L'URL est un secret : ajoutez le secret partagé facultatif ci-dessous pour refuser les requêtes qui ne le portent pas.
Secret partagé des requêtes entrantes (facultatif)	secret	Non	Si renseigné, une requête entrante n'est acceptée que si son corps JSON, son formulaire ou sa chaîne de requête porte « secret » avec cette valeur.

Comment installer IFTTT dans Gladys

1. Dans Gladys, ouvrez Intégrations : IFTTT apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/lm1lc3n7/gladys-ifttt:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-ifttt.

IFTTT nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

IFTTT est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations externes
• Découvrir les intégrations natives intégrées à Gladys
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂