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.
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 ne sont pas supportés (authentification par mot de passe supprimée par Microsoft).
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.

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 : non supportés. Microsoft a supprimé l'authentification par mot de passe (le serveur répond Basic authentication is disabled.) et n'accepte plus qu'OAuth2.
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().