Aller au contenu principal

Dépannage

Si vous rencontrez des problèmes de connexion à votre compte email ou de synchronisation des emails, suivez cette liste de vérification pour enquêter et résoudre les problèmes courants.

1. Vérifier le journal d'activité​

Allez dans Utilities → Activity Log dans Perfex CRM pour consulter les messages d'erreur liés aux échecs de connexion IMAP ou de synchronisation.

2. Activer le mode debug​

Pour obtenir une sortie d'erreur plus détaillée :

  1. Ouvrez index.php à la racine de votre installation Perfex CRM
  2. Localisez la ligne :
define('ENVIRONMENT', 'production');
  1. Remplacez-la par :
define('ENVIRONMENT', 'development');
  1. Enregistrez le fichier et rechargez la page pour voir les messages d'erreur bruts
attention

N'oubliez pas de le remettre à production après les tests !

3. Inspecter les journaux d'erreur de l'hébergement​

Si l'écran devient vide ou qu'aucune erreur n'apparaît dans Perfex :

  1. Accédez à votre panneau de contrôle d'hébergement web (ex. cPanel ou Plesk)
  2. Cherchez "Error Log", généralement dans la section "Metrics" ou "Logs"
  3. Recherchez les erreurs récentes comme "memory exhausted", "timeout" ou problèmes IMAP

4. Vérifier la configuration Cron​

Assurez-vous que vos tâches cron s'exécutent. Sans elles, le module Mailbox ne peut pas synchroniser les emails.

Consultez la documentation de Perfex CRM ou votre administrateur serveur pour le dépannage cron.

5. OAuth vs authentification par mot de passe​

Le module Mailbox prend en charge deux méthodes d'authentification :

Authentification OAuth2 (Recommandée)​

Pour les utilisateurs Gmail et Outlook, OAuth2 est la méthode recommandée. Elle est plus sécurisée et ne nécessite pas de stocker les mots de passe.

Problèmes OAuth courants :

ProblèmeSolution
"OAuth connection failed"Vérifiez les identifiants OAuth dans Setup → Settings → Mailbox Settings. Vérifiez la configuration du redirect URI. Assurez-vous que l'app OAuth a les scopes requis.
"Token expired"Les tokens OAuth sont automatiquement rafraîchis. Essayez de déconnecter et reconnecter. Pour Gmail : les tokens expirent après 7 jours pour les apps non vérifiées.
"OAuth not available"OAuth n'est disponible que pour Gmail et Outlook. Utilisez l'authentification par mot de passe pour les autres fournisseurs.

Authentification par mot de passe​

Pour les fournisseurs email qui ne prennent pas en charge OAuth2, utilisez l'authentification par mot de passe.

Vérifiez si votre fournisseur email nécessite un mot de passe d'application

Certains fournisseurs email, comme Gmail, Yahoo et Outlook, exigent l'utilisation d'un mot de passe d'application au lieu de votre mot de passe de compte email réel - surtout si la 2FA (authentification à deux facteurs) est activée.

Exemple : Utilisateurs Gmail

  1. Allez sur https://myaccount.google.com/security
  2. Activez la vérification en deux étapes, si ce n'est pas déjà fait
  3. Sous "Connexion à Google", localisez Mots de passe des applications
  4. Générez un nouveau mot de passe d'application pour "Mail"
  5. Utilisez ce mot de passe dans Mailbox Config du module au lieu de votre mot de passe Gmail normal
attention

Le fait de ne pas utiliser un mot de passe d'application lorsqu'il est requis entraînera des erreurs d'authentification ou des tentatives de connexion bloquées.

astuce

Pour Gmail et Outlook, nous recommandons fortement d'utiliser OAuth2 au lieu des mots de passe d'application pour plus de sécurité et de facilité. Voir Configuration OAuth Gmail ou Configuration OAuth Outlook.

6. Paramètres par personnel vs globaux​

Le module prend en charge les paramètres IMAP par personnel et globaux :

  • Paramètres par personnel : Chaque membre du personnel peut configurer son propre serveur IMAP, port, chiffrement et mappages de dossiers
  • Paramètres globaux : Paramètres de repli utilisés lorsque les paramètres par personnel ne sont pas configurés

Si les emails ne se synchronisent pas :

  1. Vérifiez votre page Mailbox Config pour les paramètres par personnel
  2. Vérifiez que le serveur IMAP, le port et le chiffrement sont corrects
  3. Vérifiez les mappages de dossiers (surtout si vous utilisez des noms de dossiers non standard)
  4. Consultez le journal d'activité pour les messages d'erreur spécifiques

7. Problèmes de synchronisation du statut de lecture​

Si vous avez activé "Sync Read Status to Email Server" mais que les modifications ne se reflètent pas dans Gmail/Outlook :

  • Anciens emails : Les emails importés avant la version 2.1.7 peuvent ne pas avoir l'UID stocké. Seuls les nouveaux emails synchroniseront le statut de lecture.
  • UID manquant : Vérifiez le journal d'activité pour les messages "Email ID XXX has no UID stored" (c'est normal pour les anciens emails).
  • OAuth requis : La synchronisation du statut de lecture fonctionne mieux avec l'authentification OAuth.
  • Synchronisation manuelle : Utilisez le bouton Manual Sync dans Settings pour tester la connexion.

Besoin d'aide supplémentaire ?​

Si vous êtes bloqué ou ne parvenez pas à résoudre un problème, notre équipe support est là pour vous aider. Veuillez ouvrir un ticket via le Portail de support Themesic, et nous vous assisterons dès que possible.