For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.Read en 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)

Tous les paramètres ci-dessous sont à renseigner dans le fichier settings.json de Capture Server, situé dans le répertoire d'installation du service (voir Installation d'Efalia Capture Server). Respecter la syntaxe JSON (guillemets, virgules, accolades).

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 jointes

  • Interval : intervalle de scrutation en minutes (ex : 1 = toutes les minutes)

  • Trace : true pour 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 DefaultTrayId est 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 : true pour surveiller la boîte de réception

  • ImportSentItems : true pour surveiller les éléments envoyés

  • ImportAdditionalFolders : 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 ImportFromDate ait été avancée manuellement, les mails déjà importés seront re-traités.

  • Credentials stockés en clair : ClientSecret et Password sont en texte brut dans settings.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