Kurulum

Bu sayfa Perfex CRM Integration for WHMCS'in her iki yarısını da kurar. Adımları sırayla izleyin. Tüm süreç iki tarayıcı sekmesi ve hosting panelinizin File Manager aracıyla tamamlanır. SSH veya komut satırı gerekmez.

Elinizde açılmış bir upload.zip ve şu iki dosya olmalıdır:

Dosya	Nereye kurulur
🧩 perfex-module/module.zip	Perfex CRM
⚙️ whmcs-addon/addon.zip	WHMCS

Hızlı kurulum (kısa yol)

Deneyimli bir hosting yöneticisi için tüm iş beş adımdır. Bunları şu sırayla yapın.

1. 🧩 Önce Perfex. Perfex CRM'de Setup > Modules > Upload Module bölümüne gidin, module.zip dosyasını yükleyin, ardından Activate düğmesine tıklayın. Perfex tarafını önce kurmak, WHMCS herhangi bir şey göndermeden önce alıcı uç noktanın var olması anlamına gelir.
2. ⚙️ WHMCS eklentisi. addon.zip dosyasını modules/addons/ içine yükleyip çıkarın; sonuçta modules/addons/perfexbridge/perfexbridge.php elde etmelisiniz, ardından Perfex CRM Bridge'i System Settings > Addon Modules altında etkinleştirin.
3. 🔓 Access Control kutusunu işaretleyin. Eklentinin Configure ekranında Full Administrator rolünü (ve onu kullanması gereken diğer rolleri) işaretleyin ve Save Changes düğmesine tıklayın. Bu yapılmadan modül görünmezdir - Addons menüsünde hiç görünmez.
4. 🔗 İki tarafı eşleştirin. Addons > Perfex CRM Bridge bölümünü açın, Perfex'ten kopyaladığınız Connection code değerini Quick setup kutusuna yapıştırın ve Connect düğmesine tıklayın. Ayrıntılar Yapılandırma bölümünde.
5. ✅ Doğrulayın. WHMCS'de bir test müşterisi oluşturun, Run Sync Now düğmesine tıklayın ve bunun Perfex'te Customers altında göründüğünü doğrulayın.

Her tıklama, her kontrol listesi satırı ve tam uçtan uca doğrulama aşağıdaki Ayrıntılı adım adım kılavuz bölümündedir.

Ayrıntılı adım adım kılavuz

Sıra önemlidir

Önce Perfex tamamlayıcısını kurun. Alıcı uç noktayı o oluşturur. WHMCS eklentisini önce kurup senkronizasyonu başlatırsanız, Perfex tarafı var olana kadar her olay başarısız olur ve henüz sizin yol açmadığınız bir sorunun hata kayıtlarını okumakla vakit kaybedersiniz.

Adım 1: Perfex CRM tamamlayıcısını kurun

Perfex tamamlayıcısı ücretsizdir, lisans anahtarı taşımaz ve tamamen Perfex yönetim alanından kurulur.

1. Perfex CRM'e Administrator olarak giriş yapın.
2. Setup > Modules bölümüne gidin.
3. Upload Module düğmesine tıklayın.
4. Dosya seçicide module.zip dosyasını seçip yükleyin.
5. Perfex modülü WHMCS Bridge olarak listeler. İstenirse Install, ardından Activate düğmesine tıklayın.

Yükleme boyut nedeniyle reddedilirse

Upload Module düğmesi zip dosyasını PHP üzerinden gönderir; bu nedenle sunucunuzun upload_max_filesize ve post_max_size limitlerinin ikisi de dosyadan büyük olmalıdır. Yükleme başarısız olursa ya PHP yapılandırmanızda bu limitleri yükseltin ya da aşağıdaki manuel yöntemi kullanın.

Manuel yöntem: module.zip dosyasını kendi bilgisayarınızda açın ve elde ettiğiniz whmcs_bridge klasörünü FTP veya hosting panelinizin File Manager aracıyla Perfex kurulumunuzun modules/ dizinine yükleyin. Sonuç modules/whmcs_bridge/whmcs_bridge.php olmalıdır. Ardından Setup > Modules bölümüne dönüp Activate düğmesine tıklayın.

Perfex tarafının doğru kurulduğunu doğrulayın

• Perfex Setup menüsü altında yeni bir WHMCS Bridge girişi görünür. Bir sonraki bölümde paylaşılan gizli anahtarı bu sayfada oluşturacaksınız.

Adım 2: WHMCS eklentisini kurun

WHMCS'de yönetim panelinden çalışan bir modül yükleyici yoktur. Dosyaları diske kendiniz yerleştirir, ardından yönetim alanından etkinleştirirsiniz. Hosting panelinizin File Manager aracı bunun tamamını yapar.

1. Hosting panelinizin File Manager aracını açın ve WHMCS kurulumunuzun modules/addons/ dizinine gidin.
2. addon.zip dosyasını modules/addons/ içine yükleyin.
3. Yüklenen dosya üzerinde File Manager'ın Extract işlemini kullanarak aynı modules/addons/ dizinine çıkarın.
4. Sonucun modules/addons/perfexbridge/perfexbridge.php olduğunu doğrulayın. Elinizde modules/addons/perfexbridge/perfexbridge/perfexbridge.php oluştuysa, arşiv bir seviye fazla iç içe çıkarılmıştır. İçteki klasörü bir üste taşıyın ve boş kalan sarmalayıcıyı silin.
5. Çıkarma işlemi başarılı olduktan sonra yüklenen addon.zip dosyasını sunucudan silin.

FTP alternatifi

addon.zip dosyasını önce kendi bilgisayarınızda açın, ardından elde ettiğiniz perfexbridge klasörünü FTP ile modules/addons/ dizinine yükleyin. Sonuç tamamen aynıdır.

Şimdi etkinleştirin:

6. WHMCS'de System Settings > Addon Modules bölümüne gidin.
7. Listede Perfex CRM Bridge girişini bulun ve Activate düğmesine tıklayın.

Adım 3: Access Control kutusunu işaretleyin, aksi halde modül görünmez kalır

En sık gelen "kurulmadı" bildirimi budur

Etkinleştirmenin ardından WHMCS, yönetici rollerinizi listeleyen bir Access Control bölümüyle birlikte modülün yapılandırma panelini gösterir. En azından Full Administrator rolünü ve modülü kullanması gereken diğer rolleri işaretleyip Save Changes düğmesine tıklamanız gerekir.

Bir rol işaretlenene kadar modül soldaki Addons menüsünde hiç görünmez. Modül kuruludur, tabloları vardır ve ayarlar sayfası kusursuz çalışır, ancak yönetim alanının hiçbir yerinde ona giden bir bağlantı yoktur. On vakanın dokuzunda "modül kurulmadı" demek, bu kutunun hiç işaretlenmemiş olması demektir.

Somut olarak:

1. Yine System Settings > Addon Modules ekranındayken Perfex CRM Bridge yanındaki Configure düğmesine tıklayın. WHMCS bu paneli genellikle etkinleştirmenin hemen ardından kendiliğinden açar.
2. Access Control altında Full Administrator rolünü işaretleyin. Köprüyü açıp yapılandırabilmesi gereken diğer yönetici rollerini de işaretleyin.
3. Save Changes düğmesine tıklayın.
4. Yönetim alanını yenileyin. Perfex CRM Bridge artık Addons menüsü altında görünür.

Configure ekranındaki tek şey Access Control'dür

Bu modülün gerçek ayarlarının tamamı, WHMCS Configure ekranında değil, Addons > Perfex CRM Bridge adresindeki modülün kendi sayfasında bulunur. Configure ekranında yalnızca Access Control kalır, çünkü onu WHMCS çekirdeği oluşturur ve başka bir yere taşınamaz. Configure ekranını Perfex URL'sini veya lisans anahtarını aramak için açtıysanız yanlış ekrandasınız. Yapılandırma sayfasına bakın.

Adım 4: Modül sayfasını açın

Addons > Perfex CRM Bridge bölümüne gidin.

Sayfa Setup checklist ile açılır. Yeni bir kurulumda şöyle görünür:

Kontrol listesi satırı	Şu anda beklenen durum
Module tables present	🟢 onay
Connection configured	🔴 çarpı, henüz eşleştirme yok
Connection verified	⚪ tire, hiç kontrol edilmedi
Sync enabled	🔴 çarpı, Enable Sync kutusunu işaretleyene kadar
Cron delivering	🔴 çarpı, henüz cron etkinliği kaydedilmedi
License / plan	⚪ tire, Ücretsiz plan

Yeni kurulmuş, henüz yapılandırılmamış bir köprü için doğru durum budur. Her satır Yapılandırma bölümünde açıklanmıştır.

Sırada iki tarafı eşleştirmek var: Yapılandırma.

Adım 5: İlk senkronizasyonu uçtan uca doğrulayın

Bunu, köprüye gerçek verilerinizi emanet etmeden önce, eşleştirmenin hemen ardından bir kez yapın. İki dakika sürer ve tüm hattın çalıştığını kanıtlar.

1. Yapılandırma bölümünde anlatılan eşleştirmeyi tamamlayın. Connection configured ve Connection verified kontrol listesi satırlarının ikisi de yeşil olmalıdır.
2. Aynı sayfada Settings > Sync behaviour altında Enable Sync kutusunun işaretli olduğundan emin olun, ardından Save Settings düğmesine tıklayın. Sync enabled satırı yeşile döner.
3. WHMCS'de bir test müşterisi oluşturun. Herhangi bir ad ve e-posta yeterlidir, örneğin Bridge Test Ltd adlı bir şirket.
4. Addons > Perfex CRM Bridge sayfasına dönün. Sayfanın üst kısmındaki Queue pending sayacı en az 1 göstermelidir.
5. Run Sync Now düğmesine tıklayın. Bu, cron'u beklemeden anında bir teslim denemesi başlatır. Sayfa kaç olayın gönderildiğini, kaçının başarısız olduğunu ve kaçının ölü mektuba düştüğünü bildirir.
6. Perfex CRM'de Customers bölümünü açın. Test müşterisi artık orada bir müşteri olarak görünür ve WHMCS müşterisinin adı ile e-postası birincil kişi olarak kayıtlıdır.
7. Her iki kaydın da olayı kaydettiğini doğrulayın:
   • WHMCS tarafı: modül sayfasının alt kısmındaki Recent activity tablosunda ok durumlu bir client.upsert satırı görünür.
   • Perfex tarafı: Setup > WHMCS Bridge sayfasındaki Recent inbound events panelinde yeşil ok rozetiyle eşleşen bir client.upsert satırı görünür.
8. Saklamak istemiyorsanız test müşterisini her iki sistemden de silin.

"Run Sync Now" cron'unuzun çalıştığını kanıtlamaz

Run Sync Now teslimatın çalıştığını kanıtlar. Cron delivering kontrol listesi satırını yeşile döndürmez, çünkü bu satır bilinçli olarak gerçek WHMCS sistem cron etkinliğini izler. Bir saat sonra bu satır hâlâ kırmızı veya turuncuysa, WHMCS sistem cron'unuz çalışmıyordur ve hiçbir şey otomatik olarak senkronize edilmez. Canlıya geçmeden önce cron'u düzeltin. Sorun giderme sayfasına bakın.

Yeni bir sürüme güncelleme

Her iki modül de aynı sürümü taşır ve daima birlikte güncellenmelidir.

Perfex tarafı. Yeni module.zip dosyasını Setup > Modules > Upload Module üzerinden yükleyerek mevcut modülün üzerine yazın, ardından herhangi bir yönetim sayfasını açın. Tamamlayıcı, veritabanı sürümünün eski olduğunu algılar ve kendi geçişlerini yerinde uygular. Dilerseniz bunun yerine modülü devre dışı bırakıp yeniden etkinleştirebilirsiniz. Her iki yol da güvenlidir: her geçiş ifadesi korumalıdır, bu nedenle yeniden çalıştırmak zaten doğru olan hiçbir şeyi değiştirmez.

WHMCS tarafı. Yeni addon.zip dosyasını modules/addons/perfexbridge/ üzerine yükleyip çıkarın. WHMCS, yeni sürüm numarasını gördüğünde modülün yükseltme rutinini çalıştırır. Emin değilseniz eklentiyi System Settings > Addon Modules altında devre dışı bırakıp yeniden etkinleştirin.

Ayarlarınız yükseltmeden etkilenmez

Ayarlar, paylaşılan gizli anahtar, lisans anahtarı, varlık eşlemesi ve kayıtların tamamı, yükseltmelerin asla silmediği veritabanı tablolarında saklanır. WHMCS eklentisini devre dışı bırakmak da verilerini silmez.

Kaldırma

1. WHMCS: System Settings > Addon Modules > Perfex CRM Bridge > Deactivate, ardından modules/addons/perfexbridge/ dizinini diskten silin.
2. Perfex: Setup > Modules bölümünde WHMCS Bridge modülünü devre dışı bırakın, ardından modülü kaldırın.
3. Verilerin de silinmesini istiyorsanız her iki sistemdeki modülün veritabanı tablolarını kaldırın (önce bir yedek alın).
4. Etkin bir Pro lisansı varsa, etkinleştirme kotasının serbest bırakılması ve lisansın başka bir yerde kullanılabilmesi için kaldırma işleminden önce anahtarı silin. Lisanslama ve Pro etkinleştirme sayfasına bakın.