IMAP pour Home Assistant (intégration native)

À propos

IMAP est une intégration Home Assistant native qui se connecte à un compte de messagerie et fournit des informations sur ses messages. Elle ajoute un capteur pour les messages d’un dossier choisi, et une commande de recherche, qui cible par défaut les messages non lus et non supprimés, détermine quels messages sont comptés. Les nouveaux messages déclenchent un événement qui peut contenir les données du message, et un modèle peut ajouter des données personnalisées à cet événement, tandis que la taille de l’événement est limitée. Les mises à jour en push sont prises en charge quand le serveur les propose, avec l’interrogation périodique comme alternative, qui réagit plus lentement. Des actions peuvent récupérer un message ou une pièce jointe, déplacer un message vers un autre dossier, le marquer comme lu ou le supprimer. La configuration se fait dans l’interface, avec des réglages pour le serveur, le port, les identifiants, le jeu de caractères et la vérification du certificat SSL.

Résumé automatique du code source de Home Assistant, traduit automatiquement. Une erreur ? Prendre contact

Prise en charge

Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
Configuration dans l’interface Ajoute-la dans Paramètres > Appareils et services. Rien à télécharger.
Mise à jour avec Home Assistant Livrée et mise à jour avec chaque version de Home Assistant.

Fournit

Capteurs

Mise en place

Elle s’ajoute dans Paramètres > Appareils et services, avec « Ajouter une intégration ».

Connexion

Jeu de caractèresLe jeu de caractères utilisé. Les valeurs courantes sont utf-8 ou US-ASCII.
Données du message à inclure dans les données de l'événement imap_content :Notez que la taille de l'événement est limitée et que tout le texte du message n'est pas forcément envoyé avec l'événement si celui-ci est trop volumineux.
DossierEn général, le dossier est défini sur INBOX, mais par exemple dans le cas d'un sous-dossier nommé Test, il faut indiquer INBOX.Test.
Mot de passeLe mot de passe IMAP
PortLe port IMAP prenant en charge SSL, généralement 993.
Recherche IMAPLa commande de recherche IMAP, qui est UnSeen UnDeleted par défaut.
ServeurLe serveur IMAP.
Liste de chiffrements SSLSi le service IMAP ne prend en charge que le chiffrement hérité, essayez de modifier ce paramètre.
Nom d'utilisateurLe nom d'utilisateur IMAP.
Vérifier le certificat SSLRecommandé, pour garantir que le certificat du serveur est valide. Désactivez cette option si le certificat du serveur n'est pas approuvé (par exemple auto-signé).

Nouvelle connexion au compte

Mot de passeCorrigez le mot de passe IMAP.

Après la mise en place

Modèle pour créer des données d'événement personnaliséesCe modèle est évalué lorsqu'un nouveau message est reçu, et le résultat est ajouté à l'attribut custom des données de l'événement.
Activez la fonction Push-IMAP si le serveur la prend en charge. Désactivez si les mises à jour Push-IMAP ne sont pas fiables.Il est recommandé d'utiliser Push-IMAP. L'interrogation augmente le temps de réponse.
Données de message à inclure dans les données d'événement imap_content.Notez que la taille de l'événement est limitée et que tout le texte du message n'est pas forcément envoyé avec l'événement si celui-ci est trop volumineux.
DossierEn général, le dossier est défini sur INBOX, mais par exemple dans le cas d'un sous-dossier nommé Test, il faut indiquer INBOX.Test.
Taille maximale des messages (2048 < taille < 30000)Limite la taille maximale de l'événement. Plutôt que de transmettre (tout) le message texte, l'utilisation d'un modèle est préférable.
Recherche IMAPLa commande de recherche IMAP, qui est UnSeen UnDeleted par défaut.

Textes issus du code source de Home Assistant, Apache License 2.0.

Entités

CapteursMessages

Actions

Supprimer un messageSupprime un e-mail.Champs : Entrée, UID
Récupérer un messageRécupère un e-mail à partir du serveur.Champs : Entrée, UID
Récupérer une partie du messageRécupère une partie de message ou une pièce jointe d'un message électronique.Champs : Entrée, Partie, UID
Déplacer un messageDéplace un e-mail vers un dossier cible.Champs : Entrée, Vu, Dossier cible, UID
Marquer un message comme vuMarque un e-mail comme vu.Champs : Entrée, UID