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.
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. 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). 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.
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.
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().