Capture par e-mail

Transformez les e-mails en tâches de Boîte de réception. Trois méthodes existent : surveillance IMAP intégrée sur ordinateur, partage depuis le téléphone pour tout fournisseur, et API cloud pour les installations auto-hébergées.

Voir aussi : API cloud, Déploiement Docker

Surveiller un dossier de courrier depuis l’application pour ordinateur

Indiquez un dossier de votre boîte aux lettres à Mindwtr, puis déplacez-y ou transférez-y des messages depuis n’importe quel client. Chacun devient une tâche de Boîte de réception. Votre courrier ne passe par aucun serveur tiers : l’application communique directement en IMAP avec votre fournisseur.

Configuration dans Paramètres → Intégrations → Capture par e-mail :

Saisissez le serveur IMAP, par exemple imap.gmail.com, le nom d’utilisateur et un mot de passe d’application. Les mots de passe ordinaires ne fonctionnent généralement pas ; celui-ci est conservé dans le trousseau du système.
Gardez le dossier Mindwtr par défaut ou choisissez-en un autre ; il sera créé s’il n’existe pas.
Activez l’option et enregistrez. L’enregistrement vérifie immédiatement la connexion et signale tout problème.
Dans votre client ou webmail, créez une règle — ou déplacez manuellement les messages — vers ce dossier.

Tant que l’application fonctionne, elle vérifie le dossier toutes les quelques minutes. L’objet devient le titre de la tâche ; l’expéditeur et le corps du message deviennent sa description. La capture est en lecture seule : Mindwtr ne modifie, déplace ni supprime jamais vos e-mails, et mémorise les messages déjà importés pour éviter les doublons. Archivez ou nettoyez le dossier quand vous le souhaitez.

La boîte aux lettres sert de file d’attente : les messages déposés lorsque l’ordinateur est éteint y restent, puis Mindwtr les récupère à son prochain démarrage. Pour capturer même lorsque l’application est arrêtée, utilisez les automatisations auto-hébergées.

Remarques par fournisseur :

Gmail : activez la validation en deux étapes, puis créez un mot de passe d’application ; serveur imap.gmail.com.
iCloud Mail : créez un mot de passe propre à l’application ; serveur imap.mail.me.com.
Fastmail et serveurs IMAP standards : créez un mot de passe d’application et utilisez l’hôte IMAP du fournisseur.
Outlook.com et Microsoft 365 : Microsoft a désactivé l’IMAP par mot de passe ; utilisez plutôt l’automatisation Power Automate.

Partager un e-mail depuis le téléphone

Cette méthode fonctionne sur Android et iOS avec toute application de courrier capable de partager du texte, notamment Outlook, Gmail et Apple Mail :

Ouvrez l’e-mail.
Touchez Partager et choisissez Mindwtr.
L’écran de capture s’ouvre avec le contenu partagé ; enregistrez-le dans la Boîte de réception.

C’est la méthode la plus rapide si vous traitez vos e-mails sur téléphone. Consultez Application mobile pour plus de détails.

Transférer un e-mail vers un serveur auto-hébergé

Si vous exploitez le serveur cloud auto-hébergé, toute automatisation capable d’envoyer une requête HTTP peut créer des tâches avec POST /v1/tasks. Le point de terminaison accepte un title simple ou un input d’ajout rapide avec la même syntaxe que l’application.

bash

curl -X POST https://your-server.example/v1/tasks \
  -H "Authorization: Bearer $MINDWTR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Reply to Dana about the contract", "props": {"description": "From: [email protected]"}}'

Ces méthodes transportent uniquement du texte : l’objet devient title, l’expéditeur ou un extrait va dans props.description. Pour capturer une pièce jointe comme un PDF, utilisez plutôt le partage du téléphone.

Dirigez l’automatisation vers votre serveur cloud, pas vers une machine personnelle. Le serveur est la source de synchronisation permanente : la capture fonctionne même lorsque votre ordinateur et votre téléphone sont éteints, puis les appareils récupèrent la tâche à leur prochaine synchronisation.

Outlook et Microsoft 365 : Power Automate

Power Automate est la meilleure solution pour les comptes Microsoft, puisque l’IMAP par mot de passe n’est plus autorisé :

Créez un flux déclenché par When a new email arrives, filtré sur un indicateur, une catégorie ou un dossier dédié.
Ajoutez une action HTTP : méthode POST, URL /v1/tasks de votre serveur, en-tête Authorization: Bearer <token> et corps JSON qui associe l’objet à title et l’expéditeur ou un extrait à props.description.
Marquez un e-mail ou déposez-le dans le dossier ; il apparaîtra dans la Boîte de réception Mindwtr à la prochaine synchronisation.

Le flux s’exécute dans le cloud Microsoft et fonctionne donc ordinateur éteint. Seuls les champs associés quittent votre boîte aux lettres.

Une adresse de capture dédiée : Cloudflare Email Workers

Si votre domaine utilise Cloudflare Email Routing, créez une adresse comme [email protected] et dirigez-la vers un Email Worker qui publie directement sur votre serveur :

export default {
  async email(message, env) {
    const response = await fetch("https://your-server.example/v1/tasks", {
      method: "POST",
      headers: {
        Authorization: `Bearer ${env.MINDWTR_TOKEN}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        title: message.headers.get("subject") || "Captured email",
        props: { description: `From: ${message.from}` },
      }),
    });
    if (!response.ok) {
      throw new Error(`Mindwtr returned ${response.status}`);
    }
  },
};

Stockez le jeton comme secret Worker avec wrangler secret put MINDWTR_TOKEN, jamais dans le script. Lever une erreur en cas d’échec rend la livraison visiblement défaillante et permet au serveur expéditeur de réessayer, au lieu de perdre le message. Pour inclure le corps dans la description, analysez le MIME brut avec une bibliothèque comme postal-mime ; la version limitée à l’objet n’en a pas besoin.

Tout message transféré à cette adresse devient une tâche de Boîte de réception. Gardez l’adresse privée ou ajoutez une liste d’expéditeurs autorisés : toute personne qui la découvre peut créer des tâches.

Gmail et les autres services : n8n, Zapier, scripts et règles

Le même modèle fonctionne avec tout outil capable de lire la boîte aux lettres ou de recevoir du courrier, puis d’envoyer une requête HTTP :

n8n / Node-RED : un déclencheur IMAP ou Gmail vers un nœud de requête HTTP ;
Zapier : une adresse entrante Email by Zapier ou un déclencheur Gmail vers une étape POST Webhooks by Zapier ;
script sur une machine permanente : surveille un dossier et publie chaque nouveau message ;
Sieve/procmail sur votre serveur de courrier : transmet les messages correspondants à un petit script.

Gardez le jeton secret : toute personne qui le possède peut lire et écrire les tâches de cet espace de noms.

Pourquoi il n’existe pas d’adresse de transfert Mindwtr

Mindwtr ne propose volontairement aucune adresse hébergée : un relais ferait transiter vos e-mails privés par l’infrastructure du projet, ce qui contredirait une application locale. La surveillance intégrée conserve le courrier entre votre serveur et votre appareil.

Capture par e-mail ​

Surveiller un dossier de courrier depuis l’application pour ordinateur ​

Partager un e-mail depuis le téléphone ​

Transférer un e-mail vers un serveur auto-hébergé ​

Outlook et Microsoft 365 : Power Automate ​

Une adresse de capture dédiée : Cloudflare Email Workers ​

Gmail et les autres services : n8n, Zapier, scripts et règles ​

Pourquoi il n’existe pas d’adresse de transfert Mindwtr ​