Zum Hauptinhalt springen

Fehlerbehebung

Wenn Sie Probleme mit der Verbindung zu Ihrem E-Mail-Konto oder der E-Mail-Synchronisierung haben, folgen Sie dieser Checkliste zur Untersuchung und Behebung häufiger Probleme.

1. Aktivitätsprotokoll prüfen​

Gehen Sie zu Utilities → Activity Log in Perfex CRM, um Fehlermeldungen im Zusammenhang mit IMAP-Verbindung oder Synchronisierungsfehlern anzuzeigen.

2. Debug-Modus aktivieren​

Für detailliertere Fehlerausgabe:

  1. Öffnen Sie index.php im Stammverzeichnis Ihrer Perfex-CRM-Installation
  2. Suchen Sie die Zeile:
define('ENVIRONMENT', 'production');
  1. Ändern Sie sie zu:
define('ENVIRONMENT', 'development');
  1. Speichern Sie die Datei und laden Sie die Seite neu, um rohe Fehlermeldungen zu sehen
warnung

Ändern Sie es nach dem Test wieder auf production!

3. Hosting-Fehlerprotokolle prüfen​

Wenn der Bildschirm leer wird oder keine Fehler in Perfex erscheinen:

  1. Greifen Sie auf Ihr Web-Hosting-Control-Panel zu (z. B. cPanel oder Plesk)
  2. Suchen Sie nach "Error Log", meist unter dem Abschnitt "Metrics" oder "Logs"
  3. Prüfen Sie auf aktuelle Fehler wie "memory exhausted", "timeout" oder IMAP-bezogene Probleme

4. Cron-Einrichtung überprüfen​

Stellen Sie sicher, dass Ihre Cron-Jobs laufen. Ohne sie kann das Mailbox-Modul keine E-Mails synchronisieren.

Beziehen Sie sich auf die Perfex-CRM-Dokumentation oder Ihren Server-Administrator für die Cron-Fehlerbehebung.

5. OAuth vs. Passwort-Authentifizierung​

Das Mailbox-Modul unterstützt zwei Authentifizierungsmethoden:

OAuth2-Authentifizierung (Empfohlen)​

Für Gmail- und Outlook-Nutzer ist OAuth2 die empfohlene Methode. Sie ist sicherer und erfordert keine Passwort-Speicherung.

Häufige OAuth-Probleme:

IssueSolution
"OAuth connection failed"Überprüfen Sie die OAuth-Anmeldedaten unter Setup → Settings → Mailbox Settings. Redirect-URI-Konfiguration prüfen. Sicherstellen, dass die OAuth-App die erforderlichen Scopes hat.
"Token expired"OAuth-Tokens werden automatisch aktualisiert. Versuchen Sie die Verbindung zu trennen und neu zu verbinden. Bei Gmail: Tokens verfallen nach 7 Tagen bei unverifizierten Apps.
"OAuth not available"OAuth ist nur für Gmail und Outlook verfügbar. Verwenden Sie für andere Anbieter die Passwort-Authentifizierung.

Passwort-Authentifizierung​

Für E-Mail-Anbieter ohne OAuth2-Unterstützung die Passwort-Authentifizierung verwenden.

Prüfen Sie, ob Ihr E-Mail-Anbieter ein App-Passwort benötigt

Einige E-Mail-Anbieter wie Gmail, Yahoo und Outlook verlangen ein App-Passwort statt Ihres tatsächlichen E-Mail-Kontopassworts – besonders wenn 2FA (Two-Factor Authentication) aktiviert ist.

Beispiel: Gmail-Nutzer

  1. Gehen Sie zu https://myaccount.google.com/security
  2. Aktivieren Sie 2-Step Verification, falls noch nicht aktiviert
  3. Unter "Signing in to Google" finden Sie App Passwords
  4. Generieren Sie ein neues App-Passwort für "Mail"
  5. Verwenden Sie dieses Passwort in der Mailbox Config des Moduls statt Ihres normalen Gmail-Passworts
warnung

Die Verwendung eines App-Passworts, wenn erforderlich, führt ohne dessen Nutzung zu Authentifizierungsfehlern oder blockierten Anmeldeversuchen.

tipp

Für Gmail und Outlook empfehlen wir dringend OAuth2 statt App-Passwörter für mehr Sicherheit und Benutzerfreundlichkeit. Siehe Gmail OAuth Setup oder Outlook OAuth Setup.

6. Pro-Mitarbeiter vs. Globale Einstellungen​

Das Modul unterstützt sowohl pro-Mitarbeiter- als auch globale IMAP-Einstellungen:

  • Pro-Mitarbeiter-Einstellungen: Jedes Teammitglied kann eigene IMAP-Server-, Port-, Verschlüsselungs- und Ordner-Zuordnungen konfigurieren
  • Globale Einstellungen: Fallback-Einstellungen, wenn pro-Mitarbeiter-Einstellungen nicht konfiguriert sind

Wenn E-Mails nicht synchronisiert werden:

  1. Überprüfen Sie Ihre Mailbox Config-Seite für pro-Mitarbeiter-Einstellungen
  2. Verifizieren Sie, dass IMAP-Server, Port und Verschlüsselung korrekt sind
  3. Prüfen Sie die Ordner-Zuordnungen (besonders bei nicht standardmäßigen Ordnernamen)
  4. Überprüfen Sie das Aktivitätsprotokoll auf spezifische Fehlermeldungen

7. Gelesen-Status-Sync-Probleme​

Wenn Sie "Sync Read Status to Email Server" aktiviert haben, aber Änderungen nicht in Gmail/Outlook angezeigt werden:

  • Alte E-Mails: Vor Version 2.1.7 importierte E-Mails haben möglicherweise keine gespeicherte UID. Nur neue E-Mails synchronisieren den Gelesen-Status.
  • UID fehlt: Prüfen Sie das Aktivitätsprotokoll auf "Email ID XXX has no UID stored"-Meldungen (bei alten E-Mails normal).
  • OAuth erforderlich: Read-Status-Sync funktioniert am besten mit OAuth-Authentifizierung.
  • Manueller Sync: Verwenden Sie die Schaltfläche Manual Sync in Settings, um die Verbindung zu testen.

Immer noch Hilfe nötig?​

Wenn Sie feststecken oder ein Problem nicht lösen können, hilft unser Support-Team gerne. Bitte erstellen Sie ein Ticket über das Themesic Support Portal, und wir werden uns so schnell wie möglich melden.