WHMCS-Integration

Überblick

Wenn Sie WHMCS zur Verwaltung Ihres Hosting- und Service-Geschäfts verwenden, ermöglicht das Easy Mail Archive WHMCS-Modul die automatisierte Mandanten-Provisionierung direkt aus Ihrem Abrechnungssystem heraus. Wenn ein Kunde Ihren E-Mail-Archivierungsdienst erwirbt, erstellt WHMCS automatisch einen Mandanten. Wenn ein Kunde kündigt oder nicht bezahlt, sperrt WHMCS den Mandanten.

Modul-Installation

So installieren Sie das WHMCS-Provisionierungsmodul:

1. Laden Sie das Modul-Paket aus Ihrem Reseller-Dashboard herunter
2. Entpacken Sie das Archiv und laden Sie den Ordner easymailarchive in Ihre WHMCS-Installation unter modules/servers/ hoch
3. Der finale Pfad sollte modules/servers/easymailarchive/easymailarchive.php sein
4. Melden Sie sich in Ihrem WHMCS-Adminbereich an und navigieren Sie zu Setup > Products/Services > Servers

Server-Konfiguration

Fügen Sie im WHMCS-Adminbereich einen neuen Server für Easy Mail Archive hinzu:

1. Gehen Sie zu Setup > Products/Services > Servers
2. Klicken Sie auf Add New Server
3. Geben Sie einen Namen ein (z. B. "Easy Mail Archive")
4. Setzen Sie den Hostnamen auf api.easymailarchive.com
5. Geben Sie Ihren Reseller-API-Schlüssel im Feld Password ein
6. Wählen Sie easymailarchive als Servertyp
7. Speichern Sie die Konfiguration

Testen Sie die Verbindung mit dem Button Test Connection, um zu überprüfen, ob Ihr API-Schlüssel gültig ist.

Produkt-Konfiguration

Erstellen Sie ein Produkt in WHMCS, das Ihrem E-Mail-Archivierungsangebot entspricht:

1. Gehen Sie zu Setup > Products/Services > Products/Services
2. Erstellen Sie ein neues Produkt oder bearbeiten Sie ein bestehendes
3. Wählen Sie auf dem Tab Module Settings das Modul easymailarchive
4. Konfigurieren Sie die Modul-Einstellungen:
   • Slug-Präfix (optional) - Ein Präfix, das automatisch generierten Slugs vorangestellt wird (z. B. meinefirma-)
   • Slug automatisch generieren - Wenn aktiviert, werden Slugs aus der Domain oder dem Firmennamen des Kunden abgeleitet

Automatisierte Lifecycle-Hooks

Das Modul reagiert auf folgende WHMCS-Lifecycle-Events:

• Create - Wenn ein neuer Dienst aktiviert wird, wird ein Mandant über die API provisioniert. Der Mandanten-Slug und die Zugangs-URL werden im Dienst gespeichert und sind für den Kunden im Kundenbereich sichtbar.
• Suspend - Wenn ein Dienst gesperrt wird (z. B. wegen Nichtzahlung), wird der Mandant über die API gesperrt. Benutzer verlieren den Zugang, aber die Daten bleiben erhalten.
• Unsuspend - Wenn ein gesperrter Dienst reaktiviert wird (z. B. nach Zahlung), wird der Mandant entsperrt und der Zugang wiederhergestellt.
• Terminate - Wenn ein Dienst beendet wird, wird der Mandant gesperrt (nicht gelöscht), um versehentlichen Datenverlust zu verhindern. Kontaktieren Sie den Easy Mail Archive Support für eine endgültige Löschung.

Kundenbereich-Integration

Nach der Provisionierung sehen Ihre Kunden Folgendes in ihrem WHMCS-Kundenbereich:

• Die Archiv-Zugangs-URL (ihre Mandanten-Subdomain)
• Den aktuellen Status (aktiv oder gesperrt)
• Einen Direktlink zur Anmeldung im Archiv

Nutzungssynchronisierung

Das Modul kann periodisch Nutzungsdaten von der Easy Mail Archive API mit WHMCS synchronisieren. So können Sie aktive Benutzer und Speicherverbrauch pro Mandant direkt in Ihrem Abrechnungssystem verfolgen. Konfigurieren Sie einen WHMCS-Cron-Hook, um die Nutzungsstatistiken täglich oder in Ihrem bevorzugten Intervall abzurufen.

Fehlerbehebung

Falls die Provisionierung fehlschlägt, überprüfen Sie Folgendes:

• API-Schlüssel - Stellen Sie sicher, dass der API-Schlüssel in der Server-Konfiguration korrekt und aktiv ist
• Slug-Konflikte - Der Slug könnte bereits vergeben sein. Prüfen Sie das WHMCS-Modul-Log für Fehlerdetails.
• Netzwerkzugang - Stellen Sie sicher, dass Ihr WHMCS-Server api.easymailarchive.com auf Port 443 erreichen kann
• Modul-Logs - Prüfen Sie unter Utilities > Logs > Module Log in WHMCS die detaillierten Fehlermeldungen der API