Konfiguration

Nach der Installation und Aktivierung des WHMCS Integration Moduls müssen Sie die Verbindung zu Ihrer WHMCS-Instanz konfigurieren und definieren, wie Daten in Perfex CRM fließen. Diese Seite behandelt die API-Einrichtung, Synchronisierungseinstellungen, Feldzuordnung und automatisierte Zeitplanung.

Verbindung zu WHMCS

Das Modul kommuniziert mit WHMCS über dessen offizielle API. Sie benötigen gültige API-Zugangsdaten, bevor Sie fortfahren.

WHMCS API-Zugangsdaten generieren

1. Melden Sie sich in Ihrem WHMCS Admin-Bereich an.
2. Navigieren Sie zu Setup > Mitarbeiterverwaltung > API-Zugangsdaten verwalten.
3. Klicken Sie auf Neue API-Zugangsdaten generieren.
4. Geben Sie eine Beschreibung ein (z. B. "Perfex CRM Integration").
5. Kopieren Sie den API-Identifikator und das API-Geheimnis — Sie benötigen beides im nächsten Schritt.

warnung

Bewahren Sie Ihre API-Zugangsdaten sicher auf. Das API-Geheimnis wird nur einmal bei der Erstellung angezeigt. Falls es verloren geht, müssen Sie neue Zugangsdaten generieren.

Zugangsdaten in Perfex CRM eingeben

1. Navigieren Sie in Perfex CRM zu den Einstellungen des WHMCS Integration-Moduls.
2. Geben Sie die folgenden Details ein:
   • WHMCS URL — die vollständige URL Ihrer WHMCS-Installation (z. B. https://billing.example.com)
   • API-Identifikator — der im vorherigen Schritt generierte Identifikator
   • API-Geheimnis — der im vorherigen Schritt generierte Geheimschlüssel
3. Klicken Sie auf Verbindung testen, um zu überprüfen, ob Perfex CRM erfolgreich mit Ihrer WHMCS-Instanz kommunizieren kann.
4. Klicken Sie auf Einstellungen speichern, sobald der Verbindungstest bestanden ist.

tipp

Wenn der Verbindungstest fehlschlägt, stellen Sie sicher, dass die IP-Adresse Ihres Perfex CRM-Servers in WHMCS unter Setup > Allgemeine Einstellungen > Sicherheit > API IP-Zugangsbeschränkung freigegeben ist. Überprüfen Sie auch, ob HTTPS konfiguriert und die WHMCS-URL korrekt ist.

Synchronisierungseinstellungen

Das Einstellungspanel für die Synchronisierung ermöglicht Ihnen zu steuern, welche Daten importiert werden und wie sie in Perfex CRM verarbeitet werden.

Datentypen

Datentyp	Beschreibung
Kunden	Synchronisiert Kundenprofile einschließlich Name, E-Mail, Telefon, Adresse und Firmendetails
Rechnungen	Synchronisiert Rechnungen mit Einzelposten, Gesamtbeträgen, Steuern, Zahlungsstatus und Fälligkeitsdaten
Kontakte	Synchronisiert zusätzliche Kontakte, die jedem WHMCS-Kundenkonto zugeordnet sind

Schalten Sie jeden Datentyp je nach Bedarf ein oder aus. Mindestens sollten Kunden aktiviert sein, da Rechnungen und Kontakte mit Kundendatensätzen verknüpft sind.

Duplikatbehandlung

Wenn ein synchronisierter Datensatz mit einem bestehenden Perfex CRM-Kunden übereinstimmt (Abgleich über E-Mail-Adresse), können Sie wählen, wie der Konflikt behandelt wird:

• Überspringen — den Datensatz nicht importieren, wenn bereits eine Übereinstimmung existiert
• Aktualisieren — den bestehenden Perfex CRM-Datensatz mit WHMCS-Daten überschreiben
• Neu erstellen — einen separaten Datensatz erstellen, unabhängig von Duplikaten

info

Die empfohlene Einstellung ist Aktualisieren, die Ihre Perfex CRM-Daten mit WHMCS synchron hält und gleichzeitig doppelte Kundeneinträge vermeidet.

Feldzuordnung

Der Bereich Feldzuordnung ermöglicht Ihnen zu definieren, wie WHMCS-Felder den Perfex CRM-Feldern entsprechen. Das Modul wird mit sinnvollen Standardwerten ausgeliefert, aber Sie können die Zuordnungen anpassen für:

• Standardfelder — Name, E-Mail, Telefon, Adresse, Firma, Stadt, Bundesland, PLZ, Land
• Benutzerdefinierte Felder — Ordnen Sie benutzerdefinierte WHMCS-Felder benutzerdefinierten Perfex CRM-Feldern zu

Um Feldzuordnungen zu bearbeiten:

1. Gehen Sie zu WHMCS Integration > Einstellungen > Feldzuordnung.
2. Wählen Sie für jedes WHMCS-Feld das entsprechende Perfex CRM-Feld aus dem Dropdown-Menü.
3. Klicken Sie auf Zuordnung speichern.

Automatisierter Synchronisierungszeitplan

Anstatt Synchronisierungen manuell durchzuführen, können Sie einen automatisierten Zeitplan über einen serverseitigen Cron-Job konfigurieren.

Cron-Job einrichten

Fügen Sie den folgenden Eintrag zur Crontab Ihres Servers hinzu, um die Synchronisierung im gewünschten Intervall auszuführen:

# WHMCS-Synchronisierung alle 6 Stunden ausführen
0 */6 * * * php /path/to/perfex/index.php whmcs_integration sync >/dev/null 2>&1

Passen Sie die Cron-Zeitsteuerung an, je nachdem wie häufig sich Ihre WHMCS-Daten ändern. Gängige Intervalle sind:

Intervall	Cron-Ausdruck	Anwendungsfall
Stündlich	0 * * * *	Abrechnungsumgebungen mit hohem Volumen
Alle 6 Stunden	0 */6 * * *	Standardnutzung (empfohlen)
Einmal täglich	0 2 * * *	Umgebungen mit geringem Volumen

warnung

Das zu häufige Ausführen der Synchronisierung bei großen Datensätzen kann die Serverlast erhöhen. Überwachen Sie Ihre Serverressourcen nach der Aktivierung der automatischen Synchronisierung und passen Sie das Intervall entsprechend an.

Nächste Schritte

• Nutzungsanleitung — erfahren Sie, wie Sie manuelle Synchronisierungen durchführen, importierte Kunden und Rechnungen verwalten und Bots, Vorlagen und Massenkontakte verwenden