Bonjour à tous,
je vous présente mon intégration externe FF-Agent pour Gladys Assistant. Elle permet de recevoir les alertes FF-Agent dans Gladys, de les afficher sur le tableau de bord et de les utiliser comme déclencheurs de scènes. De plus, vous pouvez envoyer directement depuis Gladys une acceptation ou un refus à FF-Agent.
L’intégration est disponible publiquement et a déjà été testée en production.
Que fait l’intégration?
L’intégration relie deux domaines:
- Alertes entrantes: FF-Agent envoie une alerte à Gladys. Celle-ci apparaît sur le tableau de bord et peut déclencher des scènes.
- Retours personnels: Via le widget ou une action de scène, vous pouvez informer FF-Agent si vous acceptez ou refusez.
L’interface et la documentation sont disponibles en allemand, anglais et français.
À quoi cela peut-il servir?
Le cas d’utilisation le plus important est de faire réagir votre domicile de manière appropriée en cas d’alerte. Par exemple, avec une scène Gladys:
- allumer la lumière dans la chambre, le couloir ou l’entrée la nuit;
- émettre une notification supplémentaire ou un rappel via les fonctionnalités Gladys déjà configurées;
- allumer des appareils sélectionnés ou lancer une scène existante;
- afficher l’alerte sur une tablette murale dans le tableau de bord Gladys.
Les appareils et actions utilisés dépendent bien sûr de votre installation Gladys. L’intégration fournit le déclencheur d’alerte; vous définissez vous-même la réaction souhaitée dans vos scènes.
Les retours peuvent également être intégrés dans des scènes, par exemple pour un bouton actionné consciemment. Une acceptation ou un refus automatique n’est pas nécessaire pour l’utilisation.
Le widget du tableau de bord
Le widget indique si une alerte reçue localement est en cours. En cas d’alerte, l’heure de réception et deux boutons apparaissent:
- Accepter
- Refuser
Le retour est envoyé immédiatement au clic, sans demande de confirmation supplémentaire.
Après une acceptation transmise avec succès, l’affichage vert reste jusqu’à ce que vous sélectionniez „Mission terminée“. Ce bouton met fin uniquement à l’affichage local dans Gladys – il n’envoie aucune autre requête et ne termine aucune mission dans FF-Agent.
Après un refus transmis avec succès, le widget revient directement à l’état de repos. La dernière décision envoyée et son heure restent visibles, donc „Acceptation envoyée“ ou „Refus envoyé“. Les heures apparaissent dans le fuseau horaire local de votre navigateur.
Une nouvelle alerte entrante ouvre à nouveau l’affichage de l’alerte. L’état d’alerte et le dernier retour sont conservés uniquement en mémoire vive et sont perdus lors d’un redémarrage de l’intégration.
Comment fonctionne la réception des alertes?
Pour les alertes entrantes, l’intégration utilise un webhook via Gladys Plus:
- FF-Agent envoie un HTTP-POST à l’URL personnelle du webhook lors d’une alerte.
- Gladys Plus transmet le signal à votre instance Gladys.
- L’intégration met à jour le widget et déclenche le déclencheur de scène „Mission reçue“.
Consciemment sans détails de mission
L’intégration traite exclusivement le signal d’alerte. Le contenu du webhook est ignoré. Aucun mot-clé de mission, adresse, ID de mission ou autre détail de mission n’est stocké ou transmis aux scènes.
Le déclencheur de scène contient uniquement l’heure de réception générée localement. Il n’y a donc pas de filtrage par type de mission ou d’évaluations similaires.
Comment fonctionnent les acceptations et les refus?
Les retours utilisent les liens web personnels FF-Agent de:
FF-Agent → Profil personnel → „Liens web pour les messages de mission“
Dans Gladys, vous n’avez besoin que de votre UUID de retour, pas du lien complet.
Pour les acceptations, vous pouvez sélectionner un mode de trajet standard:
- Voiture
- Vélo
- À pied
Les coordonnées transmises proviennent de la maison Gladys sélectionnée. Il ne s’agit donc pas d’une localisation en direct de votre smartphone. Lors d’une acceptation via une action de scène, le mode de trajet peut être facultativement écrasé pour cet appel unique.
Les refus nécessitent uniquement l’UUID de retour. Aucune des deux réponses ne nécessite de saisir un ID de mission.
Tester et notes importantes
Vous pouvez également tester le widget sans webhook FF-Agent entrant via „Simuler une mission“.
Important: Une simulation n’est pas un mode de test protégé. Elle déclenche le même déclencheur de scène qu’une alerte réelle. Les boutons de retour et les actions d’acceptation/refus intégrées envoient également des requêtes réelles à FF-Agent. Vérifiez donc vos scènes avant un test.
Je me réjouis des retours, des expériences et des suggestions d’amélioration – en particulier de la part d’autres utilisateurs de FF-Agent qui souhaitent connecter leurs alertes à Gladys et à leur domicile intelligent.