Import automatique de boîtes mail Office 365
Fonctionnalités
Principe
Capture Server surveille une ou plusieurs boîtes mail Office 365 selon un intervalle configurable. À chaque passage, il récupère les nouveaux e-mails et les intègre automatiquement dans Efalia Doc. Aucune action manuelle n'est requise : le service tourne en arrière-plan en tant que service Windows.
Prérequis
Une application enregistrée dans l'Azure Active Directory du tenant client, avec les droits de lecture sur les boîtes mail concernées (permission Microsoft Graph
Mail.Readen mode application)Un gabarit de document configuré dans Efalia Doc pour l'archivage des e-mails (métadonnées recommandées : objet, expéditeur, date de réception, adresse de la boîte destinataire)
Accès réseau sortant de la VM Capture Server vers les API Microsoft Graph (
graph.microsoft.com, port 443)
Ce que l'on peut archiver — les 3 modes
Le choix dépend du besoin métier : conserver le mail lui-même, ses pièces jointes, ou les deux.
Corps du mail uniquement : le corps de l'e-mail est converti en PDF et archivé dans Efalia Doc. Les pièces jointes sont ignorées.
Pièces jointes uniquement : seules les pièces jointes du mail sont archivées. Le corps du mail est ignoré. Utile pour les boîtes de dépôt de documents (ex : factures fournisseurs envoyées par mail).
Corps + pièces jointes : le corps du mail est converti en PDF et les pièces jointes lui sont attachées. Un seul document est créé dans Efalia Doc, regroupant l'intégralité du message.
Quelles boîtes et dossiers surveiller ?
La configuration est flexible : on peut surveiller plusieurs boîtes et plusieurs dossiers d'une même boîte, au sein d'un même tenant Office 365.
Boîte de réception : activation possible par boîte.
Éléments envoyés : activation possible par boîte. Permet de tracer les mails sortants.
Sous-dossiers supplémentaires : liste libre de sous-dossiers à surveiller en plus de la réception et des éléments envoyés (ex : un dossier « Comptabilité » où les mails sont manuellement déposés par l'utilisateur).
Plusieurs boîtes : la configuration des boîtes est une liste répétable. Chaque boîte peut avoir ses propres paramètres.
Destination dans Efalia Doc
Deux modes de destination sont disponibles, configurés par boîte surveillée :
Via gabarit de document : les e-mails sont classés selon les règles du gabarit Efalia Doc associé (armoire, métadonnées automatiquement renseignées). Mode recommandé pour un classement structuré.
Via bannette directe : les e-mails sont envoyés directement dans une bannette Efalia Doc pour traitement manuel. Ce mode est prioritaire sur le gabarit si les deux sont renseignés : à n'utiliser que si l'on souhaite une validation humaine avant classement.
Configuration (settings.json)
Paramètres racine
Ces paramètres complètent ceux déjà présents pour la relève de répertoires :
ImportExchange365 : tableau de connexions O365 (voir ci-dessous). Chaque élément correspond à un tenant Azure AD.
Section ImportExchange365 (tableau, répétable par tenant O365)
ClientId : GUID de l'application enregistrée dans le portail Azure AD
ClientSecret : secret de l'application Azure AD. Stocké en clair dans le fichier ; restreindre les droits NTFS sur la VM.
TenantId : GUID du tenant Azure AD
Archive : mode d'archivage.
0= corps uniquement,1= pièces jointes uniquement,2= corps + pièces jointesInterval : intervalle de scrutation en minutes (ex :
1= toutes les minutes)Trace :
truepour activer les logs détaillés (Observateur d'événements Windows). Désactiver en production.ImportFromDate : date de départ de collecte (format ISO :
2026-01-21T00:00:00Z). Non mise à jour automatiquement : en cas de redémarrage, les mails postérieurs à cette date seront re-importés (risque de doublons).DefaultTrayId : UUID de la bannette de destination. Prioritaire sur le gabarit si renseigné. Laisser vide si l'on utilise un gabarit.
MailDocTypeId : UUID du gabarit de document Efalia Doc. Ignoré si
DefaultTrayIdest renseigné.Mailboxes : tableau des boîtes surveillées pour ce tenant (voir sous-section suivante)
Sous-section Mailboxes (tableau, répétable par boîte)
Chaque élément est imbriqué dans une entrée ImportExchange365 et définit une boîte à surveiller pour ce tenant.
Address : adresse e-mail de la boîte surveillée (ex :
ecs@client.fr)ImportInbox :
truepour surveiller la boîte de réceptionImportSentItems :
truepour surveiller les éléments envoyésImportAdditionalFolders : tableau de sous-dossiers supplémentaires à surveiller. Peut être vide (
[])
Exemple de configuration complet
Limites et points de vigilance
Pas de gestion native des doublons : si le service redémarre sans que
ImportFromDateait été avancée manuellement, les mails déjà importés seront re-traités.Credentials stockés en clair :
ClientSecretetPasswordsont en texte brut danssettings.json. Restreindre les droits d'accès NTFS sur la VM (lecture réservée au compte de service Windows).
Authentification
Capture Server s'authentifie auprès de Microsoft Graph via l'application enregistrée dans Azure AD (ClientId / ClientSecret / TenantId), avec la permission application Mail.Read.
Mis à jour