Aller au contenu principal

Intégration domotique Mail and Packages, gratuite et open source

Intégration Mail and Packages pour Gladys Assistant

Colis et courrier détectés dans votre boîte mail (Colissimo, UPS, DHL, Amazon…).

Mail and Packages lit les notifications d'expédition qui arrivent dans votre boîte mail et indique à Gladys quels colis sont en route, arrivent aujourd'hui, attendent d'être retirés, sont livrés ou bloqués. Elle comprend 36 transporteurs et places de marché (Colissimo, Chronopost, Mondial Relay, Relais Colis, Colis Privé, DPD, GLS, DHL, UPS, FedEx, Amazon, Vinted, bpost…) en français, anglais, allemand, espagnol, italien, néerlandais et polonais. Avec USPS Informed Delivery, elle compte aussi le courrier annoncé pour la journée.

Elle s'inspire de l'intégration Home Assistant Mail and Packages.

Confidentialité​

  • La boîte est lue en IMAP, en lecture seule : rien n'est déplacé, marqué, passé en lu ou supprimé.
  • Seuls les e-mails des transporteurs activés sont téléchargés ; les autres ne sont vus que par leur expéditeur et leur objet, et jamais conservés.
  • Rien ne sort de votre Gladys : aucun service tiers, aucune API de suivi.
  • L'intégration conserve un petit fichier (/data/state.json) : les identifiants des notifications déjà annoncées à vos scènes, pour qu'un redémarrage ne les déclenche jamais deux fois. Aucun contenu d'e-mail, aucun mot de passe.

Configuration​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Renseignez le serveur IMAP, le port et la sécurité de votre fournisseur (voir le tableau ci-dessous), puis votre identifiant (généralement votre adresse e-mail) et votre mot de passe.
  3. Choisissez les dossiers à analyser : INBOX par défaut. Séparez plusieurs dossiers par des virgules, par exemple INBOX, Achats. Les libellés Gmail sont aussi des dossiers.
  4. Décochez si vous le souhaitez les transporteurs que vous n'utilisez jamais. Les boutiques ou transporteurs locaux absents de la liste s'ajoutent dans Autres expéditeurs, sous forme d'adresses ([email protected]) ou de domaines (boutique.example).
  5. Enregistrez, puis cliquez sur Tester la connexion : le message sous le bouton indique combien d'e-mails de la période sont lisibles.
  6. Ouvrez l'onglet Découverte et ajoutez les appareils souhaités.

Paramètres par fournisseur​

FournisseurServeur IMAPPortSécuritéMot de passe
Gmailimap.gmail.com993TLSmot de passe d'application
iCloudimap.mail.me.com993TLSmot de passe d'application
Yahooimap.mail.yahoo.com993TLSmot de passe d'application (Sécurité du compte)
Outlook / Hotmail———Microsoft n'accepte plus de mot de passe en IMAP : transférez vers une autre boîte
Orangeimap.orange.fr993TLSvotre mot de passe
Freeimap.free.fr993TLSvotre mot de passe
SFRimap.sfr.fr993TLSvotre mot de passe
La Poste (laposte.net)imap.laposte.net993TLSvotre mot de passe
Votre propre serveurson nom ou son IP993TLSactivez Accepter un certificat auto-signé uniquement pour un certificat maison

Astuce : une boîte dédiée. Inutile de donner à Gladys l'accès à votre boîte principale : créez une boîte gratuite réservée à Gladys et ajoutez, dans votre boîte principale, une règle de transfert pour les e-mails de vos transporteurs. La plupart des règles de transfert conservent l'expéditeur d'origine (« rediriger » dans certains webmails) ; sinon, ajoutez votre propre adresse dans Autres expéditeurs.

Réglages avancés​

  • Intervalle d'analyse : la boîte est lue toutes les 5 minutes par défaut.
  • Jours d'e-mails à lire : un colis est suivi tant que ses e-mails ont moins de ce nombre de jours (10 par défaut). Archiver ou supprimer les e-mails d'un colis le retire des compteurs à l'analyse suivante.
  • Langue des noms d'appareils : les noms que Gladys donne aux appareils à leur création. Vous pouvez les renommer ensuite.
  • Fuseau horaire : détermine quand commence « aujourd'hui ». Vide : le fuseau du serveur Gladys.

Appareils​

  • Courrier et colis : le récapitulatif de tous les transporteurs :
    • En transit : chaque colis encore en route ;
    • Arrive aujourd'hui : colis annoncés « en cours de livraison » aujourd'hui ;
    • Livrés aujourd'hui ;
    • À retirer : colis en consigne, en point relais ou au bureau de poste ;
    • Incidents de livraison : retards, passages manqués, retours ;
    • Courrier attendu aujourd'hui : les lettres annoncées par USPS Informed Delivery ;
    • Dernière mise à jour : le dernier évènement de colis, en texte.
  • Colis – transporteur : les cinq mêmes compteurs pour un transporteur.

Les compteurs sont recalculés à partir de la boîte à chaque analyse : une deuxième analyse ne compte jamais deux fois le même colis.

Scènes​

Déclencheurs​

Dans l'éditeur de scènes, catégorie Intégrations :

DéclencheurQuand
Colis expédiéune confirmation d'expédition arrive
Colis en cours de livraisonun transporteur annonce une livraison aujourd'hui
Colis à retirerun colis attend en consigne ou en point relais
Colis livréun transporteur confirme une livraison
Incident de livraisonretard, passage manqué, retour à l'expéditeur
Courrier attendu aujourd'huile résumé USPS Informed Delivery arrive

Chaque déclencheur de colis peut être filtré sur un ou plusieurs transporteurs et met à disposition des actions suivantes : {{triggerEvent.data.carrier_name}}, {{triggerEvent.data.tracking}}, {{triggerEvent.data.tracking_url}}, {{triggerEvent.data.pickup_code}} et {{triggerEvent.data.subject}}. Chaque étape d'un colis se déclenche une seule fois, redémarrages compris ; les e-mails déjà présents dans la boîte à l'installation ne déclenchent rien.

Exemple : Colis à retirer → envoyer le message « Votre colis {{triggerEvent.data.carrier_name}} vous attend, code {{triggerEvent.data.pickup_code}} ».

Actions​

  • Analyser la boîte mail (colis) : lit la boîte maintenant, puis renvoie les compteurs.
  • Obtenir les compteurs de colis : immédiat, les compteurs de la dernière analyse.

Les deux peuvent cibler un transporteur et renvoient arriving_today, in_transit, pickup, delivered, exception, mail, expected_today (vrai si un colis arrive aujourd'hui ou attend d'être retiré) et summary, une phrase prête à envoyer (« Colis : 2 arrive(nt) aujourd'hui, 1 à retirer. »), dans la langue de la configuration. Exemple : chaque matin à 8 h, Obtenir les compteurs de colis, puis « Continuer seulement si » expected_today est vrai, puis envoyer le summary à la famille.

Widgets du tableau de bord​

  • Colis du jour : les compteurs en tuiles, l'état de la boîte mail, l'heure de la dernière analyse et un bouton Analyser.
  • Suivi des colis : les colis en route et les livraisons du jour, avec le numéro de suivi, le code de retrait et un lien vers la page de suivi du transporteur.

Les deux peuvent afficher tous les transporteurs ou un seul (réglages du widget).

Dépannage​

  • « Le serveur de messagerie a refusé l'identifiant ou le mot de passe » : Gmail, iCloud et Yahoo exigent un mot de passe d'application, et la validation en deux étapes doit être activée pour en créer un.
  • « Le dossier … n'existe pas » : les noms de dossiers respectent la casse ; le dossier « Tous les messages » de Gmail s'appelle [Gmail]/Tous les messages.
  • Un colis n'est pas détecté : vérifiez que son transporteur est coché, que l'e-mail est dans un dossier analysé et plus récent que la période lue. Les transporteurs changent parfois leurs formulations : ouvrez un ticket sur GitHub avec l'adresse de l'expéditeur et l'objet de l'e-mail (retirez vos données personnelles).
  • Journaux : dans Gladys, ouvrez la page Supervision de l'intégration. Passez la variable LOG_LEVEL à debug pour plus de détails ; le mot de passe n'est jamais journalisé.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Votre boîte mailsectionNonL'intégration lit les notifications d'expédition de votre boîte mail en IMAP, en lecture seule : rien n'est déplacé, marqué ni supprimé. Gmail, iCloud, Yahoo et Outlook exigent un mot de passe d'application, pas votre mot de passe habituel. Une boîte dédiée, vers laquelle vous transférez vos e-mails d'expédition, fonctionne aussi.
Serveur IMAPstringOui
PortnumberOui993 avec TLS, 143 avec STARTTLS.
SécuritéselectOui
IdentifiantstringOui
Mot de passe (ou mot de passe d'application)secretOui
DossiersstringOuiDossiers à analyser, séparés par des virgules (ex. INBOX, Achats). Les libellés Gmail sont des dossiers.
Accepter un certificat auto-signébooleanNonUniquement pour un serveur de messagerie sur votre réseau. Laissez désactivé pour un fournisseur en ligne.
TransporteurssectionNonUn appareil par transporteur coché apparaît dans l'onglet Découverte, à côté de l'appareil récapitulatif « Courrier et colis ».
Transporteurs à détectermulti_selectNon
Autres expéditeursstringNonBoutiques ou transporteurs absents de la liste : adresses ou domaines, séparés par des virgules. Comptés dans « Autres expéditeurs ».
AvancésectionNon
Intervalle d'analyse (minutes)numberNon
Jours d'e-mails à lirenumberNonUn colis reste « en transit » tant que ses e-mails ont moins de ce nombre de jours.
Langue des noms d’appareilsselectNon
Fuseau horairestringNonDétermine quand commence « aujourd'hui ». Vide : le fuseau du serveur Gladys.

Comment installer Mail and Packages dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Mail and Packages 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/gboulvin/gladys-mail-and-packages:1.0.2), 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/gboulvin/Gladys-Mail-and-Packages.

Mail and Packages 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​

Mail and Packages 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 gboulvin, 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 🙂