Yapılandırma

WHMCS Integration modülünü kurup aktifleştirdikten sonra, WHMCS örneğinize bağlantıyı yapılandırmanız ve verilerin Perfex CRM'e nasıl aktarılacağını tanımlamanız gerekir. Bu sayfa API kurulumunu, senkronizasyon tercihlerini, alan eşlemeyi ve otomatik zamanlamayı kapsar.

WHMCS'e Bağlanma

Modül, WHMCS ile resmi API'si aracılığıyla iletişim kurar. Devam etmeden önce geçerli API kimlik bilgilerine ihtiyacınız olacak.

WHMCS API Kimlik Bilgileri Oluşturma

1. WHMCS Yönetici Alanınıza giriş yapın.
2. Setup > Staff Management > Manage API Credentials bölümüne gidin.
3. Generate New API Credential düğmesine tıklayın.
4. Bir açıklama girin (ör. "Perfex CRM Entegrasyonu").
5. API Identifier ve API Secret bilgilerini kopyalayın — bir sonraki adımda her ikisine de ihtiyacınız olacak.

uyarı

API kimlik bilgilerinizi güvenli bir şekilde saklayın. API Secret yalnızca oluşturma sırasında bir kez gösterilir. Kaybederseniz yeni kimlik bilgileri oluşturmanız gerekecektir.

Perfex CRM'de Kimlik Bilgilerini Girme

1. Perfex CRM'de WHMCS Integration modül ayarlarına gidin.
2. Aşağıdaki bilgileri girin:
   • WHMCS URL — WHMCS kurulumunuzun tam URL'si (ör. https://billing.example.com)
   • API Identifier — önceki adımda oluşturulan tanımlayıcı
   • API Secret — önceki adımda oluşturulan gizli anahtar
3. Perfex CRM'in WHMCS örneğinizle başarıyla iletişim kurabildiğini doğrulamak için Bağlantıyı Test Et düğmesine tıklayın.
4. Bağlantı testi başarılı olduktan sonra Ayarları Kaydet düğmesine tıklayın.

ipucu

Bağlantı testi başarısız olursa, Perfex CRM sunucunuzun IP adresinin WHMCS'de Setup > General Settings > Security > API IP Access Restriction bölümünde beyaz listeye alındığından emin olun. Ayrıca HTTPS'nin yapılandırıldığını ve WHMCS URL'sinin doğru olduğunu doğrulayın.

Senkronizasyon Ayarları

Senkronizasyon ayarları paneli, hangi verilerin içe aktarılacağını ve Perfex CRM içinde nasıl yönetileceğini kontrol etmenize olanak tanır.

Veri Türleri

Veri Türü	Açıklama
Müşteriler	Ad, e-posta, telefon, adres ve şirket detayları dahil müşteri profillerini senkronize edin
Faturalar	Kalemler, toplamlar, vergi, ödeme durumu ve vade tarihleriyle faturaları senkronize edin
Kişiler	Her WHMCS müşteri hesabıyla ilişkili ek kişileri senkronize edin

İhtiyaçlarınıza göre her veri türünü açıp kapatabilirsiniz. Faturalar ve kişiler müşteri kayıtlarına bağlı olduğundan, en azından Müşteriler etkinleştirilmelidir.

Çift Kayıt Yönetimi

Senkronize edilen bir kayıt mevcut bir Perfex CRM müşterisiyle eşleştiğinde (e-posta adresine göre eşleşme), çakışmayı nasıl yöneteceğinizi seçebilirsiniz:

• Atla — eşleşme zaten mevcutsa kaydı içe aktarma
• Güncelle — mevcut Perfex CRM kaydını WHMCS verileriyle üzerine yaz
• Yeni Oluştur — çiftlere bakılmaksızın ayrı bir kayıt oluştur

bilgi

Önerilen ayar Güncelle'dir; bu, çift müşteri girişlerini önlerken Perfex CRM verilerinizi WHMCS ile senkronize tutar.

Alan Eşleme

Alan eşleme bölümü, WHMCS alanlarının Perfex CRM alanlarına nasıl karşılık geldiğini tanımlamanıza olanak tanır. Modül mantıklı varsayılanlarla gelir, ancak şunlar için eşlemeleri özelleştirebilirsiniz:

• Standart alanlar — ad, e-posta, telefon, adres, şirket, şehir, il/eyalet, posta kodu, ülke
• Özel alanlar — WHMCS özel alanlarını Perfex CRM özel alanlarıyla eşleyin

Alan eşlemelerini düzenlemek için:

1. WHMCS Integration > Ayarlar > Alan Eşleme bölümüne gidin.
2. Her WHMCS alanı için açılır menüden karşılık gelen Perfex CRM alanını seçin.
3. Eşlemeyi Kaydet düğmesine tıklayın.

Otomatik Senkronizasyon Zamanlaması

Senkronizasyonları manuel çalıştırmak yerine, sunucu tarafında bir cron görevi kullanarak otomatik bir zamanlama yapılandırabilirsiniz.

Cron Görevini Kurma

Senkronizasyonu istediğiniz aralıkta çalıştırmak için sunucunuzun crontab'ına aşağıdaki girişi ekleyin:

# WHMCS senkronizasyonunu her 6 saatte çalıştır
0 */6 * * * php /path/to/perfex/index.php whmcs_integration sync >/dev/null 2>&1

WHMCS verilerinizin ne sıklıkla değiştiğine göre cron zamanlamasını ayarlayın. Yaygın aralıklar şunlardır:

Aralık	Cron İfadesi	Kullanım Durumu
Her saat	0 * * * *	Yüksek hacimli faturalandırma ortamları
Her 6 saat	0 */6 * * *	Standart kullanım (önerilen)
Günde bir kez	0 2 * * *	Düşük hacimli ortamlar

uyarı

Büyük veri kümeleriyle senkronizasyonu çok sık çalıştırmak sunucu yükünü artırabilir. Otomatik senkronizasyonu etkinleştirdikten sonra sunucu kaynaklarınızı izleyin ve aralığı buna göre ayarlayın.

Sırada Ne Var?

• Kullanım Kılavuzu — manuel senkronizasyon çalıştırmayı, içe aktarılan müşterileri ve faturaları yönetmeyi, botları, şablonları ve toplu kişileri kullanmayı öğrenin