Sorun giderme

Bu sayfayı sırayla izleyin. İlk üç bölüm, destek isteklerinin ezici çoğunluğunu kapsar.

Her şeyden önce WHMCS'de Addons > Perfex CRM Bridge sayfasını açın ve Setup checklist bölümünü okuyun. Bu liste doğrudan sorunu göstermek için tasarlanmıştır ve her satır Yapılandırma sayfasında açıklanmıştır.

Hızlı başvuru

Belirti	En olası neden	Çözüm
Modül WHMCS Addons menüsünde yok	Access Control altında hiçbir yönetici rolü işaretlenmemiş	Access Control kutusunu işaretleyin
Her gönderim anında başarısız oluyor	Perfex URL'si http:// ile başlıyor	HTTPS kullanın
Perfex gelen kaydında auth.rejected satırları	Paylaşılan gizli anahtar eşleşmiyor	Yeniden eşleştirin
Perfex giden kuyruğunda "Two-way sync requires Pro"	WHMCS tarafı Ücretsiz planda	Pro'yu etkinleştirin
Olaylar kuyruğa giriyor ama hiçbiri teslim edilmiyor	Senkronizasyon duraklatılmış ya da WHMCS cron'u çalışmıyor	Cron'u kontrol edin
Bir fatura hiç ulaşmıyor ve sürekli yeniden deneniyor	Fatura para birimi Perfex'te yok	Para birimini ekleyin
Lisans etkinleşmiyor	Anahtar eksik ya da lisanslama hizmetine bağlantı yok	Bildirim rengini okuyun
Perfex sayfasında Connection code yok	Perfex HTTPS üzerinde değil ya da kaydedilen gizli anahtar çok kısa	Generate ve Save
Departman eşlemesi açılır liste yerine metin alanı gösteriyor	Ücretsiz plan ya da Perfex'ten WHMCS'ye erişilemiyor	Eşleme yedek davranışları
Satırlar dead durumunda takılı	Aynı nedenle 15 başarısız deneme	Ölü satırları yeniden çalıştırın

Modül Addons menüsünde yok

Belirti. System Settings > Addon Modules altında Perfex CRM Bridge modülünü etkinleştirdiniz, WHMCS etkinleştirildiğini söyledi ama modül soldaki Addons menüsünün hiçbir yerinde yok.

Neden. Hiçbir yönetici rolüne erişim verilmemiş. WHMCS, işaretlenmemiş her rolden bir eklenti modülünü tamamen gizler; bu nedenle modül kurulu ve tamamen çalışır durumdadır ama yönetim alanının hiçbir yerinde ona giden bir bağlantı yoktur. Bu, açık ara en sık gelen "kurulmadı" bildirimidir.

Çözüm.

1. System Settings > Addon Modules bölümüne gidin.
2. Perfex CRM Bridge yanındaki Configure düğmesine tıklayın.
3. Access Control altında Full Administrator rolünü ve modülü kullanması gereken diğer rolleri işaretleyin.
4. Save Changes düğmesine tıklayın.
5. Yönetim alanını yenileyin. Modül artık Addons altında görünür.

O Configure ekranında başka hiçbir şey yoktur

Gerçek ayarların tamamı Addons > Perfex CRM Bridge adresindeki modülün kendi sayfasındadır. Configure ekranında yalnızca Access Control kalır, çünkü onu WHMCS çekirdeği oluşturur ve başka bir yere taşınamaz.

Her gönderim anında başarısız oluyor ya da URL reddediliyor

Belirti. Olaylar kuyruğa giriyor ve anında başarısız oluyor. Recent activity kaydı bağlantı hatalarıyla doluyor. Ya da Perfex CRM URL alanı hiç kaydedilmiyor.

Neden. HTTPS tasarım gereği zorunludur. HTTP aktarımı https protokolüne sabitlenmiştir ve TLS sertifikasını doğrular. Bir http:// adresi her gönderimde başarısız olur; Perfex tarafındaki WHMCS URL alanı da aynı şekilde https:// ile başlamadıkça kaydedilmez.

Çözüm.

1. WHMCS tarafında Perfex CRM URL ayarını bir https:// adresine getirin.
2. Perfex tarafında WHMCS URL ayarını bir https:// adresine getirin.
3. Her iki sertifikanın da yalnızca tarayıcınızda değil, karşı sunucudan gerçekten doğrulandığından emin olun. Kendinden imzalı bir sertifika yalnızca çağrıyı yapan sunucu ona güveniyorsa çalışır.
4. WHMCS modül sayfasındaki Test Connection düğmesine tıklayın.

HTTPS doğrulamasını kapatacak bir ayar yoktur

Bu bilinçli bir tercihtir. Paylaşılan gizli anahtarınız ve müşteri verileriniz bu kanaldan geçer. Bir sertifika doğrulanmıyorsa sertifikayı düzeltin.

Perfex kaydındaki auth.rejected satırları

Belirti. WHMCS HTTP 401 hataları bildiriyor. Perfex'te Setup > WHMCS Bridge > Recent inbound events kırmızı auth.rejected satırları gösteriyor.

Neden. Paylaşılan gizli anahtar iki tarafta eşleşmiyor ya da istek zaman damgası 300 saniyelik pencerenin dışında. Uygulamada neredeyse her zaman sorun gizli anahtardadır: biri bir tarafta anahtarı yeniden üretmiş ve diğer tarafı hiç yeniden eşleştirmemiştir.

Hızlı çözüm.

1. Perfex'te Setup > WHMCS Bridge sayfasında mevcut Connection code değerini kopyalayın.
2. WHMCS'de Addons > Perfex CRM Bridge sayfasında kodu Re-pair kutusuna yapıştırın ve Connect düğmesine tıklayın.
3. Test Connection düğmesine tıklayın. Yeşil "Connection OK" bildirimini görmelisiniz.
4. Run Sync Now düğmesine tıklayın. Başarısız olan kuyruktaki olaylar artık teslim edilir.

Elle çözüm. Tam olarak aynı gizli anahtarı her iki Shared Secret alanına yeniden yapıştırın ve iki tarafta da kaydedin. Baştaki ve sondaki boşluklar otomatik olarak kırpılır, ancak aradaki her şey karakter karakter eşleşmelidir.

Sorun gizli anahtar değilse. Her iki sunucunun saatini kontrol edin. Aralarındaki 300 saniyeden fazla sapma, her isteğin tekrar oynatma sayılarak reddedilmesine yol açar. Her iki sunucuyu da NTP ile senkronize edin.

Reddedilen satırlar hız sınırlıdır

Perfex dakikada en fazla 10 auth.rejected satırı kaydeder; böylece yanlış yapılandırılmış bir gönderici diskinizi dolduramaz. Bir dakika içinde tam olarak 10 satır görüyorsanız daha fazlası olduğunu varsayın.

Perfex giden kuyruğunda "Two-way sync requires Pro"

Belirti. Perfex'te bir müşteriyi düzenliyorsunuz. Setup > WHMCS Bridge sayfasındaki Outbound queue paneli o satırı "Two-way sync requires Pro on the WHMCS side." mesajı ve bir Upgrade to Pro bağlantısıyla gösteriyor. Deneme sayısı artıyor ve satır sonunda ölüyor.

Neden. Çift yönlü senkronizasyon bir Pro özelliğidir ve lisans WHMCS tarafındadır. WHMCS kurulumunuz Ücretsiz planda olduğu için gelen uç noktası, Perfex kaynaklı her değişikliğe 403 yanıtı verir. Perfex tamamlayıcısı kuyruğa alıp yeniden deneyerek doğru davranmaktadır.

Çözüm. WHMCS tarafında bir Pro lisansı etkinleştirin. Lisanslama ve Pro etkinleştirme sayfasına bakın. Pro etkinleştiğinde WHMCS yeni plan durumunu anında Perfex'e gönderir, yükseltme uyarısı kaybolur ve bekleyen satırlar bir sonraki Perfex cron çalışmasında teslim edilir.

Siz Ücretsiz plandayken zaten dead durumuna geçmiş satırlar kendiliğinden yeniden denenmez. Dead durumunda takılı satırlar bölümüne bakın.

Önce plan paneline bakın

WHMCS plan paneli tam da bu nedenle Perfex ayarlar sayfasında Outbound queue'nun hemen üstünde yer alır. Panel Free diyorsa tek bir kuyruk satırı okumadan yanıtınızı almışsınız demektir.

Hiçbir şey senkronize edilmiyor

Belirti. Olaylar kuyrukta görünüyor, Queue pending sayısı artıyor ve Perfex'e hiçbir şey ulaşmıyor. Hata da yok, yalnızca sessizlik.

İki olası neden vardır ve kontrol listesi bunları birbirinden ayırır.

Neden A: senkronizasyon duraklatılmış

Sync enabled kontrol listesi satırı kırmızıdır.

Çözüm. WHMCS modül sayfasında Settings > Sync behaviour altında Enable Sync kutusunu işaretleyin ve Save Settings düğmesine tıklayın. Duraklatma sırasında hiçbir şey kaybolmadı; olaylar kuyruğa alınmaya devam etti ve şimdi teslim edilecekler.

Neden B: WHMCS sistem cron'u çalışmıyor

Cron delivering kontrol listesi satırı kırmızı ya da turuncudur.

Çözüm.

1. Run Sync Now düğmesine tıklayarak köprünün kendisinin çalıştığını kanıtlayın. Kuyruğunuz boşalıyorsa teslimat sorunsuzdur ve sorun gerçekten cron'dadır.
2. WHMCS'nin kendi cron durumunu Utilities > System > System Health Status altında kontrol edin. WHMCS, sistem cron'unun en son ne zaman çalıştığını bildirir.
3. Cron yakın zamanda çalışmadıysa sorunu sunucu düzeyinde giderin. WHMCS cron komutu, hosting panelinizin cron yöneticisinde ya da sunucunuzun crontab dosyasında bulunur. WHMCS'nin kendi belgeleri sürümünüz için tam komutu verir.
4. Cron yeniden çalışmaya başladığında Cron delivering satırı, gerçek köprü işi yapıldıktan sonraki ilk sayfa yüklemesinde yeşile döner.

Run Sync Now cron satırını yeşile döndüremez

Bu satır bilinçli olarak yalnızca gerçek WHMCS sistem cron etkinliğini izler, çünkü "kimse izlemezken de çalışmaya devam edecek mi?" sorusuna yanıt verir. Bir düğmeye basmak bu soruyu yanıtlayamaz. Run Sync Now çalışıyor ama satır saatlerce kırmızı kalıyorsa cron'unuz çalışmıyordur.

Turuncu bir cron satırı her zaman sorun değildir

Satır gerçek köprü işini izler: kuyruk boşaltma, kayıt temizleme ve mutabakat. Senkronize edilecek değişikliği olmayan, sağlıklı ama boşta bir kurulum, düzeltilecek hiçbir şey yokken turuncu kalabilir.

Bir fatura takılıyor ve Perfex'e hiç ulaşmıyor

Belirti. Bir fatura tekrar tekrar başarısız oluyor. Kayıt mesajı bir para biriminden söz ediyor ve satır giderek artan bir gecikmeyle yeniden denenmeye devam ediyor.

Neden. Faturanın para birimi Perfex'te yapılandırılmamış. Perfex faturayı haklı olarak reddeder, çünkü tanımadığı bir para biriminde toplam kaydedemez.

Çözüm.

1. Perfex'te Setup > Finance > Currencies bölümüne gidin.
2. Para birimini, WHMCS'nin kullandığı ISO koduyla birebir aynı olacak şekilde ekleyin, örneğin EUR veya USD.
3. Başka hiçbir şey yapmayın. Kuyruktaki olay kendi programına göre yeniden denenir ve bir sonraki denemede başarılı olur.

Yaklaşık 40 saatiniz var

Yeniden deneme programı, kabaca 40 saate yayılan 15 denemeye izin verir. Para birimini bu pencere içinde ekleyin, aksi halde satır ölü mektuba düşer ve elle yeniden çalıştırılması gerekir. Geçmişe ait faturaları geri doldurmak üzereyseniz, müşterilerinizin kullandığı her para birimini önce ekleyin.

İlgili durum: "Not mapped (will retry)"

Bir alt kayıt, üst kaydından önce gelmiştir: müşterisi henüz Perfex'te olmayan bir kişi, müşterisi henüz eşlenmemiş bir fatura ya da destek talebi henüz senkronize edilmemiş bir yanıt.

Bu durum normalde kendi kendine düzelir. Kuyruk sırayla teslim eder, üst kayıt gelir ve alt kayıt bir sonraki denemesinde başarılı olur. Yalnızca üst kayıt hiçbir zaman senkronize edilmeyecekse gerçek bir soruna dönüşür, örneğin müşterileri geri doldurmadan hizmetleri geri doldurduğunuzda. Bu durumda üst kaydı kuyruğa alın (WHMCS'de müşteriyi düzenleyip kaydedin ya da bir Clients geri doldurması çalıştırın); alt kayıtlar onu izleyecektir.

Lisans etkinleşmiyor

Belirti. Bir anahtar yapıştırdınız ama kurulum hâlâ Free gösteriyor.

Pro için iki şey gerekir: geçerli bir anahtar ve WHMCS sunucunuzdan lisanslama hizmetine bağlantı. Bildirim rengini okuyun, çünkü hangisinin eksik olduğunu size o söyler.

Bildirim	Anlamı	Çözüm
🔴 Kırmızı	Lisanslama sunucusu anahtarı açıkça reddetti ve mesaj nedenini belirtiyor.	Anahtarı satın alma e-postasından tek seferde yeniden kopyalayın. Anahtarlar 32 karakterdir ve noktalama işareti içerebilir; bu nedenle hiçbir şeyi kırpmayın veya yeniden biçimlendirmeyin. Mesaj kurulumlardan ya da bir kotadan söz ediyorsa, artık ihtiyaç duymayan bir kurulumdan anahtarı kaldırarak bir etkinleştirme kotası serbest bırakın.
🟠 Turuncu	Sunucunuz lisanslama hizmetine ulaşamadı. Bu bir ret değildir.	Anahtar kaydedilmiştir ve yeniden denemeler sürer. WHMCS sunucusundaki çıkış güvenlik duvarı veya proxy üzerinden api.freemius.com adresine giden HTTPS trafiğine izin verin. Ardından Check licence now düğmesine tıklayın.
⚪ Hiç bildirim yok	Zaten saklanan anahtarın aynısını kaydettiniz, bu nedenle yeniden kontrol yapılmadı.	Check licence now düğmesine tıklayın.
Başlıkta "awaiting first verification" yazıyor	Bir anahtar saklanmış ama hiç onaylanmamış.	Check licence now düğmesine tıklayın.

Diğer kontroller:

• Anahtarın, WHMCS Configure ekranında bir yerde değil, modülün kendi sayfasındaki Settings > Pro licence altında yer alan Pro License Key alanında olduğundan emin olun.
• Check licence now düğmesine basın ve basışlar arasında birkaç saniye bekleyin. Hızlı bir ikinci basış, istek göndermeden "checked a moment ago" yanıtını verir.
• WHMCS'de Pro etkin ama Perfex hâlâ Free gösteriyorsa, WHMCS'de Check licence now veya Test Connection düğmesine basın. İkisi de plan durumunu anında Perfex'e iletir. Ardından Perfex ayarlar sayfasını yeniden yükleyin.

Tüm ayrıntılar Lisanslama ve Pro etkinleştirme sayfasındadır.

Perfex'te Connection code görünmüyor

Belirti. Setup > WHMCS Bridge sayfasındasınız, bir gizli anahtar kaydettiniz ama Connection code alanı yok, yalnızca gri bir not var.

Nedenler ve çözümler. Hangisinin geçerli olduğunu notun kendisi söyler.

Not	Neden	Çözüm
"not served over HTTPS"	Eşleştirme, HTTPS üzerinde çalışan bir Perfex kurulumu gerektirir.	Sertifikayı düzeltin ya da manuel kurulumu kullanın.
"shorter than 32 characters"	Kaydedilmiş gizli anahtar çok kısa. En yaygın neden, Generate düğmesine tıklayıp Save düğmesine tıklamamaktır.	Generate, ardından Save düğmesine tıklayın. Kod sayfa yeniden yüklendiğinde görünür.

Eşleştirme "the shared secret does not match" hatasıyla başarısız oluyor

Belirti. WHMCS'ye bir Connection code yapıştırdınız ve HTTP 401 hatasından söz eden kırmızı bir bildirim aldınız.

Neden. Kod, Perfex'te artık bulunmayan bir gizli anahtar taşıyor. Bu neredeyse her zaman, daha sonra yapılan bir Generate ve Save işleminden önce kopyalanmış bir koddan ya da hiç kaydedilmemiş bir Generate işleminden kaynaklanır.

Çözüm. Perfex'te ayarlar sayfasında Save düğmesine tıklayarak mevcut gizli anahtarın gerçekten saklandığından emin olun, yeni bir Connection code kopyalayın ve onu yapıştırın. Başarısız deneme WHMCS tarafında hiçbir şey kaydetmediği için önceki çalışan yapılandırmanız bozulmamıştır.

Departman eşlemesi açılır liste yerine metin alanı gösteriyor

Belirti. Perfex ayarlar sayfası, departman eşlemesi için WHMCS departmanı başına bir açılır liste yerine sade bir metin alanı gösteriyor.

Neden. Sayfa, WHMCS destek departmanı dizininizi alamadı. Metin alanının altındaki ipucu hangi durumun geçerli olduğunu söyler:

İpucu	Neden	Çözüm
"Couldn't fetch WHMCS departments (needs Pro + working connection)"	Köprü yapılandırılmamış, WHMCS'ye Perfex sunucusundan erişilemiyor ya da WHMCS Ücretsiz planda. Dizin, destek talebi senkronizasyonuyla aynı lisans kapısının arkasındadır.	Eşleştirmeyi tamamlayın, Perfex'in WHMCS adresinize HTTPS üzerinden erişebildiğini kontrol edin ve Pro'yu etkinleştirin.
"Connection OK, but WHMCS has no support departments yet"	Veri alımı çalıştı; eşlenecek bir şey yok.	WHMCS'de Support > Support Departments altında departman oluşturun, ardından Perfex sayfasını yeniden yükleyin.

Bu arada manuel whmcs_deptid=perfex_department_id metin alanı, her satırda bir eşleme olacak şekilde her zaman çalışır. Bu durum senkronizasyonu engellemez: eşlenmemiş bir destek talebi varsayılan departmanınıza ya da en küçük Perfex departman ID'sine düşer.

Dead durumunda takılı satırlar

Belirti. WHMCS modül sayfasındaki Dead events sayacı ya da Perfex Outbound queue panelindeki ölü sayısı sıfırın üzerinde.

Neden. Bu satırlar kabaca 40 saat boyunca aynı nedenle 15 kez başarısız oldu. Ölü satırlar, inceleyebilmeniz için bilinçli olarak asla otomatik yeniden denenmez ve asla temizlenmez.

Çözüm.

1. Nedenini öğrenin. WHMCS'de Recent activity panelini ya da Perfex'te Outbound queue'nun "Last error" sütununu açın ve etkilenen satırlardaki hatayı okuyun. Neden neredeyse her zaman şunlardan biridir: Perfex'te eksik bir para birimi, gizli anahtar uyuşmazlığı, bir Pro olayını engelleyen Ücretsiz plan ya da Perfex'in çevrimdışı olmuş olması.

2. Önce kök nedeni giderin. Nedeni gidermeden bir satırı yeniden çalıştırmak yalnızca 40 saat daha harcar.

3. İşi yeniden kuyruğa alın. En güvenli yol veritabanı erişimi gerektirmez:

   • Müşteriler, kişiler, faturalar, hizmetler ve alan adları için olayı yeniden tetikleyin. Kaydı WHMCS'de düzenleyip kaydedin ya da geri doldurma sihirbazını Only new (not yet synced) modunda çalıştırın.
   • Perfex tarafı değişiklikler için, yeni bir olay oluşturmak üzere Perfex kaydını yeniden düzenleyin.

4. Orijinal satırı yeniden çalıştırmayı tercih ediyorsanız ve veritabanı erişiminiz varsa satırı pending durumuna döndürün. Önce bir yedek alın:

   UPDATE mod_perfexbridge_outbox
      SET status = 'pending', attempts = 0, next_attempt_ts = 0
    WHERE id = 123;

   123 yerine yeniden çalıştırmak istediğiniz satırın ID'sini yazın. Perfex tarafındaki karşılığı, kendi Perfex tablo önekinizle birlikte tblwhmcs_bridge_outbox tablosudur.

Perfex'teki bir değişiklik WHMCS'ye hiç ulaşmıyor

Şu listeyi sırayla izleyin:

1. WHMCS tarafı Pro mu? Perfex ayarlar sayfasındaki WHMCS plan panelini kontrol edin. Çift yönlü senkronizasyon yalnızca Pro'dadır.
2. Perfex tarafında WHMCS URL ayarlanmış mı? Setup > WHMCS Bridge > WHMCS URL, HTTPS ve sonunda yol olmadan. Eşleştirme bunu normalde ilk eşleşmede doldurur, ancak zaten dolu olan bir değerin asla üzerine yazmaz.
3. Perfex sunucusu WHMCS'ye HTTPS üzerinden erişebiliyor mu? Perfex gönderim istemcisi de tıpkı WHMCS tarafı gibi HTTPS'i şart koşar ve sertifikayı doğrular.
4. Perfex cron'u çalışıyor mu? Perfex kaynaklı değişiklikler WHMCS cron'uyla değil, Perfex cron'uyla teslim edilir. Perfex cron görevinizi kontrol edin.
5. Kayıt eşlenmiş mi? Yalnızca WHMCS'den senkronize edilmiş müşteriler eşlenmiştir. Doğrudan Perfex'te oluşturulan bir müşterinin WHMCS'de karşılığı yoktur ve asla gönderilmez. Aynı şekilde doğrudan Perfex'te oluşturulan destek talepleri de Perfex'te kalır.
6. Outbound queue panelini okuyun. Satır başına son hatayı belirtir.

Bir değişiklik geri gelip düzenlememin üzerine yazdı

Belirti. Bir sistemde bir kaydı düzenlediniz ve kayıt diğer sistemdeki değerine geri döndü.

Neden. Son senkronizasyondan bu yana iki taraf da aynı kaydı değiştirdi ve Two-Way Conflict Policy ayarınız kazananı belirledi.

Çözüm. WHMCS modül sayfasında Settings > Sync behaviour altında ekibinizin çalışma şekline uyan politikayı seçin:

• newest_wins (varsayılan) - daha yeni olan düzenleme kazanır. Her iki sunucunun saatinin de doğru olmasını gerektirir.
• whmcs_wins - her zaman WHMCS esastır.
• perfex_wins - her zaman Perfex esastır.

Her iki sunucunun saati sizin kontrolünüz dışındaysa newest_wins seçeneğinden kaçının: saat kayması, bu seçeneğin kararlarını kayma miktarı kadar değiştirir.

Müşteriler tek bir destek talebi yanıtı için iki e-posta alıyor

Belirti. Bir Perfex personeli, senkronize edilmiş bir destek talebine yanıt veriyor ve müşteri iki bildirim alıyor.

Neden. Perfex kendi destek talebi yanıt e-postasını gönderir ve WHMCS'ye senkronize edilen yanıt, WHMCS'nin de kendi bildirimini göndermesine yol açar. Bu belgelenmiş bir davranıştır, senkronizasyon döngüsü değil. E-posta bastırma yalnızca WHMCS'den Perfex'e yönünü kapsar.

Çözüm. Müşterileriniz WHMCS müşteri portalını kullanıyorsa, Perfex'teki ticket-reply e-posta şablonunu Setup > Email Templates > Tickets altında devre dışı bırakın.

Hâlâ çözülmediyse: destekle iletişime geçmeden önce toplanacaklar

Şunları hazır bulundurun, yanıt genellikle ilk mesajda gelir:

• Her iki modülün sürümü, şu anda 1.3.4, ve iki tarafın da aynı sürümde olduğunun doğrulanması.
• WHMCS sürümü, Perfex CRM sürümü ve her iki sunucudaki PHP sürümü.
• WHMCS modül sayfasındaki Setup checklist bölümünün ekran görüntüsü.
• Queue pending ve Dead events sayıları.
• WHMCS'deki Recent activity ve Perfex'teki Recent inbound events panellerinden ilgili satırlar, mesaj sütunu tam olarak görünecek şekilde.
• Hata oluştuğunda ne yaptığınız ve daha önce hiç çalışıp çalışmadığı.

Paylaşılan gizli anahtarınızı veya Connection code'unuzu asla göndermeyin

Connection code paylaşılan gizli anahtarınızı içerir. İkisinin de bir destek talebinde, ekran görüntüsünde veya sohbet mesajında yeri yoktur. Destek ekibi bir sorunu teşhis etmek için bunların hiçbirine ihtiyaç duymaz.