Nouveautés de la version 2.0

La version 2.0 est une refonte majeure du module Capmail. Elle introduit une nouvelle interface de traitement des emails, le support de plusieurs boîtes mail, un système d'étiquettes en remplacement de la navigation par dossiers IMAP, et de nombreuses améliorations de productivité.

Cette page résume les changements visibles côté utilisateur. Pour les détails de configuration de chaque fonctionnalité, consultez les pages dédiées référencées en fin de chaque section.

Nouvelle interface "Lead Mode" par défaut

Le Lead Mode remplace la vue liste classique comme interface principale. C'est une vue en trois colonnes redimensionnables :

• Colonne gauche : liste des emails avec scroll infini, badges et indicateurs visuels (non lu, étoile, étiquettes, fil de conversation).
• Colonne centrale : prévisualisation de l'email sélectionné, actions rapides, données extraites automatiquement.
• Colonne droite : actions de traitement (créer/lier un tiers, répondre, agenda, etc.).

La vue liste classique reste disponible via un bouton dédié pour les recherches avancées.

Voir : Lead Mode.

Raccourcis clavier et annulation

L'interface Lead Mode supporte des raccourcis clavier (j/k pour naviguer, a pour archiver, s pour spam, d pour supprimer, r pour répondre, t pour associer un tiers, etc.) avec confirmation par toast et possibilité d'annulation via Ctrl+Z.

Voir : Utilisation -- Raccourcis clavier.

Gestion de plusieurs boîtes mail

Avant la 2.0, le module ne gérait qu'une seule connexion IMAP globale. Désormais, chaque installation peut déclarer autant de boîtes mail que nécessaire, chacune avec ses propres paramètres IMAP et SMTP. Chaque email collecté est rattaché à la boîte d'origine.

Cas d'usage typiques : séparation contact@, support@, compta@ ; rattachement de boîtes partagées d'équipe ; mutualisation d'un même Capmail entre plusieurs marques.

Voir : Administration -- Boîtes mail.

Matrice des droits par boîte mail

Une grille utilisateur x boîte mail permet de définir finement qui peut lire et qui peut envoyer depuis chaque boîte. Les administrateurs ont tous les droits par défaut. La sauvegarde est instantanée au clic.

Voir : Permissions.

Boîte mail personnelle

Chaque utilisateur autorisé peut configurer sa propre boîte IMAP privée directement depuis l'interface leads, sans intervention de l'administrateur sur les boîtes partagées. Les emails reçus restent visibles uniquement par le propriétaire, jusqu'à ce que l'utilisateur choisisse de partager un fil avec l'équipe en le liant à un tiers.

Voir : Configuration -- Boîte mail personnelle.

Configuration SMTP par boîte mail

Chaque boîte mail peut avoir son propre serveur SMTP (sinon, fallback sur le SMTP global Dolibarr). Un champ Adresse d'expédition (From) permet d'utiliser une adresse publique différente du login technique (par exemple : login compte42@domaine.fr, envoi depuis contact@domaine.fr).

Voir : Administration -- Boîtes mail -- Section SMTP.

Sélecteur de boîte mail dans les formulaires Dolibarr

Lorsqu'un utilisateur envoie un email depuis un formulaire standard Dolibarr (devis, facture, commande, etc.), un sélecteur Envoyer depuis la boîte mail apparaît. Il liste uniquement les boîtes pour lesquelles l'utilisateur a le droit d'envoi et qui disposent d'une configuration SMTP. L'email est envoyé via le serveur SMTP de la boîte choisie et automatiquement copié dans son dossier "Envoyés".

Voir : Utilisation -- Envoi depuis les formulaires Dolibarr.

Étiquettes Capmail (en remplacement de la navigation par dossiers IMAP)

La version 2.0 introduit un système d'étiquettes propres à Capmail qui remplace la navigation par dossiers IMAP de la 1.x. Une étiquette est une marque colorée posée sur un email pour le classer, indépendante de l'arborescence IMAP.

Avantages par rapport aux dossiers IMAP :

• Un email peut porter plusieurs étiquettes en même temps.
• Les étiquettes sont propres à Capmail : aucun risque de casser l'organisation IMAP côté serveur.
• Étiquettes partagées (gérées par les administrateurs, visibles par tous) ou personnelles (privées à chaque utilisateur).
• Filtrage rapide depuis la sidebar par simple clic sur une étiquette.
• Pose par glisser-déposer, menu d'étiquettes, ou action de masse.
• Association automatique dossier IMAP -> étiquette : permet d'étiqueter automatiquement les emails arrivant dans un dossier IMAP donné (ex. tout ce qui tombe dans INBOX/Newsletter reçoit l'étiquette "Newsletter").

Voir : Administration -- Étiquettes.

Synchronisation bidirectionnelle des flags IMAP

Les changements d'état dans Capmail sont désormais répercutés sur le serveur IMAP, et inversement. La synchronisation couvre :

• \Seen <-> statut lu/non lu Dolibarr.
• \Flagged <-> étoile Capmail (bouton fa-star jaune).
• Keywords $Label1 à $Label4 <-> marqueurs personnalisés 1 à 4 de Capmail.

Cela rend Capmail compatible avec Thunderbird (touches 1 à 4 du pavé numérique pour poser les labels), Roundcube et la plupart des webmails modernes : un email marqué important dans Thunderbird est marqué dans Capmail, et réciproquement.

L'étoile (\Flagged) est désormais indépendante du marqueur 1 -- ce sont deux concepts distincts.

Les marqueurs 5 à 8 restent purement locaux à Capmail (aucun équivalent IMAP standard).

Voir : Administration -- Avancé -- Marqueurs personnalisés.

Vue en enfilade (email threading)

Les emails appartenant à un même fil de conversation sont détectés automatiquement (via les en-têtes RFC 5322 In-Reply-To et References) :

• Une icône dédiée dans la liste indique qu'un email fait partie d'un fil.
• Un panneau collapsible dans la prévisualisation liste tous les messages du fil par ordre chronologique. Un clic sur un message du fil bascule la prévisualisation.
• Propagation automatique de la liaison tiers : lier un email à un tiers (création, association ou doublon) propage la liaison à tous les autres messages du même fil. Plus besoin de retraiter manuellement chaque réponse d'une conversation.

Voir : Utilisation -- Fiche email.

Mise en attente (snooze)

Un email peut être mis en attente jusqu'à une date choisie. Il disparaît des listes pendant cette période et réapparaît automatiquement quand la date est atteinte. Raccourcis proposés : demain 8h, dans 2 jours, lundi prochain, 1 semaine, 1 mois, date personnalisée.

Le snooze est aussi disponible en action de masse, et un bouton de la barre d'outils permet d'afficher temporairement les emails en attente.

Voir : Utilisation -- Actions rapides.

Modèles de détection et d'extraction

Capmail peut désormais reconnaître automatiquement des emails issus de formulaires web (Contact Form 7 WordPress, Wix, Typeform, formulaires custom...) et en extraire des données structurées (nom, email, téléphone, code postal, ville, SIREN, message, etc.).

Pour chaque modèle :

• Règles de détection (sujet contient, expéditeur contient, regex sur le corps...) pour déterminer quand le modèle s'applique.
• Règles d'extraction (regex sur le corps texte ou HTML, sur le sujet, etc.) pour remplir les champs cibles.
• Étiquettes par défaut (tiers, contact, projet) appliquées automatiquement aux objets créés depuis un email correspondant.
• Onglet Test intégré pour valider le modèle avec un email exemple avant mise en production.

Les données extraites pré-remplissent automatiquement les formulaires de création de tiers/contact/projet du Lead Mode, signalées visuellement par une bordure bleue et une icône de baguette magique.

Voir : Administration -- Modèles d'extraction et Templates.

Détection de doublons et création rapide d'objets Dolibarr

Avant de créer un nouveau tiers, le Lead Mode recherche automatiquement les correspondances existantes selon plusieurs critères :

• Adresse email de l'expéditeur.
• Numéro de téléphone (normalisé, chiffres uniquement).
• Numéro SIREN.
• Nom de société (matching flou via similar_text + Levenshtein, seuil 70 %).
• Sujet d'emails déjà liés à un tiers (avec strip des préfixes Re:/Fwd:/Tr:).

Les correspondances trouvées sont affichées dans un encadré "Doublons potentiels" avec un bouton pour lier directement l'email au tiers existant.

Si aucun doublon n'est trouvé, des formulaires de création rapide permettent de créer en quelques clics :

• Tiers (avec statut Prospect/Client, commercial assigné, conditions et mode de règlement, compte bancaire, le tout pré-configurable).
• Contact rattaché au tiers.
• Projet auto-créé ou manuel, avec rattachement des pièces jointes de l'email au projet (avec renommage).

Voir : Lead Mode.

Onglet Capmail sur la fiche tiers et onglet Actions futures

Chaque fiche tiers Dolibarr dispose d'un nouvel onglet Capmail affichant l'historique complet des emails échangés (entrants et sortants).

Depuis le panneau de droite du Lead Mode, quand un email est lié à un tiers, un onglet Actions liste les prochains événements de l'agenda Dolibarr liés à ce tiers, permettant de consulter, modifier ou ajouter un événement (rendez-vous, appel, tâche) sans quitter l'interface.

Voir : Utilisation -- Onglet Actions et Onglet Capmail sur la fiche tiers.

Affichage sécurisé du contenu HTML

Le corps des emails HTML est désormais affiché dans une iframe sandboxée avec une politique CSP stricte qui bloque scripts, objets et bases externes. Le referrerpolicy="no-referrer" empêche les fuites de données vers les serveurs de tracking éventuellement intégrés aux images. Une bascule HTML / texte brut est disponible.

Cette protection multicouche élimine les risques d'XSS liés à la consultation d'emails malveillants.

Voir : Utilisation -- Contenu de l'email.

Refonte du setup d'administration

La page de configuration est entièrement réorganisée en 4 onglets thématiques principaux + 4 onglets secondaires :

Onglets principaux :

1. Boîtes mail -- point d'entrée obligatoire. Tant qu'aucune boîte n'est créée, l'interface affiche un onboarding qui invite l'administrateur à configurer sa première boîte.
2. Comportement -- réglages généraux (menu, archivage IMAP, exclusions, éditeur HTML, boîte d'envoi par défaut).
3. Leads et tiers -- valeurs par défaut pour la création de tiers/projets, réponse automatique, couleurs des statuts.
4. Avancé -- marqueurs personnalisés, champs extra, ordre des colonnes, outils de maintenance one-shot.

Onglets secondaires :

5. Modèles d'extraction -- détection automatique de formulaires et extraction.
6. Étiquettes -- gestion des étiquettes partagées et personnelles.
7. Droits d'accès aux boîtes mail -- matrice utilisateur x boîte mail.
8. À propos -- informations sur le module.

L'ancienne configuration IMAP globale (CAPMAIL_SERVER_HOST/PORT/LOGIN/PASS/...) a été supprimée : toute la configuration IMAP est désormais portée par les fiches Mailbox.

Voir : Configuration.

Éditeur newsletter et éditeur TinyMCE

Un éditeur dédié à la composition de newsletters est intégré au module. En complément, l'éditeur HTML utilisé pour rédiger les réponses peut être basculé entre TinyMCE (moderne, recommandé) et CKEditor (classique Dolibarr) via une option de l'onglet Comportement.

Voir : Configuration -- Éditeur de mail.

Notifications navigateur

Capmail peut afficher des notifications natives du navigateur à l'arrivée de nouveaux emails. L'activation se fait depuis la barre d'outils de la liste, après autorisation du navigateur.

Voir : Utilisation -- Notifications.

Outils de maintenance

L'onglet Avancé rassemble une série d'actions de maintenance one-shot, chacune avec un mode aperçu (dry-run) quand c'est pertinent :

• Recalculer les dates depuis les fichiers EML.
• Corriger les références PROV bloquées.
• Purger les emails orphelins (présents en base mais plus côté IMAP).
• Re-lier les tiers aux emails non liés.
• Resynchroniser tous les dossiers depuis une date donnée.
• Purger les doublons stricts (même Message-ID + même boîte + même direction).
• Nettoyer les dossiers IMAP obsolètes.
• Nettoyer les liens dossier orphelins.
• Re-archiver les emails archivés localement mais pas côté serveur.

Voir : Administration -- Avancé -- Outils de maintenance.

Compatibilité Dolibarr 18 à 23

La 2.0 a été validée sur l'ensemble des versions Dolibarr 18, 19, 20, 21, 22 et 23. Les adaptations spécifiques (TRIGGER_PREFIX, fetchAll avec filtre USF de Dol 20, fallback CommonHookActions Dol 18) sont prises en charge automatiquement.

Migration depuis la 1.x

Lors de la mise à jour depuis une version 1.x :

1. Désactivez puis réactivez le module pour appliquer les migrations SQL (ajout des tables llx_capmail_mailbox, llx_capmail_mailbox_rights, llx_capmail_email_templates_input, llx_capmail_tag, llx_capmail_tag_message, llx_capmail_imap_folder, llx_capmail_imap_folder_message, conversion des charsets en utf8mb4, etc.).
2. Créez votre première boîte mail dans l'onglet Boîtes mail en reprenant les paramètres de l'ancienne configuration IMAP globale (serveur, port, login, mot de passe, dossiers).
3. Attribuez les droits d'accès dans la matrice (onglet Droits d'accès aux boîtes mail).
4. Vérifiez la tâche planifiée : elle continue de tourner mais collecte désormais sur toutes les boîtes actives.

Les emails déjà en base sont conservés. Leur rattachement à la nouvelle boîte mail se fait automatiquement lors du premier fetch (correspondance via le login IMAP) ou peut être rejoué via l'outil Re-lier les tiers si nécessaire.

L'ancienne configuration IMAP globale n'est pas migrée automatiquement pour éviter d'écraser les données à chaque réactivation : la migration se fait manuellement comme décrit ci-dessus.