---
title: "Administration -- Boîtes mail"
weight: 20
description: "Gestion des comptes IMAP/SMTP, droits d'accès et associations dossier -> étiquette."
---

# Administration -- Boîtes mail

Cet onglet est le point d'entrée de la configuration. Tant qu'aucune boîte mail n'est créée, le module ne peut rien collecter.

## Liste des boîtes mail (`admin/mailbox_list.php`)

Tableau récapitulatif des boîtes IMAP configurées dans Dolibarr. Chaque ligne représente un compte distinct (un utilisateur peut être autorisé sur plusieurs boîtes).

Colonnes affichées :

- **Libellé** -- nom métier de la boîte (ex. " Service commercial ").
- **Hôte** -- serveur IMAP.
- **Identifiant** -- login IMAP (généralement l'adresse email).
- **Statut** -- active ou inactive. Une boîte inactive n'est pas synchronisée.

Actions : créer une nouvelle boîte, éditer, désactiver, supprimer.

## Fiche d'une boîte mail (`admin/mailbox_card.php`)

### Section IMAP (collecte des emails entrants)

| Champ | Description |
|-------|-------------|
| **Libellé** | Nom affiché dans l'interface (obligatoire). |
| **Hôte** | Serveur IMAP, ex. `imap.gmail.com` (obligatoire). |
| **Port** | Port IMAP. Défaut `993` pour SSL/TLS, `143` pour STARTTLS. |
| **Chiffrement** | SSL, TLS, STARTTLS ou aucun. SSL recommandé. |
| **Identifiant** | Login IMAP (souvent l'email complet). Obligatoire. |
| **Authentification** | **Mot de passe** (par défaut) ou **OAuth2 (Google, Microsoft 365)**, qui utilise un jeton du module OAuth de Dolibarr à la place du mot de passe, pour la relève comme pour l'envoi. Procédure : [Relier une boîte Google ou Microsoft 365 par OAuth](/capmail/connecter-oauth). |
| **Service OAuth** | En OAuth2 seulement : le fournisseur Google ou Microsoft déclaré dans le module OAuth de Dolibarr. |
| **Mot de passe** | Mot de passe IMAP. Pour Gmail, un mot de passe d'application est obligatoire : voir [Connecter une boîte Gmail](/capmail/connecter-gmail). Outlook et Microsoft 365 n'acceptent pas de mot de passe : choisissez l'authentification OAuth2. |
| **Dossier principal** | Dossier source de la collecte. Défaut `INBOX`. |
| **Dossier d'archive** | Cible du bouton " Archiver ". Si vide, l'archivage reste local. |
| **Dossier spam** | Cible du bouton " Spam ". |
| **Dossier envoyés** | Où copier les mails sortants après envoi SMTP. |
| **Dossier corbeille** | Cible du bouton " Supprimer ". |
| **Valider le certificat TLS** | Oui par défaut. À passer à Non uniquement si le serveur présente un certificat auto-signé (serveur auto-hébergé, passerelle locale). La connexion reste chiffrée, mais l'identité du serveur n'est plus vérifiée. |

Le bouton **Détecter les dossiers** interroge le serveur et compare ce qui est configuré à ce qui existe réellement : il signale les dossiers absents, les noms ambigus (plusieurs dossiers portant le même nom), et propose les bonnes valeurs à partir des attributs standard du serveur. Le bouton **Appliquer les dossiers détectés** écrit ces propositions.

C'est la méthode recommandée plutôt que de saisir les chemins à la main : les conventions varient beaucoup d'un hébergeur à l'autre (`INBOX.Sent` chez certains, `Sent` chez d'autres, `[Gmail]/Messages envoyés` chez Gmail).

Le bouton **Tester la connexion IMAP** vérifie les identifiants et liste les dossiers disponibles. Le bouton **Créer les dossiers par défaut** crée `Sent`, `Trash`, `Junk`, `Archives`, `Drafts` si seul `INBOX` existe.

### Section SMTP (envoi des emails sortants)

Tous les champs SMTP sont **optionnels**. Si non renseignés, le module utilise la configuration SMTP globale de Dolibarr.

| Champ | Description |
|-------|-------------|
| **Hôte SMTP** | Serveur SMTP (ex. `smtp.gmail.com`). Vide = SMTP global Dolibarr. |
| **Port SMTP** | Défaut `587` (STARTTLS) ou `465` (SSL/TLS). |
| **Identifiant SMTP** | Vide = réutilise l'identifiant IMAP. |
| **Mot de passe SMTP** | Vide = réutilise le mot de passe IMAP. |
| **Chiffrement SMTP** | TLS, SSL, STARTTLS ou aucun. |
| **Adresse d'expédition (From)** | Adresse affichée comme expéditeur. Utile quand le compte technique diffère de l'adresse publique (ex. login `compte42@domaine.fr` mais expédition depuis `contact@domaine.fr`). |

Le bouton **Tester la connexion SMTP** vérifie l'envoi.

### Associations dossier -> étiquette

Permet de poser automatiquement une étiquette Capmail sur les emails arrivant dans un dossier IMAP donné. Utile pour identifier visuellement un dossier (ex. " Newsletter " coloré en jaune dans la liste).

## Matrice des droits (`admin/mailbox_rights.php`)

Grille utilisateur × boîte mail avec deux cases par cellule :

- **Lecture** -- l'utilisateur voit les emails de cette boîte.
- **Envoi** -- l'utilisateur peut envoyer depuis cette boîte (implique automatiquement Lecture).

Les administrateurs ont tous les droits par défaut. La sauvegarde est instantanée (AJAX) au clic sur une case.

### Détecter les serveurs

À la création, la première ligne du formulaire demande l'**adresse email** de la boîte. **Détecter les serveurs** remplit l'hôte, le port et le chiffrement IMAP et SMTP, l'identifiant et le libellé, à partir des domaines de l'entreprise, des fournisseurs connus, puis des enregistrements DNS du domaine (voir [Boîte mail personnelle](/capmail/configuration#boîte-mail-personnelle)). Vérifiez ensuite avec **Tester la connexion**.

## Domaines de messagerie de l'entreprise (`admin/domains.php`)

L'onglet **Domaines de messagerie** déclare, une fois pour toutes, les serveurs et les dossiers des domaines de l'entreprise (`@votre-entreprise.fr`). Un utilisateur dont l'adresse appartient à l'un d'eux ajoute sa boîte personnelle avec son adresse et son mot de passe, sans voir un seul paramètre de serveur.

Pour ajouter un domaine, cliquez sur **Ajouter un domaine**. Le champ **Pré-remplir depuis une adresse** remplit le formulaire à partir d'une adresse existante du domaine ; complétez au besoin les dossiers (Envoyés, Archives, Indésirables, Corbeille), qui seront repris pour chaque boîte. Déclarer à nouveau un domaine remplace sa configuration.

Seuls des noms de serveur, des ports entre 1 et 65535 et les chiffrements SSL, TLS et STARTTLS sont acceptés : ces valeurs sont utilisées pour la connexion de chaque utilisateur du domaine.

## Cas particuliers par hébergeur

- **Gmail** : mot de passe d'application obligatoire, et dossiers spéciaux préfixés `[Gmail]/` avec des noms traduits dans la langue du compte. Procédure complète : [Connecter une boîte Gmail](/capmail/connecter-gmail).
- **Outlook.com et Microsoft 365** : Microsoft a supprimé l'authentification par mot de passe (le serveur répond `Basic authentication is disabled.`). Reliez la boîte par OAuth2 : voir [Relier une boîte Google ou Microsoft 365 par OAuth](/capmail/connecter-oauth).
- **Proton Mail** : non supporté. Proton n'expose aucun serveur IMAP public, l'accès passe par l'application locale Proton Mail Bridge.
- **Serveurs en `INBOX.`** (OVH MX Plan et beaucoup de Dovecot) : les dossiers s'écrivent `INBOX.Sent`, `INBOX.Archive`, etc. Utilisez **Détecter les dossiers** plutôt que de les deviner.

## Conseils

- Une boîte par identité publique (ex. `contact@`, `compta@`, `support@`).
- Désactiver une boîte plutôt que la supprimer si vous voulez juste arrêter la collecte temporairement (préserve l'historique).
- Le mot de passe IMAP/SMTP est chiffré en base via `dolEncrypt()`.