WHMCS e chiavi API

Koapanel si collega a WHMCS (8.x e 9.x) con il modulo ufficiale: quando un cliente ordina un hosting, WHMCS crea l'account sul pannello, lo sospende se la fattura non è pagata, lo aggiorna e lo elimina, e il cliente entra nel pannello con un clic dall'area clienti di WHMCS.

Chiavi API

WHMCS e gli altri sistemi di fatturazione usano una chiave API personale. La crei in Chiavi API (amministratori e rivenditori):

• la chiave (kpk_…) si vede una sola volta: copiala subito;
• agisce come te: la chiave di un rivenditore raggiunge solo i suoi clienti e i suoi pacchetti, entro la sua quota; per creare rivenditori da WHMCS serve la chiave di un amministratore;
• si crea e si elimina solo accedendo al pannello (una chiave non può creare altre chiavi);
• al massimo 300 richieste al minuto e 10 chiavi per account;
• se l'account viene sospeso o eliminato, le sue chiavi smettono di funzionare;
• nel Registro attività ogni operazione fatta con una chiave riporta «con API key …» e il sistema che l'ha usata.

Elimina subito una chiave che non usi più o che pensi sia stata vista da altri.

Collegare WHMCS

1. Scarica il modulo da https://console.koapanel.app/updates/integrations/ ed estrailo nella cartella di WHMCS (modules/servers/koapanel).
2. In WHMCS aggiungi un server: Hostname = il nome di questo pannello, Modulo Koapanel, Password = la chiave API, SSL sì, porta 8443. Premi Test connessione.
3. Crea i prodotti con il modulo Koapanel: scegli un pacchetto del pannello oppure indica i limiti (siti, spazio, database, caselle); per un prodotto rivenditore scegli «Rivenditore» e il numero di clienti.

La guida completa per WHMCS è nel file README.md dentro lo zip del modulo.

Cosa fa WHMCS sul pannello

• Crea l'account con nome utente e password del servizio (se la password è troppo debole il modulo ne genera una forte); ripetere la creazione non fa doppioni.
• Sospende e riattiva l'account, con il motivo scritto in WHMCS.
• Cambia pacchetto o la quota del rivenditore.
• Elimina l'account e i suoi siti quando il servizio termina.
• Accesso con un clic: WHMCS chiede al pannello un link di accesso monouso, valido 60 secondi; nell'area clienti ci sono anche i collegamenti diretti a File, WordPress, Email e Database. Un account sospeso non riceve link.
• Una volta al giorno legge lo spazio usato di ogni account.

Rivendere licenze Koapanel

Se sei un provider partner puoi vendere anche le licenze Koapanel da WHMCS con il modulo koapanel_license e la chiave partner che ti dà Koapanel.