Configurer l'import par e-mail

En plus du téléversement manuel, les PDF peuvent être importés par e-mail.

Fonctionnement

• L'e-mail doit contenir un fichier PDF.
• Le PDF doit contenir un code QR DOCTAG valide.
• Le document n'est importé qu'en cas de validation réussie.
• Si le PDF contient plusieurs codes QR, le document est divisé avant chaque code en documents distincts.

Configuration

Vous trouverez la fonction sous Paramètres > Système > E-Mail. Renseignez-y les identifiants d'une boîte aux lettres utilisée exclusivement par le serveur DOCTAG. L'import utilise toujours le flux de travail marqué comme par défaut (avec astérisque) dans les paramètres.

L'import par e-mail supprime les messages de la boîte aux lettres après leur importation.}

Intégration moderne des e-mails via OAuth2

À partir de 2026, DOCTAG prend en charge l'intégration sécurisée et universelle des boîtes aux lettres via le standard OAuth2 (RFC 6749) et XOAUTH2 (RFC 7628). Vous pouvez ainsi connecter Google, Microsoft, Yahoo et de nombreux autres fournisseurs sans interfaces propriétaires ni bibliothèques supplémentaires.

• ✅ Universel : Compatible avec Google, Microsoft, Yahoo et tout fournisseur OAuth2
• ✅ Sécurisé : Aucun mot de passe en clair ; les tokens sont stockés chiffrés (AES-256)
• ✅ Simple : Configuration unifiée, moins de dépendances
• ✅ Rétrocompatible : IMAP/POP3 classique toujours possible

Fournisseurs pris en charge

• Google : imap.gmail.com
• Microsoft : outlook.office365.com
• Yahoo : imap.mail.yahoo.com
• Autres : Tout serveur IMAP avec support XOAUTH2

Étapes de configuration

1. Dans DOCTAG, accédez à Paramètres > Système > E-Mail et sélectionnez le fournisseur « OAuth2 (Google, Microsoft, Yahoo) ».
2. Sélectionnez votre fournisseur et cliquez sur « Connecter avec le fournisseur ».
3. Vous serez redirigé vers le fournisseur pour autoriser l'accès.
4. Après connexion réussie, les identifiants sont stockés de manière chiffrée.

Remarque : Pour la configuration, vous aurez peut-être besoin d'accéder aux consoles cloud respectives (Google Cloud, Microsoft Azure, Yahoo Developer) pour renseigner les données client OAuth2. L'URL de redirection est toujours : https://<votre-domaine>/api/oauth2/callback

Sécurité et gestion des tokens

• Tous les tokens OAuth2 sont stockés chiffrés avec AES-256.
• Renouvellement automatique des tokens, aucune intervention manuelle requise.
• En cas de problème (p. ex. tokens expirés), il suffit de se réautoriser.

Migration et compatibilité

• Les boîtes IMAP/POP3 existantes continuent de fonctionner (mode hérité).
• Pour les nouvelles boîtes Google/Microsoft/Yahoo, OAuth2 est vivement recommandé.

Résolution des problèmes

• « XOAUTH2 not supported » : Le serveur de messagerie ne prend pas en charge XOAUTH2 – utilisez le mode hérité.
• « Invalid access token » : Token expiré – veuillez vous réautoriser.
• « OAuth2 configuration missing » : Vérifiez les données client OAuth2 dans les variables d'environnement.