---
title: "FAQ"
weight: 99
description: "Réponses aux questions fréquentes sur le module Capmail."
---

# 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](/capmail/permissions)).

## Les données ne sont pas extraites automatiquement dans le Lead Mode

Vérifiez que vous avez configuré au moins un [template](/capmail/templates) 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é](/capmail/admin-advanced)). 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](/capmail/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](/capmail/configuration).
