Yapılandırma

Bu sayfadaki her şey, her iki modülün de kurulu ve etkin olduğunu, WHMCS'de Addons > Perfex CRM Bridge ve Perfex CRM'de Setup > WHMCS Bridge sayfalarına erişebildiğinizi varsayar. Bunlardan biri eksikse Kurulum sayfasına dönün. WHMCS tarafında bunun her zamanki nedeni Access Control işaretidir.

İki taraf kimlik doğrulamayı nasıl yapar

Her iki uç nokta da her isteği, bir paylaşılan gizli anahtardan türetilen HMAC-SHA256 imzasıyla doğrular.

Sade bir dille: gönderici, istek gövdesini gizli anahtarla imzalar ve bir zaman damgasıyla işaretler. Alıcı, imzayı kendi gizli anahtar kopyasıyla yeniden hesaplar ve imzası tutmayan ya da zaman damgası 300 saniyeden eski olan her isteği reddeder. Bu zaman penceresi, yakalanmış bir isteğin daha sonra yeniden oynatılmasını engelleyen şeydir.

Sonuç şudur: gizli anahtar iki tarafta bayt bayt aynı olmalıdır, aksi halde her istek 401 ile başarısız olur. Her uç nokta ayrıca kendi gizli anahtarı boşken tüm trafiği reddeder; böylece yarım yapılandırılmış bir köprü açık değil, kapalı kalır.

Her iki taraf da kullanımdan önce baştaki ve sondaki boşlukları kırpar; bu nedenle kopyala-yapıştır sırasında araya karışan bir boşluk veya satır sonu sizi engellemez. Aradaki her şeyin tam olarak eşleşmesi gerekir.

Paylaşılan gizli anahtarı bir kimlik bilgisi olarak görün

Paylaşılan gizli anahtar, Perfex müşterilerine ve kişilerine, Pro lisansıyla birlikte de her iki taraftaki faturalara, ödemelere, siparişlere ve destek taleplerine yazma erişimi verir. Veritabanlarından biri ya da bir yedeği herhangi bir şekilde açığa çıkarsa gizli anahtarı her iki tarafta derhal değiştirin. Gizli anahtarlar tbladdonmodules (WHMCS) ve tbloptions (Perfex) tablolarında düz metin olarak saklanır ki bu her iki ekosistemde de standart uygulamadır; dolayısıyla veritabanı erişimi olan herkes gizli anahtara sahiptir.

Eşleştirme: hızlı yol (önerilir)

Ayarları elle bir taraftan diğerine kopyalamanız gerekmez. Perfex, hem Perfex URL'sini hem de paylaşılan gizli anahtarı taşıyan tek bir Connection code üretir ve WHMCS bunu tek yapıştırmada kullanır.

Adım 1: Perfex'te gizli anahtarı oluşturun

1. Perfex CRM'de Setup > WHMCS Bridge bölümüne gidin.
2. Shared Secret alanının yanındaki Generate düğmesine tıklayın. Alan güçlü, 64 karakterlik rastgele bir gizli anahtarla dolar ve neyi kaydetmek üzere olduğunuzu görebilmeniz için görünür hale gelir. Göz düğmesi görünürlüğü tekrar kapatır.
3. Save düğmesine tıklayın.

Adım 2: Connection code'u kopyalayın

Sayfa yeniden yüklenir ve artık salt okunur bir Connection code alanı gösterir. Değeri, PBC1. ile başlayan tek bir dizedir.

Copy düğmesine tıklayın. Kod panonuza alındığında düğme "Copied!" yazısıyla yanıp söner.

Connection code bir paroladır

Kod, PBC1. ön ekinin ardından Perfex URL'nizi ve paylaşılan gizli anahtarınızı içeren base64url kodlanmış bir JSON taşır. Bu şifreleme değil, yalnızca kodlamadır. Kodu ele geçiren herkes köprü uç noktalarınızla konuşabilir. Kodu herkese açık bir destek talebine, sohbet kanalına, ekran görüntüsüne veya destek isteğine yapıştırmayın.

Connection code görünmüyorsa

Kod yalnızca iki koşul sağlandığında oluşturulur: Perfex kurulumunuzun HTTPS üzerinden sunulması ve kaydedilmiş paylaşılan gizli anahtarın en az 32 karakter olması. En yaygın neden, Generate düğmesine tıklayıp Save düğmesine tıklamamaktır. Sayfa hangi koşulun sağlanmadığını size söyler:

• "not served over HTTPS" - eşleştirme HTTPS gerektirir. Bunun yerine manuel kurulumu kullanın veya sertifikayı düzeltin.
• "shorter than 32 characters" - Generate, ardından Save düğmesine tıklayın; kod görünür.

Adım 3: Kodu WHMCS'ye yapıştırın

1. WHMCS'de Addons > Perfex CRM Bridge sayfasını açın.
2. Sayfanın üst kısmındaki yeşil Quick setup kutusunu bulun.
3. Kodu alana yapıştırın.
4. Connect düğmesine tıklayın.

Connect gerçekte ne yapar

Tek adımda ve şu sırayla:

1. Kodu çözer ve sıkı biçimde doğrular: PBC1. ön eki, katı base64url, düzgün biçimli bir JSON nesnesi, https:// ile başlayan ve URL doğrulamasından geçen bir adres ve en az 32 karakterlik bir gizli anahtar.
2. Çözülen URL ve gizli anahtarı kullanarak Perfex kurulumunuza imzalı bir ping gönderir ve pong yanıtını bekler.
3. Yalnızca bu ping başarılı olursa WHMCS tarafındaki Perfex CRM URL ve Shared Secret ayarlarını kaydeder.
4. Yalnızca ilk eşleştirmede ping, WHMCS temel adresinizi de taşır; böylece Perfex tarafındaki WHMCS URL alanı sizin için doldurulur. Bu yalnızca WHMCS'niz HTTPS üzerinden sunuluyorsa gerçekleşir ve zaten dolu olan bir değerin asla üzerine yazmaz.
5. Başarılı kontrolü kaydeder; böylece Connection verified kontrol listesi satırı aynı sayfa yüklemesinde yeşile döner.

Başarılı olduğunda, eşleştiği Perfex URL'sini belirten yeşil bir bildirim alırsınız. Başarısız olduğunda ise tam olarak neyin yanlış gittiğini açıklayan kırmızı bir bildirim alırsınız ve hiçbir şey kaydedilmez. Doğrulamayı geçemeyen bir kod, hâlihazırda çalışan bir yapılandırmanın asla üzerine yazamaz.

Daha sonra yeniden eşleştirme

WHMCS bir kez yapılandırıldıktan sonra Quick setup kutusu sade bir Re-pair formuna dönüşür. Gizli anahtarı değiştirdiğinizde veya Perfex'i yeni bir alan adına taşıdığınızda dilediğiniz zaman yeni bir kod yapıştırın. Aynı kural geçerlidir: doğrulamayı geçemeyen bir kod hiçbir şeyi değiştirmez.

Önce gizli anahtarı değiştirin, sonra yeniden eşleştirin

Perfex tarafında Generate ve Save düğmelerine tıklarsanız, yeni kodu WHMCS'ye yapıştırana kadar mevcut tüm WHMCS istekleri anında HTTP 401 ile başarısız olmaya başlar. Bu iki adımı art arda yapın. Değişiklikten önce kopyalanan eski bir kod reddedilir ve bildirim size Perfex'in 401 yanıtı verdiğini söyler.

Eşleştirme: manuel yöntem

Connection code bir kolaylıktır, sihir değil. Yaptığı her şey elle de yapılabilir ve Perfex kurulumunuz henüz HTTPS üzerinde değilse ya da iş akışınız birleşik bir kimlik bilgisinin yapıştırılmasını yasaklıyorsa bu yola ihtiyacınız olacak.

1. En az 32 karakterlik güçlü ve rastgele bir gizli anahtar oluşturun. Perfex ayarlar sayfasındaki Generate düğmesini ya da kendi aracınızı kullanın, örneğin openssl rand -hex 32.
2. Perfex'te, Setup > WHMCS Bridge sayfasında anahtarı Shared Secret alanına yapıştırın ve Save düğmesine tıklayın.
3. WHMCS'de, Addons > Perfex CRM Bridge sayfasını açın, Settings > Connection bölümüne inin ve:
   • Perfex CRM URL ayarını Perfex temel adresinize getirin, örneğin https://crm.example.com; HTTPS üzerinden ve sonunda hiçbir yol olmadan;
   • aynı gizli anahtarı Shared Secret alanına yapıştırın.
4. Save Settings düğmesine tıklayın.
5. Sayfanın üst kısmındaki Test Connection düğmesine tıklayın. Yeşil "Connection OK" bildirimini görmelisiniz.
6. Pro çift yönlü senkronizasyon için Perfex ayarlar sayfasındaki WHMCS URL alanını da doldurun. Eşleştirme bunu sizin yerinize yapardı.

WHMCS ayarları, bölüm bölüm

Tüm ayarlar modülün kendi sayfasındadır

Addons > Perfex CRM Bridge sayfasını açın ve Settings bölümüne inin. System Settings > Addon Modules altındaki WHMCS Configure ekranına bakmayın; o ekranda yalnızca WHMCS çekirdeği tarafından oluşturulan ve taşınamayan Access Control bulunur.

Uygulamak için Save Settings düğmesine tıklayın. Form ya hep ya hiç mantığıyla çalışır: geçersiz bir giriş, örneğin HTTPS olmayan bir URL, gönderimin tamamını reddeder ve hiçbir şeyi değiştirmez.

İki gizli kutu saklanan değerini asla göstermez

Shared Secret ve Pro License Key alanları her zaman boş görünür; böylece saklanan bir kimlik bilgisi, modülü açabilen her yöneticinin sayfa kaynağında durmaz. Mevcut değeri korumak için kutuyu boş bırakın. Değeri değiştirmek için içine yazın. Bir Pro anahtarını tamamen kaldırmak için Remove the stored key kutusunu işaretleyin.

Connection

Ayar	Ne yapar	Makul varsayılan
Perfex CRM URL	Perfex kurulumunuzun temel adresi, örneğin https://crm.example.com. HTTPS olmalıdır: köprü düz HTTP üzerinden göndermeyi reddeder.	Eşleştirmeyle otomatik ayarlanır
Shared Secret	HMAC gizli anahtarı. Perfex'te Setup > WHMCS Bridge altında yapılandırılan anahtarla eşleşmelidir. Saklanan değeri korumak için boş bırakın.	Eşleştirmeyle otomatik ayarlanır

Sync behaviour

Ayar	Ne yapar	Makul varsayılan
Enable Sync	Ana anahtar. Tüm giden teslimatı duraklatmak için işareti kaldırın. Duraklatma sırasında olaylar kuyruğa alınmaya devam eder, bu nedenle hiçbir şey kaybolmaz; yeniden etkinleştirdikten sonraki ilk turda teslim edilirler.	Yapılandırma tamamlandığında açık
Order Sync Target (Pro)	Bir WHMCS siparişinin Perfex'te neye dönüşeceği. lead sipariş başına bir Perfex potansiyel müşterisi oluşturur. note bunun yerine Perfex müşterisine bir not ekler. off siparişleri hiç senkronize etmez.	lead
Two-Way Conflict Policy (Pro)	Son senkronizasyondan bu yana her iki sistem de aynı müşteriyi ya da kişiyi değiştirdiyse hangi tarafın kazanacağı. Aşağıya bakın.	newest_wins

Çakışma politikası seçenekleri, her biri tek satırda:

• newest_wins (varsayılan) - gelen Perfex olayının zamanını son senkronizasyon zamanıyla karşılaştırır ve daha yeni olan düzenleme kazanır.
• whmcs_wins - WHMCS verisini korur ve çakışan Perfex düzenlemesini yok sayar.
• perfex_wins - Perfex düzenlemesini WHMCS verisinin üzerine uygular.

Çakışma politikası yalnızca gerçek bir çakışmada devreye girer

Bu politika yalnızca son başarılı senkronizasyondan bu yana her iki taraf da aynı kaydı değiştirdiğinde uygulanır. Bir tarafta yapılan sıradan bir düzenleme, diğer taraf değişmemişse her zaman uygulanır. Genel olarak hangi sistemin "kazanacağını" değil, yalnızca berabere durumunun nasıl bozulacağını seçiyorsunuz.

newest_wins ve sunucu saatleri üzerine bir not

"En yeni" ifadesi, gönderen sunucunun zaman damgasını alıcı sunucunun son senkronizasyon zamanıyla karşılaştırır; dolayısıyla iki sunucunun saatleri önemlidir. Her iki sunucuyu da NTP ile senkron tutun. WHMCS sunucunuz ile Perfex sunucunuz arasındaki saat farkı sizin kontrolünüz dışındaysa, kesin sonuç veren whmcs_wins veya perfex_wins seçeneklerini tercih edin.

Tickets

Ayar	Ne yapar	Makul varsayılan
Ticket Reply Admin (Pro)	Bir Perfex personel yanıtı WHMCS destek talebine senkronize edilirken kullanılan WHMCS yönetici kullanıcı adı. Yanıtın Perfex personelinin adına atfedilmesi ve yönetici olmayan bir yanıt olarak gönderilmesi için boş bırakın.	Boş

Pro lisansı

Ayar	Ne yapar	Makul varsayılan
Pro License Key	Ücretsiz plan için boş bırakın. Pro özellikleri açmak için Pro anahtarınızı buraya yapıştırın. Anahtarlar sk_ ile başlar. Değişmiş bir anahtarı kaydetmek, onu anında canlı olarak doğrular.	Boş (Ücretsiz)
Remove the stored key	Yalnızca saklanan bir anahtar varken görünen bir onay kutusu. İşaretleyip kaydetmek kurulumu Ücretsiz plana döndürür ve bu sitenin etkinleştirme kotasını serbest bırakır; böylece lisans başka bir yerde kullanılabilir.	İşaretsiz
Check licence now (düğme, sayfanın üstünde)	Zaten saklanan anahtarın, günde bir kez sınırlamasını yok sayarak anında yeniden kontrol edilmesini sağlar.	-
Upgrade to Pro / Buy a Pro licence (bağlantılar)	Ödeme ekranını açar. Pro olmayan bir kurulumda bu bağlantılar anahtar kutusunun yanında, lisans kontrol listesi satırında ve Pro tanıtım kutularında görünür.	-

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

Pro ayarlarını Ücretsiz planda yapılandırmak sorunsuzdur

Order Sync Target, Two-Way Conflict Policy ve Ticket Reply Admin, Ücretsiz bir kurulumda da sorunsuz kaydedilir. Geçerli bir lisans etkinleşene kadar yalnızca bir etkileri olmaz ve sayfa her alanın altında bunu belirtir. İsterseniz bunları önceden yapılandırabilirsiniz.

Perfex CRM ayarları, alan alan

Perfex yönetim alanında Setup > WHMCS Bridge sayfasını açın, ardından Save düğmesine tıklayın.

Connection

Alan	Ne yapar	Varsayılan / yedek davranış
Shared Secret	WHMCS Shared Secret değeriyle eşleşmelidir. Güçlü bir anahtar için Generate, ardından Save düğmesini kullanın. Göz düğmesi anahtarı gösterir veya gizler. Bu alan boşken uç nokta tüm trafiği reddeder.	Boş, uç nokta kapalı
Connection code	Salt okunur. Kaydedilmiş gizli anahtar 32 karakter veya daha uzun olduğunda ve Perfex HTTPS üzerindeyken görünür. WHMCS'deki Quick setup kutusuna kopyalayın.	Otomatik oluşturulur
WHMCS URL	Eklentiyi çalıştıran WHMCS kurulumunun temel adresi. Yalnızca Perfex'ten WHMCS'ye giden trafik için gereklidir ki bu da bir Pro özelliğidir. https:// ile başlamalıdır, aksi halde kaydedilmez.	İlk eşleştirmede otomatik doldurulur, dolduktan sonra asla üzerine yazılmaz

Ticket sync (Pro)

Alan	Ne yapar	Varsayılan / yedek davranış
Department mapping (WHMCS to Perfex)	Her WHMCS destek talebi departmanını bir Perfex departmanına eşler. Dizin alınabildiğinde WHMCS departmanı başına bir açılır liste, alınamadığında manuel bir metin alanı olarak görünür.	Boş, hiçbir şey eşlenmemiş
Default department for unmapped WHMCS tickets	Departmanı eşlemede bulunmayan her WHMCS destek talebi için kullanılan Perfex departmanı.	"Lowest department id (automatic)"
Staff author for synced WHMCS staff replies	Perfex'e yansıtılan WHMCS personel yanıtlarının yazarı olarak gösterilecek Perfex personeli.	"First active admin (automatic)"
Create a Perfex task per synced ticket	İşaretlendiğinde, senkronize edilen her destek talebi bağlantılı bir Perfex görevi kazanır; böylece personeliniz yerel Perfex zaman çizelgeleriyle bu talebe süre kaydedebilir.	Kapalı

Departman eşlemesi nasıl görünür

Normal deneyim açılır listelerdir. Ayarlar sayfası yüklendiğinde WHMCS destek departmanı dizininizi imzalı köprü üzerinden alır ve WHMCS departmanı başına bir satır oluşturarak her satırda Perfex departmanlarınızın yer aldığı bir açılır liste gösterir. Her satır için bir hedef seçin ya da - not mapped - olarak bırakın ve Save düğmesine tıklayın.

Bu veri alımı çalışan bir bağlantı ve Pro lisanslı bir WHMCS gerektirir, çünkü departman dizini de destek talebi senkronizasyonuyla aynı lisans kapısının arkasındadır. Çalışamadığında sayfa otomatik olarak manuel metin alanına düşer ve nedenini size söyler:

Gördüğünüz	Anlamı
WHMCS departmanı başına bir açılır liste	Her şey çalışıyor
Metin alanı, "Couldn't fetch WHMCS departments (needs Pro + working connection)"	Köprü henüz yapılandırılmamış, WHMCS'ye Perfex sunucusundan erişilemiyor ya da WHMCS kurulumu Ücretsiz planda
Metin alanı, "Connection OK, but WHMCS has no support departments yet"	Veri alımı çalıştı. WHMCS'de Support > Support Departments altında departman oluşturun, ardından bu sayfayı yeniden yükleyin

Veri alımı birkaç saniyeyle sınırlıdır; bu nedenle erişilemeyen bir WHMCS ayarlar sayfasını biraz yavaşlatır ama asla kilitlemez.

Manuel biçim, her satırda bir eşleme olacak şekilde, solda WHMCS departman ID'si ve sağda Perfex departman ID'si şeklindedir:

1=2
2=5
3=5

Açılır listeler görünürken Advanced: edit the mapping manually bağlantısı aynı metin alanını açar. Bu manuel düzenleyici açıkken kaydedilen şey onun içeriğidir ve açılır liste seçimlerini geçersiz kılar.

Gelen bir destek talebinin departmanı için çözümleme sırası:

1. Eşlemede birebir eşleşme.
2. Yoksa, yapılandırılmış Default department.
3. Yoksa, otomatik olarak seçilen en küçük Perfex departman ID'si.

Bir eşleme satırındaki yazım hatası sorunsuz biçimde yedek davranışa düşer. Kaydetmeyi de senkronizasyonu da bozmaz.

Talep başına görevde kaydedilen süre Perfex'te kalır

İsteğe bağlı Perfex görevi, personelinizin bir destek talebi için yerel Perfex zaman çizelgelerini kullanabilmesi için vardır. Bu süre kayıtları WHMCS'ye geri senkronize edilmez ve talep kapandığında görev otomatik olarak kapatılmaz.

Aynı sayfadaki paneller

Setup > WHMCS Bridge sayfasının sağ sütununda salt okunur üç panel bulunur:

• WHMCS plan - WHMCS tarafının en son bildirdiği plan (Pro, Free veya Unknown), lisansın en son ne zaman kontrol edildiği ve satın alınacak bir şey olduğunda bir Upgrade to Pro düğmesi.
• Outbound queue - WHMCS'ye gönderilmeyi bekleyen Perfex tarafı değişiklikler; bekleyen ve ölü sayıları, yeniden deneme sayıları, sonraki deneme zamanı ve satır başına son hata bilgisiyle birlikte.
• Recent inbound events - WHMCS'nin bu Perfex kurulumuna gönderdikleri, durum ve mesaj bilgisiyle birlikte.

Bunlar Perfex tarafındaki tanılama araçlarınızdır. Nasıl çalışır ve günlük kullanım sayfasına bakın.

Kurulum kontrol listesi, satır satır

WHMCS modül sayfası altı satırlık bir Setup checklist ile açılır. Her satır yeşil onay, turuncu uyarı, kırmızı çarpı veya gri tire ile birlikte tek satırlık bir ipucu taşır. Ücretsiz plandaysanız lisans satırı gri olmak üzere tüm satırların yeşil olması köprünün sağlıklı olduğu anlamına gelir.

Satır	Yeşil ise	Diğer durumlar
Module tables present	Outbox, eşleme ve kayıt tablolarının hepsi mevcut.	🔴 bir tablo eksik. Tabloyu yeniden oluşturmak için modülü System Settings > Addon Modules altında devre dışı bırakıp yeniden etkinleştirin.
Connection configured	Perfex URL'si ve paylaşılan gizli anahtarın ikisi de ayarlanmış.	🔴 henüz ayarlanmamış. Quick setup kutusuna bir Connection code yapıştırın ya da Settings > Connection altındaki iki alanı da doldurun.
Connection verified	İmzalı bir ping pong yanıtı aldı ve satır bunun ne kadar önce olduğunu gösteriyor.	🔴 son kontrol başarısız oldu ve satır hatayı gösteriyor. Sorunu giderin, ardından Test Connection düğmesine tıklayın. ⚪ hiç kontrol edilmemiş ya da son kontrol 24 saatten eski. Yenilemek için Test Connection düğmesine tıklayın.
Sync enabled	Giden teslimat açık.	🔴 senkronizasyon duraklatılmış. Olaylar kuyruğa alınmaya devam eder ama teslim edilmez. Settings > Sync behaviour altında Enable Sync kutusunu işaretleyip kaydedin.
Cron delivering	WHMCS sistem cron'u yakın zamanda gerçek köprü işi yaptı ve satır bunun ne kadar yakın zamanda olduğunu gösteriyor.	🟠 bir süredir cron etkinliği yok. WHMCS sistem cron'unun çalıştığını kontrol edin. 🔴 hiç cron etkinliği kaydedilmemiş. Yepyeni bir kurulumda ilk teslimata kadar bu normaldir; kalıcı hale gelirse cron'unuz çalışmıyordur.
License / plan	Pro etkin.	⚪ lisans anahtarı yok; bu Ücretsiz plandır ve bu modülü çalıştırmanın tamamen desteklenen bir yoludur. 🔴 bir anahtar ayarlanmış ama doğrulanmıyor. Anahtarı kontrol edin, ardından Check licence now düğmesine tıklayın.

"Cron delivering" satırı bilinçli olarak kandırılması zor bir satırdır

Bu satırı yalnızca gerçek bir WHMCS sistem cron turu yeşile döndürür. Run Sync Now kuyruğa alınmış olaylarınızı teslim eder ve teslimatın çalıştığını kanıtlar, ancak bu satıra dokunmaz. Amaç tam olarak budur: satır "kimse izlemezken de çalışmaya devam edecek mi?" sorusuna yanıt verir ve bir düğmeye basmak bu soruyu yanıtlayamaz.

Satır gerçek köprü işini izler: kuyruk boşaltma, kayıt temizleme ve mutabakat turları. Bu nedenle uzun süredir boşta olan ama tamamen sağlıklı bir kurulum, yalnızca yapacak iş olmadığı için düzeltilecek hiçbir şey yokken turuncu kalabilir.

Hem Connect (eşleştirme) hem de Test Connection, Connection verified satırını yeniler.

Sırada ne var

• Hattı uçtan uca doğrulayın: Kurulum, adım 5.
• Çift yönlü senkronizasyonu, faturaları ve destek taleplerini açın: Lisanslama ve Pro etkinleştirme.
• Neyin senkronize edildiğini ve kayıtların nerede olduğunu öğrenin: Nasıl çalışır ve günlük kullanım.