Perfex CRM Integration for WHMCS
Perfex CRM Integration for WHMCS verbindet Ihre WHMCS-Abrechnungsplattform mit Ihrer Perfex CRM-Installation und hält beide Systeme automatisch im Gleichschritt. Kunden, Kontakte, Rechnungen, Zahlungen, Bestellungen, Dienste, Domains und Support-Tickets fließen nahezu in Echtzeit zwischen den Systemen. So bildet Ihr CRM stets die tatsächliche Abrechnungslage ab, und Ihr Abrechnungssystem spiegelt immer wider, was Ihre Vertriebs- und Support-Teams im CRM getan haben.
Der Free-Plan bietet Ihnen eine zuverlässige Einweg-Synchronisierung von Kunden und Kontakten aus WHMCS nach Perfex CRM. Eine Pro-Lizenz schaltet die Zwei-Wege-Synchronisierung frei (in Perfex vorgenommene Änderungen fließen zurück nach WHMCS), dazu Rechnungen, Zahlungen, Bestellungen, Support-Tickets, ein Panel für Dienste und Domains innerhalb von Perfex sowie einen Backfill wizard für Ihre bestehenden historischen Daten.
Das Problem, das es löst
WHMCS ist Ihr System für Abrechnung und Bereitstellung. Perfex CRM ist der Ort, an dem Sie Leads, Projekte, Aufgaben und Kundenbeziehungen verwalten. Ohne eine Brücke dazwischen existiert derselbe Kunde zweimal, in zwei Datenbanken, und die beiden Kopien driften innerhalb weniger Wochen auseinander. Jemand aktualisiert eine Adresse in WHMCS, jemand anderes trägt eine Telefonnummer in Perfex ein, und keines der beiden Systeme ist mehr vertrauenswürdig.
Dieses Produkt beseitigt das manuelle Kopieren. Jede relevante Änderung erzeugt ein Ereignis, das Ereignis wird in eine Warteschlange gestellt, und die Warteschlange wird über einen signierten HTTPS-Kanal an das jeweils andere System ausgeliefert.
Zwei Module, beide erforderlich
Das Produkt wird als zwei Komponenten ausgeliefert, und beide müssen installiert werden. Keine der beiden Hälften leistet für sich allein etwas Nützliches.
| Komponente | Installiert in | Aufgabe | Lizenzierung |
|---|---|---|---|
⚙️ perfexbridge (WHMCS-Addon) | WHMCS, unter modules/addons/perfexbridge | Das kostenpflichtige Modul. Es lauscht auf WHMCS-Ereignisse, stellt sie in eine Warteschlange, signiert sie und übermittelt sie an Perfex. Es hält sämtliche Synchronisierungseinstellungen und den Pro-Lizenzschlüssel. In der WHMCS-Verwaltung erscheint es als Perfex CRM Bridge. | Standardmäßig Free-Stufe. Ein Pro-Lizenzschlüssel schaltet die Pro-Funktionen frei. |
🧩 whmcs_bridge (Perfex CRM Companion) | Perfex CRM, unter modules/whmcs_bridge | Das kostenlose Companion-Modul. Es empfängt die signierten Ereignisse und schreibt Kunden, Kontakte, Rechnungen, Zahlungen, Leads und Tickets nach Perfex. Es stellt den Reiter WHMCS im Kundenprofil dar. In der Perfex-Verwaltung erscheint es unter Setup > WHMCS Bridge. | Immer kostenlos. Niemals ein Lizenzschlüssel. |
Installieren Sie nur das WHMCS-Addon, sammeln sich die Ereignisse in einer Warteschlange, ohne dass sie irgendwo ankommen. Installieren Sie nur das Perfex-Companion, sendet ihm nie jemand etwas. Der Plan (Free oder Pro) wird ausschließlich durch den Lizenzschlüssel auf der WHMCS-Seite bestimmt. Das Perfex-Companion ist in beiden Fällen identisch.
Beide Komponenten tragen dieselbe Versionsnummer, derzeit 1.3.4, und sollten immer gemeinsam aktualisiert werden.
Das Produkt heißt Perfex CRM Integration for WHMCS. Innerhalb der beiden Anwendungen melden sich die Module kürzer: Das WHMCS-Addon wird unter Addon Modules als Perfex CRM Bridge aufgeführt, das Perfex-Companion unter Setup > Modules als WHMCS Bridge. Nach diesen Namen halten Sie bei der Installation Ausschau.
Free vs Pro
| Funktion | Free | Pro |
|---|---|---|
| 👥 Einweg-Kundensynchronisierung, WHMCS nach Perfex CRM | ✅ | ✅ |
| 👤 Einweg-Kontaktsynchronisierung, WHMCS nach Perfex CRM | ✅ | ✅ |
| ⚡ Echtzeit-Ereigniserfassung über WHMCS-Hooks, ausgeliefert über den WHMCS-Cron | ✅ | ✅ |
| 🔗 Kopplung mit einem einzigen Einfügen des Connection code | ✅ | ✅ |
| ✅ Setup checklist und Test Connection | ✅ | ✅ |
| 📝 Aktivitätsprotokolle auf beiden Seiten | ✅ | ✅ |
| 🔁 Zwei-Wege-Synchronisierung von Kunden und Kontakten, Perfex-Änderungen fließen zurück nach WHMCS * | ➖ | ✅ |
| 📄 Rechnungsspiegelung, WHMCS-Rechnungen werden zu Perfex-Rechnungen * | ➖ | ✅ |
| 💳 Zahlungs- und Transaktionssynchronisierung, gespiegelte Rechnungen werden in Perfex ausgeglichen * | ➖ | ✅ |
| 🛒 Bestellsynchronisierung, eine WHMCS-Bestellung wird zu einem Perfex-Lead oder einer Kundennotiz * | ➖ | ✅ |
| 🎫 Support-Ticket-Synchronisierung, Tickets, Antworten und Status in beide Richtungen * | ➖ | ✅ |
| 🌐 Panel für Dienste und Domains im Perfex-Kundenprofil * | ➖ | ✅ |
| ⏬ Backfill wizard für bestehende historische Daten * | ➖ | ✅ |
| 🗂️ Dropdowns für die Ticket-Abteilungszuordnung in Perfex * | ➖ | ✅ |
| ⏱️ Perfex-Aufgabe pro Ticket für die native Zeiterfassung über Timesheets * | ➖ | ✅ |
* Pro-Lizenz erforderlich.
Jedes Pro-Feld ist im Free-Plan sichtbar und speicherbar. Es bleibt lediglich wirkungslos, bis eine gültige Lizenz aktiv ist, und die Verwaltungsseite weist neben jedem Feld darauf hin. Unter Lizenzierung und Pro-Aktivierung erfahren Sie, wie Sie kaufen und aktivieren.
Anforderungen
| Anforderung | Details |
|---|---|
| 🖥️ WHMCS | 8.x oder 9.x. Getestet ab 8.1.3 aufwärts. |
| 🐘 PHP | 7.2 bis 8.5. Ein einziger Build läuft auf allen Versionen. Beide Module bringen ihre eigenen Kompatibilitäts-Shims mit, es gibt also keinen separaten Download je PHP-Version. |
| 📇 Perfex CRM | 3.x, verifiziert gegen 3.4.0. |
| 🔒 HTTPS auf beiden Seiten | Zwingend erforderlich. Der Transport ist auf HTTPS festgelegt und prüft das TLS-Zertifikat. Eine einfache http://-URL lässt jeden Sendevorgang bewusst scheitern, und das Feld für die WHMCS-URL auf der Perfex-Seite lässt sich nicht speichern, wenn es nicht mit https:// beginnt. |
| ⏰ WHMCS-System-Cron | Muss laufen. Die Bridge liefert die eingereihten Ereignisse aus und validiert die Lizenz beim Cron-Durchlauf erneut. Ohne Cron wird nichts ausgeliefert. |
| 🌐 Netzwerk, für die Pro-Zwei-Wege-Synchronisierung | Ihre WHMCS-Installation muss zusätzlich vom Perfex-Server aus über HTTPS erreichbar sein. |
| 🔌 PHP-Erweiterungen | cURL, auf beiden Servern. |
Dies ist die mit Abstand häufigste Ursache für "es wird nie etwas gesendet". Der HTTP-Transport ist auf das Protokoll https beschränkt und validiert das Zertifikat auf beiden Seiten. Ein selbstsigniertes Zertifikat ist nur dann akzeptabel, wenn es auf dem aufrufenden Server tatsächlich validiert. Es gibt keine Einstellung, um das abzuschalten, und das ist Absicht: Über diesen Kanal laufen das gemeinsame Secret und Ihre Kundendaten.
Wie die Synchronisierung funktioniert, in einem Absatz
Es wird nichts direkt gesendet, während ein Administrator wartet. Ein WHMCS-Hook wird ausgelöst, das Ereignis wird in eine Outbox-Tabelle geschrieben, und der WHMCS-System-Cron leert diese Warteschlange und sendet jedes Ereignis per POST über HTTPS an Perfex. Jede Anfrage wird mit HMAC-SHA256 und einem gemeinsamen Secret signiert, das beide Seiten besitzen, innerhalb eines Replay-Fensters von 300 Sekunden. Fehlgeschlagene Versuche werden mit wachsendem Backoff wiederholt und landen nach 15 Versuchen im Dead-Letter-Status, damit ein Betreiber sie prüfen kann. Die Pro-Richtung von Perfex nach WHMCS nutzt denselben signierten Kanal in umgekehrter Richtung, angetrieben vom Perfex-Cron. Eine mehrschichtige Echo-Unterdrückung verhindert, dass eine einzelne Änderung endlos zwischen den Systemen hin und her springt. Die vollständige Erklärung finden Sie unter Funktionsweise und täglicher Betrieb.
Bevor Sie beginnen
Legen Sie sich Folgendes bereit, dann dauert die gesamte Einrichtung etwa zehn Minuten:
- Administrativer Zugang zu beiden Systemen, WHMCS und Perfex CRM.
- Zugriff auf den File Manager Ihres Hosting-Panels oder auf FTP für den WHMCS-Server. WHMCS besitzt keinen Modul-Installer innerhalb der Verwaltung.
- Beide Installationen über HTTPS mit gültigen Zertifikaten erreichbar.
- Die Bestätigung, dass der WHMCS-System-Cron läuft. WHMCS zeigt den letzten Cron-Lauf unter Utilities > System > System Health Status an.
- Die heruntergeladene
upload.zip, entpackt, sodass Ihnenwhmcs-addon/addon.zipundperfex-module/module.zipvorliegen.
Wie es weitergeht
- Installation - installieren Sie zuerst das Perfex-Companion, dann das WHMCS-Addon, und meistern Sie die Access Control-Stolperfalle.
- Konfiguration - koppeln Sie die beiden Seiten mit einem einzigen Connection code und legen Sie anschließend jede Option fest.
- Lizenzierung und Pro-Aktivierung - eine Pro-Lizenz kaufen, aktivieren, prüfen und entfernen.
- Funktionsweise und täglicher Betrieb - die Synchronisierungs-Engine, was wohin synchronisiert wird, wo die Protokolle liegen und der Backfill wizard.
- Fehlerbehebung - jeder häufige Fehlerfall, mit Ursache und Lösung.
WHMCS ist eine Marke von WHMCS Ltd. Perfex CRM ist eine Marke von MSTdev. Themesic Interactive ist ein unabhängiger Entwickler und steht in keiner Verbindung zu einem der beiden Unternehmen, wird von ihnen weder unterstützt noch gesponsert.