Ana içeriğe geç

Troubleshooting

E-posta hesabınıza bağlanma veya e-postaları senkronize etme konusunda sorun yaşıyorsanız, yaygın sorunları araştırmak ve çözmek için bu kontrol listesini izleyin.

1. Check the Activity Log​

IMAP bağlantısı veya senkronizasyon hatalarıyla ilgili hata mesajlarını görüntülemek için Perfex CRM içinde Utilities → Activity Log'a gidin.

2. Enable Debug Mode​

Daha ayrıntılı hata çıktısı almak için:

  1. Perfex CRM kurulumunuzun kök dizinindeki index.php dosyasını açın
  2. Şu satırı bulun:
define('ENVIRONMENT', 'production');
  1. Şu şekilde değiştirin:
define('ENVIRONMENT', 'development');
  1. Dosyayı kaydedin ve ham hata mesajlarını görmek için sayfayı yenileyin
uyarı

Test ettikten sonra tekrar production olarak değiştirmeyi unutmayın!

3. Inspect Your Hosting Error Logs​

Ekran boş kalıyorsa veya Perfex'te hata görünmüyorsa:

  1. Web barındırma kontrol panelinize (örn. cPanel veya Plesk) erişin
  2. Genellikle "Metrics" veya "Logs" bölümünde "Error Log" arayın
  3. "memory exhausted", "timeout" veya IMAP ile ilgili hatalar için son kayıtları tarayın

4. Double-Check Cron Setup​

Cron işlerinizin çalıştığından emin olun. Cron olmadan Mailbox modülü e-postaları senkronize edemez.

Cron sorun giderme için Perfex CRM dokümantasyonuna veya sunucu yöneticinize başvurun.

5. OAuth vs Password Authentication​

Mailbox modülü iki kimlik doğrulama yöntemini destekler:

Gmail ve Outlook kullanıcıları için OAuth2 önerilir. Daha güvenlidir ve parola depolama gerektirmez.

Yaygın OAuth sorunları:

IssueSolution
"OAuth connection failed"Setup → Settings → Mailbox Settings'te OAuth kimlik bilgilerini doğrulayın. Redirect URI yapılandırmasını kontrol edin. OAuth uygulamasının gerekli kapsamları olduğundan emin olun.
"Token expired"OAuth tokenleri otomatik olarak yenilenir. Bağlantıyı kesip yeniden bağlanmayı deneyin. Gmail için: doğrulanmamış uygulamalarda tokenler 7 gün sonra sona erer.
"OAuth not available"OAuth yalnızca Gmail ve Outlook için kullanılabilir. Diğer sağlayıcılar için parola kimlik doğrulaması kullanın.

Password Authentication​

OAuth2 desteklemeyen e-posta sağlayıcıları için parola kimlik doğrulaması kullanın.

E-posta sağlayıcınızın App Password gerektirip gerektirmediğini kontrol edin

Gmail, Yahoo ve Outlook gibi bazı e-posta sağlayıcıları, özellikle 2FA (İki Faktörlü Kimlik Doğrulama) etkinse, gerçek e-posta hesabı parolanız yerine App Password kullanmanızı gerektirir.

Örnek: Gmail kullanıcıları

  1. https://myaccount.google.com/security adresine gidin
  2. Zaten etkin değilse 2-Step Verification'ı etkinleştirin
  3. "Signing in to Google" altında App Passwords'u bulun
  4. "Mail" için yeni bir uygulama parolası oluşturun
  5. Normal Gmail parolanız yerine modülün Mailbox Config'inde bu parolayı kullanın
uyarı

Gerekli olduğunda App Password kullanmamak kimlik doğrulama hatalarına veya giriş engellemelerine yol açar.

ipucu

Gmail ve Outlook için daha iyi güvenlik ve kullanım kolaylığı için App Password yerine OAuth2 kullanmanızı şiddetle öneririz. Gmail OAuth Setup veya Outlook OAuth Setup bölümüne bakın.

6. Per-Staff vs Global Settings​

Modül hem personel bazlı hem de global IMAP ayarlarını destekler:

  • Per-Staff Settings: Her personel üyesi kendi IMAP sunucusu, portu, şifrelemesi ve klasör eşlemelerini yapılandırabilir
  • Global Settings: Personel bazlı ayarlar yapılandırılmadığında kullanılan yedek ayarlar

E-postalar senkronize olmuyorsa:

  1. Personel bazlı ayarlar için Mailbox Config sayfasını kontrol edin
  2. IMAP sunucusu, port ve şifrelemenin doğru olduğunu doğrulayın
  3. Klasör eşlemelerini kontrol edin (özellikle standart dışı klasör adları kullanıyorsanız)
  4. Belirli hata mesajları için Activity Log'u inceleyin

7. Read Status Sync Issues​

"Sync Read Status to Email Server" etkinleştirildiğinde değişiklikler Gmail/Outlook'ta yansımıyorsa:

  • Eski e-postalar: 2.1.7 sürümünden önce içe aktarılan e-postalarda UID saklanmamış olabilir. Yalnızca yeni e-postalar okundu durumunu senkronize eder.
  • UID missing: Activity Log'ta "Email ID XXX has no UID stored" mesajlarını kontrol edin (eski e-postalar için normal)
  • OAuth required: Okundu durumu senkronizasyonu OAuth kimlik doğrulamasıyla en iyi çalışır
  • Manual sync: Bağlantıyı test etmek için Settings'deki Manual Sync düğmesini kullanın

Still Need Help?​

Takıldıysanız veya bir sorunu çözemiyorsanız, destek ekibimiz yardımcı olmaya hazır. Themesic Support Portal üzerinden bilet oluşturun, en kısa sürede yardımcı olacağız.