Aller au contenu principal

Intégration domotique Monica, gratuite et open source

Intégration Monica pour Gladys Assistant

Anniversaires et rappels de Monica (CRM personnel) : compteurs, déclencheurs de scène, widget.

Voir sur GitHubToutes les intégrations

Les anniversaires et rappels de votre Monica (le CRM personnel libre) dans Gladys : qui fête son anniversaire aujourd'hui, qui le fête dans la semaine, quels rappels tombent aujourd'hui. Une scène peut vous envoyer un message le matin d'un anniversaire, vous prévenir une semaine avant pour le cadeau, et Gladys peut lire les anniversaires de la semaine.

Vos retours sont les bienvenus. Cette intégration a été testée contre un vrai serveur Monica 4 (image Docker officielle monica:4, octobre 2026), pas encore en usage quotidien. Si quelque chose ne marche pas comme décrit, dites-le sur le forum Gladys ou dans les issues.

Ce qu'il faut​

  • Gladys Assistant 5.1.0 ou plus récent.
  • Un Monica 4 auto-hébergé (l'image Docker monica:4 ou une installation 4.x), joignable depuis Gladys. Monica 5 (« chandler ») n'a pas encore d'API : il n'est pas pris en charge.
  • Un jeton d'accès personnel d'un utilisateur de Monica. Dans Monica : Settings → API → Personal access tokens → Create new token, donnez-lui un nom (Gladys) et copiez-le : Monica ne l'affiche qu'une fois. L'intégration ne fait que lire : elle ne modifie jamais rien dans Monica.

Configuration​

  1. Dans Gladys, Intégrations → installez Monica.
  2. Dans l'écran Configuration de l'intégration :
    • Adresse : l'adresse de Monica comme dans votre navigateur, par exemple http://192.168.1.20:8080 ou https://monica.example.org ;
    • Jeton d'accès personnel : le jeton créé plus haut ;
    • Heure des événements de scène (8 h par défaut) : moment où les anniversaires et rappels du jour déclenchent leurs scènes ;
    • Intervalle de rafraîchissement (1 heure par défaut, de 15 minutes à 6 heures) ;
    • Accepter les certificats auto-signés : seulement pour votre propre serveur en https:// avec un certificat auto-signé ;
    • Langue des noms de fonctionnalités : le français par défaut.
  3. Tester la connexion : Gladys lit Monica et indique combien d'anniversaires et de rappels il a trouvés.
  4. Dans l'onglet Découverte, ajoutez l'appareil Monica.

Monica autorise 60 requêtes par minute et par jeton. Une lecture coûte une requête par tranche de 100 contacts et de 100 rappels, plus une : très en dessous, même pour un gros carnet d'adresses.

Appareils​

Un appareil Monica par compte Monica, avec ces fonctionnalités :

FonctionnalitéCe qu'elle indique
Anniversaires aujourd'huiles contacts dont c'est l'anniversaire aujourd'hui
Anniversaires sous 7 joursles anniversaires d'aujourd'hui à dans 6 jours
Rappels du jourles rappels Monica qui tombent aujourd'hui (hors rappels d'anniversaire)
Jours avant l'anniversairejours avant le prochain anniversaire, 0 si c'est aujourd'hui
Prochain anniversairele nom de la prochaine personne à fêter, « Aucun » sans anniversaire

Ce qui compte comme anniversaire :

  • un contact dont la date de naissance est connue ; si seuls le jour et le mois sont connus, il n'y a pas d'âge ;
  • les contacts décédés, archivés et partiels (proches sans fiche à eux) sont écartés, de même qu'une date de naissance saisie comme un âge seulement (« environ 40 ans ») ;
  • né un 29 février : fêté le 28 février les années non bissextiles.

Ce qui compte comme rappel : tous les rappels de Monica (une fois, toutes les N semaines, mois ou années), sauf ceux des contacts décédés ou archivés, et les rappels « Wish happy birthday » que Monica crée pour chaque anniversaire, déjà comptés comme anniversaires. Un rappel mensuel le 31 tombe le dernier jour des mois plus courts.

Tableau de bord​

Le widget Prochains anniversaires affiche deux tuiles (anniversaires et rappels du jour), les six prochains anniversaires avec leur date et l'âge atteint, et les rappels des 7 prochains jours avec leur contact. Ajoutez-le à un tableau de bord par Modifier → Ajouter un widget. Si Monica ne répond pas, le widget garde les dernières données connues sous une courte mention.

Scènes​

Déclencheurs​

Les événements du jour se déclenchent une fois par jour, à l'heure des événements de scène choisie dans la configuration (ou à la première lecture qui suit, si Gladys ou Monica étaient arrêtés). Un anniversaire ou un rappel ajouté plus tard dans la journée se déclenche à la lecture suivante. Les variables contiennent des noms : pensez à qui lira les messages que vous envoyez avec.

  • Anniversaire aujourd'hui (Monica) : un contact fête son anniversaire aujourd'hui. Filtre facultatif : Nom (prénom et nom exactement comme dans Monica). Variables : nom, prénom, âge atteint (vide si l'année est inconnue), date de l'anniversaire, numéro du contact Monica.
  • Anniversaire dans N jours (Monica) : l'anniversaire d'un contact est dans N jours. Champ obligatoire Jours avant l'anniversaire, de 1 (la veille) à 30 ; filtre facultatif Nom. Mêmes variables, plus les jours restants.
  • Rappel du jour (Monica) : un rappel tombe aujourd'hui. Filtre facultatif : Titre du rappel (titre exact). Variables : titre du rappel, nom du contact, numéro du rappel Monica, numéro du contact Monica.

Actions​

  • Lire les anniversaires de la semaine (Monica) : Monica est relu, puis l'action renvoie une Phrase, par exemple « 4 anniversaires dans les 7 prochains jours : Alice Martin (36 ans) aujourd'hui, Bruno aujourd'hui, Chloé Durand (10 ans) samedi et Inès lundi. », et le Nombre d'anniversaires, à envoyer par message ou à dire à voix haute. La phrase suit la langue choisie dans la configuration.

Idées de scènes​

  • Message d'anniversaire : déclencheur « Anniversaire aujourd'hui (Monica) » → envoyer « C'est l'anniversaire de {{name}} aujourd'hui » (et son âge, s'il est connu).
  • Penser au cadeau : déclencheur « Anniversaire dans N jours (Monica) » avec 7 jours → message « {{name}} fête son anniversaire dans une semaine : pense au cadeau ».
  • Lundi matin : chaque lundi à 8 h → « Lire les anniversaires de la semaine (Monica) » → dire la phrase sur l'enceinte de la cuisine, ou l'envoyer.
  • Rappel d'appel : déclencheur « Rappel du jour (Monica) » → message « Rappel : {{title}} ({{contact_name}}) ».

Dépannage​

  • « Monica ne répond pas » : vérifiez l'adresse (port compris) et que Gladys la joint : Gladys tourne dans Docker, localhost n'est pas votre serveur.
  • « jeton d'accès refusé (révoqué ou expiré ?) » : créez un nouveau jeton d'accès personnel dans Monica et collez-le dans la configuration.
  • « aucune API Monica 4 à cette adresse » : l'adresse pointe vers autre chose, ou vers Monica 5, qui n'a pas d'API.
  • « l'adresse redirige » : Monica impose le HTTPS : saisissez l'adresse en https://.
  • « certificat refusé » : cochez « Accepter les certificats auto-signés » pour votre propre serveur.
  • Un anniversaire manque : vérifiez dans Monica que le contact a une date de naissance (pas seulement un âge), qu'il n'est ni archivé ni décédé.
  • Pas d'événement de scène : les événements partent à l'heure choisie dans la configuration, une fois par jour ; les logs ne montrent jamais de noms (LOG_LEVEL=debug pour le détail d'une lecture).

Limites​

  • Monica 4 seulement ; Monica 5 n'est pas pris en charge (pas d'API).
  • Lecture seule : aucun contact, anniversaire ni rappel n'est créé ou modifié depuis Gladys.
  • Les événements du jour partent une fois par jour, pas à l'heure du rappel (un rappel Monica a une date, pas d'heure).
  • La prochaine occurrence d'un rappel est calculée par l'intégration à partir de sa date de départ et de sa fréquence.
  • Un compte Monica par intégration (celui du jeton).

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Votre MonicasectionNonUn Monica 4 auto-hébergé (Monica 5 n'a pas encore d'API). Dans Monica, créez un jeton d'accès personnel : Settings, API, Personal access tokens.
AdressestringOuiAdresse de Monica, comme dans le navigateur, avec https:// pour le HTTPS et :port s'il n'est pas standard.
Jeton d'accès personnelsecretOuiCréé dans Monica : Settings, API, Personal access tokens. L'intégration ne fait que lire.
OptionssectionNon
Heure des événements de scèneselectNonLes anniversaires et rappels du jour déclenchent leurs scènes à cette heure, une fois par jour.
Intervalle de rafraîchissementselectNonFréquence de lecture de Monica. Minuit et l'heure des événements sont toujours suivis à l'heure.
Accepter les certificats auto-signésbooleanNonPour une adresse en https:// dont le certificat est auto-signé. À cocher pour votre propre serveur seulement.
Langue des noms de fonctionnalitésselectNonNoms donnés aux fonctionnalités à l'ajout d'un appareil, et textes envoyés aux scènes.

Comment installer Monica dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Monica 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/guim31/gladys-monica:1.0.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/guim31/gladys-monica.

Monica 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​

Monica 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 guim31, 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 🙂
Dernière mise à jour le