> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/efalia-capture/installation/import-boites-mail-office365.md).

# Import automatique de boîtes mail Office 365

{% hint style="warning" %}
Capture Server uniquement. Disponible depuis la v1.2.0.7 (18/12/2025). Fonctionne via Office 365 (OAuth2 / Azure AD, API Microsoft Graph). Une spécification initiale basée sur IMAP est obsolète — s'appuyer sur cette page.
{% endhint %}

## 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)

{% hint style="info" %}
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](https://documentation.efalia.com/produit/efalia-capture/installation/installation-capture-server.md)). Respecter la syntaxe JSON (guillemets, virgules, accolades).
{% endhint %}

### 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

```json
{
    "BaseUrl": "https://demo-doc.efalia.cloud:1202",
    "Username": "xxx",
    "Password": "xxx",
    "Language": "fr",

    "ImportFolders": [],
    "ImportExchange365": [
        {
            "ClientId": "xxx",
            "ClientSecret": "xxx",
            "TenantId": "xxx",
            "Archive": 1,
            "Interval": 1,
            "Trace": true,
            "ImportFromDate": "2026-01-21T00:00:00Z",
            "DefaultTrayId": "",
            "MailDocTypeId": "89f702f0-9664-4972-8d60-7d7d4bf9973d",
            "Mailboxes": [
                {
                    "Address": "ecs@client.fr",
                    "ImportInbox": true,
                    "ImportSentItems": false,
                    "ImportAdditionalFolders": []
                }
            ]
        }
    ]
}
```

### 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`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/efalia-capture/installation/import-boites-mail-office365.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
