Aller au contenu principal

Intégration domotique Meeting status, gratuite et open source

Intégration Meeting status pour Gladys Assistant

Statut « en réunion » Teams (Microsoft Graph) et Zoom, pour un voyant devant le bureau.

Gladys lit, environ une fois par minute, si vous êtes en réunion ou en appel, dans Microsoft Teams (par Microsoft Graph) et dans Zoom, pour qu’une scène allume un voyant devant votre bureau. Lecture seule : rien n’est modifié sur vos comptes.

Intégration non officielle, sans lien avec Microsoft ni Zoom. Jamais testée avec un vrai appareil ni un vrai compte : testée sur des réponses calquées sur les documentations officielles.

Ce que vous obtenez​

Un appareil Gladys, Statut en réunion (onglet Découverte, dès qu’un service est autorisé), en lecture seule :

FonctionValeur
En réunion (Teams ou Zoom)1 quand l’un des services le dit ; 0 quand tous les services autorisés disent non
En réunion Teams1 / 0
Présence Teamsles codes de Microsoft Graph, availability / activity (Busy / InAMeeting)
En réunion Zoom1 / 0
Présence Zoomle code de Zoom (In_A_Zoom_Meeting, Do_Not_Disturb…)

« En réunion » : une réunion, un appel ou une présentation (Teams InAMeeting, InACall, InAConferenceCall, Presenting ; Zoom In_A_Zoom_Meeting, On_A_Call, Presenting…). Avec l’option Aussi occupé et ne pas déranger, Occupé, Ne pas déranger et les événements d’agenda Zoom comptent aussi.

Aucune valeur n’est inventée : une présence absente de la documentation (PresenceUnknown, une nouvelle valeur), ou un service qui n’a pas pu être lu depuis plus de 3 intervalles (3 minutes au moins), est inconnue et rien n’est publié. Gladys n’a pas de valeur « inconnue » : la dernière valeur reste affichée ; lisez l’état de l’intégration (ou les textes « Présence Teams » / « Présence Zoom » et leur date) avant de vous fier au voyant. « En réunion (Teams ou Zoom) » ne passe à 0 que si tous les services autorisés ont été lus récemment et disent non : un service dont la session a pris fin (renouvellement refusé) compte comme inconnu jusqu’à un nouveau Connecter ou jusqu’à ce que ses clés soient vidées.

Non couverts : les comptes Microsoft personnels (Microsoft Graph n’a pas de présence pour eux : comptes professionnels ou scolaires seulement), Microsoft Teams gratuit, Google Meet (pas d’API de présence), la présence d’autres personnes.

1. Microsoft Teams (compte professionnel ou scolaire)​

  1. Ouvrez le centre d’administration Microsoft Entra, Inscriptions d’applications, Nouvelle inscription : comptes d’un annuaire d’organisation.
  2. Plateforme Web, URI de redirection : cliquez une fois sur Connecter sur le compte Microsoft de la configuration de l’intégration ; l’état en haut de la page affiche alors l’adresse à déclarer (en général https://my.gladysassistant.com/redirect/oauth). Ou donnez une adresse à vous et remplissez URL de redirection (voir « Votre propre URL de redirection »).
  3. Autorisations d’API : Microsoft Graph, Déléguées : Presence.Read et offline_access. Votre organisation peut exiger le consentement d’un administrateur.
  4. Certificats et secrets : un nouveau secret client. Notez sa date de fin : à cette date, le renouvellement est refusé et il faut en créer un nouveau, l’enregistrer et cliquer de nouveau sur Connecter.
  5. Copiez l’ID d’application (client) et la valeur du secret dans la configuration. Tenant : laissez organizations, ou donnez l’ID ou le domaine de votre tenant (contoso.com). common et consumers sont refusés (les comptes personnels n’ont pas de présence).
  6. Enregistrez, cliquez sur Connecter et connectez-vous sur la page de Microsoft.

2. Zoom​

  1. Sur le Zoom App Marketplace, Develop, Build App : une General app, gérée par l’utilisateur (user-managed).
  2. OAuth redirect URL et allow list : l’adresse affichée dans l’état après un premier clic sur Connecter (en général https://my.gladysassistant.com/redirect/oauth), ou la vôtre.
  3. Scopes : user:read:presence_status (sur une ancienne application à scopes classiques : user:read), rien d’autre.
  4. Copiez le Client ID et le Client Secret dans la configuration, enregistrez, cliquez sur Connecter, autorisez l’application sur la page de Zoom.

Ne remplissez que les services que vous utilisez : un service vide n’est jamais lu.

Votre propre URL de redirection​

Si l’URL de redirection de vos applications n’est pas celle de Gladys, saisissez-la dans URL de redirection. Après la page de Microsoft ou de Zoom, copiez l’adresse complète sur laquelle le navigateur s’est arrêté (avec code= et state=) et collez-la dans Terminer l’autorisation, dans les 15 minutes. L’adresse doit être l’URL de redirection donnée ; une autorisation ne sert qu’une fois.

Lectures, pauses et arrêts​

  • Une lecture par service et par intervalle (60 s par défaut, une minute au moins), quoi qui la lance : bouton Tester, configuration enregistrée, reconnexion de Gladys, redémarrage (l’heure de la dernière lecture est gardée dans /data).
  • 429 (trop de requêtes) : pause aussi longue que le service le demande (Retry-After, entre 1 minute et 6 heures ; 5 minutes sans lui). 5xx : nouvel essai après 2, 5, 15 puis 30 minutes. Autres erreurs : jamais plus tôt que l’intervalle, puis 2, 5, 15, 30 minutes. Les pauses survivent à un redémarrage.
  • 403 sur la présence (ou code Zoom 5411) : la permission ou le type de compte est refusé ; nouvel essai après une heure, ou dès un nouveau Connecter.
  • Au plus 2 000 requêtes par service et par jour UTC (un filet de sécurité ; le rythme normal est d’environ 1 500).
  • Renouvellement refusé (secret arrivé à sa fin, accès révoqué, jeton de renouvellement expiré) : le service s’arrête jusqu’à un nouveau clic sur Connecter ; rien n’est réessayé de lui-même, y compris après un redémarrage.
  • Accès refusé avec un nouveau jeton : le service s’arrête ; Tester essaie une fois (pas plus tôt que l’intervalle), ou cliquez de nouveau sur Connecter.
  • Une réponse d’erreur sans code d’erreur OAuth (une page de proxy, un pare-feu) n’est jamais prise pour un refus : elle est réessayée plus tard.

Vie privée et secrets​

  • Votre mot de passe se saisit sur la page de Microsoft ou de Zoom seulement.
  • Les secrets client sont gardés par Gladys dans sa base, jamais réaffichés, envoyés seulement au service qui les a émis.
  • Les jetons d’accès et de renouvellement sont gardés par Gladys dans sa base (dans la configuration de l’intégration, jamais affichés à l’écran), envoyés seulement au service qui les a émis, absents de /data, des journaux et des messages d’état. /data ne garde que des dates, des pauses et des arrêts. Une version qui les gardait dans /data les déplace vers Gladys au démarrage, puis les retire de /data. Si Gladys ne peut pas garder de nouveaux jetons, l’intégration le note dans les journaux et réessaie à chaque lecture ; un redémarrage avant cela peut demander un nouveau Connecter (les jetons de renouvellement de Zoom et de Microsoft ne servent qu’une fois).
  • La présence est gardée en mémoire seulement, ni dans /data ni dans les journaux. « En réunion » garde son historique dans Gladys (désactivable par fonction) ; les textes de présence n’en ont pas.
  • L’autorisation utilise PKCE (S256) et un state qui ne sert qu’une fois, pendant 15 minutes.

Dépannage​

  • AADSTS50020 / compte personnel : utilisez un compte professionnel ou scolaire ; les comptes personnels n’ont pas de présence.
  • AADSTS65001 / consentement : un administrateur doit consentir à Presence.Read pour votre organisation.
  • invalid_client : le secret client est faux ou arrivé à sa fin.
  • Zoom 5411 : il manque le scope user:read:presence_status à l’application.
  • La documentation de Zoom signale qu’un utilisateur connecté sur mobile seulement peut apparaître Offline.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
FonctionnementsectionNonGladys lit, environ une fois par minute, si vous êtes en réunion ou en appel : dans Microsoft Teams par Microsoft Graph (compte professionnel ou scolaire seulement : un compte Microsoft personnel n’a pas de présence), et dans Zoom. Un appareil Gladys (onglet Découverte) : « En réunion (Teams ou Zoom) », un par service, et le texte de présence ; utilisez-le dans une scène pour allumer un voyant devant votre bureau. Chaque service demande une application que vous déclarez vous-même (OAuth2) : remplissez seulement les services que vous utilisez. Votre mot de passe se saisit sur la page de Microsoft ou de Zoom seulement. Lecture seule, rien n’est modifié sur vos comptes. Jamais testée avec un vrai compte. Intégration non officielle, sans lien avec Microsoft ni Zoom.
1. Microsoft TeamssectionNonDans le centre d’administration Microsoft Entra, Inscriptions d’applications, Nouvelle inscription : comptes d’un annuaire d’organisation ; plateforme Web, URI de redirection : l’adresse de retour de ce Gladys (cliquez une fois sur Connecter plus bas, l’état en haut de cette page l’affiche alors ; en https), ou une adresse à vous avec « URL de redirection » plus bas. Autorisations d’API : Microsoft Graph, déléguées, Presence.Read et offline_access (votre administrateur devra peut-être consentir). Certificats et secrets : un nouveau secret client (notez sa date de fin : renouvelez-le avant). Copiez l’ID d’application (client) et la valeur du secret ci-dessous, enregistrez, puis cliquez sur Connecter.
Microsoft : ID d’application (client)stringNonVide : Teams n’est pas lu.
Microsoft : secret client (valeur)secretNonLa valeur du secret client de votre application. Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Microsoft.
Microsoft : tenantstringNonorganizations (tout compte professionnel ou scolaire), ou l’ID ou le domaine de votre tenant (contoso.com). Les comptes personnels (common, consumers) n’ont pas de présence : refusés.
Compte Microsoftoauth2NonOuvre la page de connexion Microsoft (enregistrez d’abord l’ID et le secret).
2. ZoomsectionNonSur le Zoom App Marketplace, Develop, Build App : une application General, gérée par l’utilisateur (user-managed). OAuth redirect URL et allow list : l’adresse de retour de ce Gladys (affichée dans l’état après un premier clic sur Connecter plus bas), ou une adresse à vous avec « URL de redirection ». Scopes : user:read:presence_status (ou user:read sur une ancienne application), rien d’autre. Copiez le Client ID et le Client Secret ci-dessous, enregistrez, puis cliquez sur Connecter.
Zoom : Client IDstringNonVide : Zoom n’est pas lu.
Zoom : Client SecretsecretNonLe Client Secret de votre application Zoom. Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Zoom.
Compte Zoomoauth2NonOuvre la page d’autorisation de Zoom (enregistrez d’abord le Client ID et le Secret).
3. OptionssectionNonLe service vous renvoie vers Gladys et l’intégration lit votre présence. Si l’URL de redirection de votre application n’est pas ce Gladys, saisissez-la dans « URL de redirection » : à la fin, copiez l’adresse complète affichée par le navigateur (elle contient code= et state=) et collez-la dans « Terminer l’autorisation » plus bas, dans les 15 minutes. Les jetons sont gardés par Gladys dans sa base (jamais affichés, jamais dans /data), envoyés seulement au service qui les a émis, jamais dans les journaux.
URL de redirection (facultative)stringNonVide : les services vous renvoient vers ce Gladys. Sinon, l’URL de redirection de vos applications (https, ou http sur localhost seulement) : terminez en collant l’adresse sur laquelle le navigateur s’est arrêté.
Compte comme « en réunion »selectNon
Intervalle de lecture (secondes)numberNonUne lecture par service et par intervalle, une minute au moins, quoi qui la lance (bouton de test, configuration enregistrée, reconnexion de Gladys, redémarrage).
Langue des nomsselectNon

Comment installer Meeting status dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Meeting status 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-meeting-status: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-meeting-status.

Meeting status 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​

Meeting status 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.

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 🙂