Questions fréquentes
Les emails ne sont pas collectés automatiquement
Vérifiez que la tâche planifiée est active. Rendez-vous dans Accueil > Configuration > Tâches planifiées et recherchez le job "Capmail". Vérifiez que :
- Le job est activé (statut actif).
- La fréquence est correctement configurée (par défaut toutes les 2 heures).
- Le système de cron de votre serveur est opérationnel.
Vous pouvez aussi cliquer sur le bouton Actualiser dans la liste des emails pour lancer une collecte manuelle et vérifier que la connexion IMAP fonctionne.
La connexion IMAP échoue
Vérifiez les paramètres de connexion dans la configuration de la boîte mail :
- Le serveur IMAP est-il accessible depuis votre serveur Dolibarr ?
- Le port est-il correct (993 pour SSL, 143 pour STARTTLS) ?
- Les identifiants sont-ils à jour ?
- Le type de chiffrement est-il correct ?
- Le serveur présente-t-il un certificat auto-signé ? C'est fréquent en auto-hébergement. Passez alors " Valider le certificat TLS " à Non sur la fiche de la boîte mail.
Utilisez le bouton Tester la connexion sur la fiche de la boîte mail pour obtenir un diagnostic, et Détecter les dossiers pour vérifier que les chemins configurés correspondent à ceux du serveur.
Le test SMTP réussit mais les envois échouent
Ce symptôme est corrigé depuis la version 2.0.4 : le test s'arrêtait avant l'authentification et validait donc un mot de passe erroné. Il authentifie désormais réellement. Si le test échoue maintenant alors qu'il passait avant, c'est que le mot de passe SMTP était déjà faux.
Un tiers n'est pas détecté automatiquement
La détection de l'expéditeur repose sur la correspondance entre l'adresse email de l'expéditeur et les adresses email enregistrées dans les fiches tiers et contacts de Dolibarr. Vérifiez que l'adresse email est bien renseignée dans la fiche du tiers ou du contact.
Le module redirige vers une page d'onboarding
Capmail affiche cette page tant qu'aucune boîte mail n'est configurée. Si vous êtes administrateur, cliquez sur Configurer ma première boîte mail pour démarrer ; sinon, demandez à un administrateur de configurer une boîte.
Les emails d'un expéditeur apparaissent alors qu'ils devraient être masqués
Vérifiez le paramètre Expéditeurs à exclure dans la configuration (onglet Comportement). Les adresses doivent être séparées par des virgules. Pour exclure tout un domaine, utilisez le format *@domaine.fr.
L'envoi de réponse échoue
Vérifiez la configuration SMTP :
- Si vous utilisez une boîte mail dédiée, vérifiez que la configuration SMTP est renseignée sur la fiche de cette boîte mail.
- Si vous utilisez la configuration globale, vérifiez les paramètres SMTP dans Accueil > Configuration > Emails.
- Utilisez le bouton Tester SMTP sur la fiche de la boîte mail pour vérifier la connectivité.
Le sélecteur de boîte mail n'apparaît pas dans les formulaires d'envoi Dolibarr
Ce sélecteur n'apparaît que si :
- Au moins une boîte mail a une configuration SMTP renseignée.
- Votre utilisateur a le droit d'envoi sur au moins une de ces boîtes (voir Permissions).
Les données ne sont pas extraites automatiquement dans le Lead Mode
Vérifiez que vous avez configuré au moins un template actif avec des règles de détection et d'extraction. Le template doit correspondre à la structure de l'email pour que l'extraction fonctionne.
Utilisez l'onglet Test de la fiche template pour valider vos expressions régulières.
Comment changer la fréquence de collecte des emails ?
Rendez-vous dans Accueil > Configuration > Tâches planifiées, recherchez le job "Capmail" et modifiez la fréquence. Par défaut, la collecte a lieu toutes les 2 heures. Vous pouvez la réduire à toutes les 30 minutes ou toutes les heures selon vos besoins.
Mes emails apparaissent en double
C'est le signe d'une collecte rejouée : re-fetch après une panne, migration, resynchronisation complète d'un dossier... Un outil de purge est disponible dans l'onglet Avancé de la configuration du module (voir Administration -- Avancé). Le critère est strict : même identifiant de message, même boîte mail, même direction (entrant/sortant). L'outil conserve l'exemplaire le plus complet (avec ses liaisons tiers, contact, projet) et supprime les copies. Lancez d'abord le mode Aperçu pour contrôler ce qui serait supprimé.
Un email a disparu de la liste
Il a probablement été mis en attente (snooze) : l'email est masqué jusqu'à la date choisie, puis réapparaît automatiquement. Pour le retrouver :
- Dans l'interface leads, sélectionnez la bulle d'état Masqués.
- Dans la liste classique, utilisez le bouton de lune de la barre d'outils.
- Le bouton Réactiver (icône de soleil) de l'email le fait revenir immédiatement.
Si l'email a été archivé ou signalé comme spam, il est respectivement dans la bulle d'état Archivés ou Corbeille. Voir Utilisation.
Les étoiles et marqueurs ne remontent pas dans Thunderbird
La correspondance est la suivante : l'étoile Capmail correspond au flag IMAP \Flagged, et les marqueurs 1 à 4 aux keywords IMAP $Label1 à $Label4 (les touches 1 à 4 du pavé numérique de Thunderbird). Vérifiez que :
- Vous utilisez les marqueurs 1 à 4 : les marqueurs 5 à 8 sont locaux à Capmail et ne quittent jamais Dolibarr.
- L'étoile et le marqueur 1 sont deux choses distinctes : cocher le marqueur 1 dans Capmail change le libellé 1 dans Thunderbird, pas l'étoile.
- Thunderbird et Capmail consultent bien la même boîte et le même dossier IMAP (par exemple INBOX de la même adresse).
Qui peut voir les emails de ma boîte personnelle ?
Les emails collectés par votre boîte personnelle sont privés par défaut : vous seul pouvez les voir, même s'ils sont liés à un tiers Dolibarr. Vous pouvez toutefois partager un email privé lié à un tiers avec l'équipe, ce qui le rend visible par les autres utilisateurs ayant accès à ce tiers. La fonction de purge des emails privés, disponible dans les réglages de votre boîte personnelle, conserve les emails déjà partagés. Voir Configuration.