WHMCS Apps aiuto

API 1

• Usare direttamente l'API Ogni endpoint si trova sotto /modules/addons/whmcspwa/api/index.php. Invia un'intestazione Authorization: Bearer con il token di accesso. La schermata di riferimento elenca la tabella delle rotte attive, generata dal router stesso.

Branding 4

• Icone dell'app Fornisci un PNG da 192px e uno da 512px. Quadrati, senza angoli arrotondati e senza trasparenza: ogni piattaforma applica la propria maschera, e un'icona trasparente esce con uno sfondo nero su iOS.
• Colore del marchio e accento Il colore del marchio colora i pulsanti principali dell'app, i link e la barra di stato del telefono. L'accento è riservato alle cose che richiedono attenzione, come una fattura scaduta. Tenerli distinti è ciò che rende un saldo non pagato leggibile a colpo d'occhio.
• Pastello, chiaro, scuro e automatico Automatico è l'impostazione predefinita e segue quella del telefono: la tua tavolozza chiara di giorno, il tema scuro di notte. Pastello è uno sfondo bianco sporco con linee morbide, chiaro è lo stesso layout in grigi più freddi, e…
• L'icona fornita con il modulo Finché non ne carichi una tua, l'app usa una pila di unità rack con una spia di stato accesa. È volutamente generica, ed è una vera icona invece di un quadrato colorato, così anche un'installazione senza nulla configurato…

Funzioni 8

• Allegare una foto o un file, e chi lo vede Lo staff può allegare file a un ticket dal telefono, anche direttamente dalla fotocamera, e scegliere se il cliente li vede. L'impostazione predefinita è solo staff, e questo è proprio il punto: l'errore da cui proteggersi è un…
• Allegare uno screenshot a un nuovo ticket Quando apri un ticket nell'app clienti c'è un'area facoltativa per gli allegati sotto il messaggio: Scegli un file seleziona qualsiasi cosa dal dispositivo, e Scatta una foto apre la fotocamera, che è il modo rapido per allegare uno…
• Chiudere il tuo ticket Un servizio su un server cPanel mostra una sezione cPanel sotto Utilizzo quando l'account è attivo, con gli strumenti di tutti i giorni. Sceglierne uno apre cPanel in una nuova scheda, con l'accesso già effettuato e direttamente su quello strumento, senza password da…
• File su un ticket Gli allegati compaiono sotto il messaggio con cui sono arrivati e si scaricano con un tocco. Servire file dal disco è la cosa più pericolosa che questo modulo fa, quindi le regole sono rigide: il link indica il file invece di lasciare al chiamante…
• Aprire cPanel Un servizio su un server cPanel mostra una sezione cPanel sotto Utilizzo quando l'account è attivo, con gli strumenti di tutti i giorni: File Manager, Account email, Database, phpMyAdmin, Backup e altro. Sceglierne uno apre cPanel in una nuova scheda, con l'accesso già effettuato…
• Stampare una fattura L'app genera una propria copia stampabile invece di recuperare il PDF di WHMCS, perché quel PDF è servito dietro una sessione dell'area clienti che l'app non possiede, e chiedere a qualcuno di accedere due volte per vedere la propria fattura…
• Attivare e disattivare le sezioni Una sezione disattivata scompare dalla navigazione dell'app e i suoi endpoint API iniziano a rifiutare le richieste. Le due cose avvengono insieme, quindi nascondere una schermata trattiene davvero i dati invece di nascondere solo il pulsante.
• Cosa vedono per primo i clienti Un servizio su un server cPanel mostra un pulsante Apri cPanel sotto Utilizzo quando l'account è attivo. Ti fa accedere direttamente a cPanel in una nuova scheda senza password da digitare, sulla home di cPanel dove File…

Guide 7

• Guida: portare i clienti sull'app L'annuncio, l'installazione e cosa fare con gli iPhone.Circa 30 minuti.Imposta l'indirizzo dell'app Punta un sottodominio come app.yourhosting.com all'app e usalo ovunque. Un indirizzo breve fa la differenza tra le persone che lo digitano e le persone…
• Guida: gestire un ticket dal telefono alla risoluzione Cosa invia un cliente, cosa vede lo staff e come si comportano le risposte offline.Circa 10 minuti.Attiva i ticket I clienti vedono un elenco dei loro ticket e possono aprirne di nuovi in qualsiasi reparto che hai configurato in WHMCS.Un cliente apre un ticket…
• Guida: dalla fattura al pagamento sul telefono Come una notifica diventa una fattura saldata.Circa 10 minuti.Viene emessa la fattura WHMCS crea la fattura come al solito. L'app intercetta quell'evento e avvisa il cliente, con l'importo e la scadenza nel testo della notifica.Il cliente tocca la notifica…
• Guida: lanciare l'app per la prima volta Da un'installazione nuova a un cliente che tocca la tua app sulla sua schermata Home.Circa 15 minuti.Esegui la configurazione La procedura guidata controlla HTTPS, estensioni PHP e la tua versione di WHMCS prima di tutto, così scopri subito un eventuale ostacolo invece di…
• Guida: mettere il codice di installazione dove viene inquadrato Dal codice generato ai clienti con l'app sulla schermata Home.Circa 30 minuti.Fissa l'indirizzo dell'app prima di stampare qualsiasi cosa Il codice contiene l'indirizzo impostato qui. Se lo stampi e poi cambi l'indirizzo, ogni codice stampato punta…
• Guida: attivare le passkey senza un'ondata di richieste di assistenza Attivale, verifica che funzionino sul tuo dispositivo, poi lascia che le persone le scoprano.Circa 20 minuti, poi una settimana di osservazione.Decidi prima il dominio Prima che qualcuno si registri, stabilisci il dominio a cui si legano le passkey. Se l'app potrebbe spostarsi su app.yourhosting.com…
• Guida: quando qualcosa non funziona I controlli che risolvono la maggior parte delle segnalazioni, nell'ordine in cui conviene provarli.Circa 5 minuti.Controlla prima il pannello di stato Riporta HTTPS, estensioni PHP, l'account amministratore per l'API e le chiavi delle notifiche. La maggior parte dei problemi è uno di questi quattro non impostato.Nessuno può…

Installazione 2

• Mettere il codice sotto gli occhi delle persone Il pannello dell'area clienti fa il lavoro da solo: chi ha effettuato l'accesso da un computer vede il codice, chi è sul telefono vede invece un pulsante di installazione, perché un telefono non può inquadrare se stesso. Oltre a questo, i due posizionamenti che funzionano davvero…
• Il codice di installazione Un codice QR con l'indirizzo della tua app, generato dal modulo invece che da un servizio esterno, così nessuna azienda esterna viene a conoscenza del traffico dei tuoi clienti. Riflette sempre l'indirizzo dell'app nella schermata Branding. Stampalo sulle fatture, mostralo…

Notifiche 4

• Chiavi delle notifiche Le chiavi VAPID identificano il tuo server presso i servizi push di Apple, Google e Mozilla. Generale una volta sola. Rigenerarle invalida ogni iscrizione esistente, quindi tutti dovranno riattivare le notifiche.
• Notifiche su iPhone iOS consegna le notifiche web solo dopo che l'app è stata aggiunta alla schermata Home, e la richiesta di permesso deve partire da un tocco. L'app la chiede nella schermata Notifiche invece che al primo caricamento proprio per questo…
• Avvisare lo staff dei ticket Con le notifiche attive, lo staff può essere avvisato anche dei ticket: quando ne viene aperto uno nuovo e quando un cliente risponde a uno esistente. Una risposta su un ticket assegnato a un determinato membro dello staff va a…
• Cosa fa partire una notifica Fattura creata, pagamento ricevuto, pagamento non riuscito e una risposta dello staff su un ticket. Ognuno è un hook WHMCS separato, quindi puoi disattivarne uno senza toccare gli altri.

Offline 1

• Cosa funziona senza segnale Le ultime schermate caricate restano leggibili, e una risposta a un ticket scritta offline viene messa in coda e inviata appena torna la connessione. I pagamenti richiedono sempre una connessione attiva.

Passkey 6

• Bloccare l'app Un dispositivo può essere impostato per bloccare l'app quando passa in background, così per riaprirla serve l'impronta. Il modo ovvio di realizzarlo è una richiesta davanti alla sessione esistente, ma sarebbe solo scena:…
• Richiedere impronta, volto o PIN Con questa opzione attiva, il dispositivo deve confermare chi lo tiene in mano prima di firmare, quindi un telefono raccolto sbloccato da qualcuno non basta da solo. Con l'opzione disattivata, basta la sola presenza: un tocco sulla chiave di…
• Account dello staff con autenticazione a due fattori WHMCS non offre alcun modo supportato per verificare un secondo fattore dello staff al di fuori del proprio modulo di accesso. Controllare solo la password renderebbe questa app la via facile per aggirare un controllo che hai attivato di proposito, quindi gli account con due fattori non possono…
• Il dominio a cui sono legate le passkey Una passkey è legata a un dominio e ai suoi sottodomini, ed è questo legame che la rende impossibile da usare nel phishing. Vuoto significa che il modulo lo ricava dall'indirizzo dell'app. Impostalo consapevolmente se in futuro potresti spostare l'app:…
• Cos'è una passkey Una coppia di chiavi che il telefono o il portatile crea e conserva dietro il proprio blocco schermo. Accedere significa che il dispositivo firma una sfida monouso con la metà privata, che non lo lascia mai e non attraversa mai la rete. Non c'è…
• Quando qualcuno perde il dispositivo La sua password funziona ancora, quindi nessuno resta chiuso fuori. Anche le passkey salvate nel Portachiavi iCloud o in Gestore delle password di Google seguono da sole la persona su un dispositivo sostitutivo. Se un dispositivo è davvero perso, accedi con la password,…

Sicurezza 4

• Limite di richieste Richieste al minuto da un singolo indirizzo IP. I tentativi di accesso hanno un limite separato e più rigido. Aumentalo se un grande ufficio dietro un unico indirizzo viene bloccato.
• Rinnovare la chiave di firma Il rinnovo disconnette immediatamente tutti dall'app, ovunque. Usalo se sospetti che un token sia trapelato. Nessuno perde dati; basta accedere di nuovo.
• Sessioni e token L'accesso restituisce un token di accesso di breve durata e un token di aggiornamento di lunga durata. I token di aggiornamento cambiano a ogni utilizzo; se uno vecchio viene presentato di nuovo l'intera sessione viene revocata, ed è così che si scopre un token rubato.
• Perché l'accesso dello staff ha bisogno di un controllo WHMCS offre una chiamata supportata per validare la password di un cliente, e nessuna per validare quella dello staff, quindi l'app deve leggere da sé l'hash memorizzato. Il punto in cui si trova quell'hash è cambiato tra le versioni di WHMCS: le installazioni più vecchie lo tengono in…

Configurazione 5

• Account amministratore per l'API L'app verifica le password e apre i ticket chiamando WHMCS come questo amministratore. Scegli un account dedicato con solo i permessi di cui l'app ha bisogno, invece dell'accesso quotidiano di una persona, così puoi revocarlo senza bloccare nessuno.
• Portare l'app sulla schermata Home Android e Chrome desktop mostrano automaticamente una richiesta di installazione quando l'app ha un manifest, un'icona di almeno 192px e un service worker. iOS non ha una richiesta: si usa Condividi, poi Aggiungi alla schermata Home. L'app rileva…
• Mostrare i dettagli degli errori Normalmente, quando una richiesta fallisce, l'app mostra un messaggio breve e generico e il dettaglio reale va nel registro delle attività. Con questa opzione attiva, il messaggio reale e il punto in cui è avvenuto tornano anche nell'app. È pensato…
• Verificare il certificato di cPanel Per aprire cPanel, l'app fa accedere il cliente tramite l'API del server cPanel stesso su una connessione sicura. Il certificato di quella connessione viene verificato per impostazione predefinita. Alcuni server presentano sulla porta dell'API un certificato autofirmato o con un nome host non corrispondente, il che rende…
• Perché serve HTTPS I browser si rifiutano di installare un'app sulla schermata Home, registrare un service worker o consegnare notifiche su HTTP semplice. Localhost è l'unica eccezione, ed è per questo che i test funzionano prima del tuo certificato.

Staff 19

• Intervenire su un servizio o un dominio Dalla scheda di un cliente, ogni servizio mostra le azioni adatte al suo stato: sospendere uno attivo, riattivare uno sospeso, eseguire la creazione/configurazione di uno ancora in attesa. Una sospensione chiede un motivo, perché quel motivo è l'unico…
• Aggiungere una nota interna La schermata di un ticket ha un riquadro Nota interna per lo staff, sotto il riquadro di risposta. Ciò che scrivi lì viene salvato come nota del ticket WHMCS: solo per lo staff, e il cliente non riceve mai una notifica. Serve per il commento continuo…
• Annullare una fattura Una fattura non pagata, in bozza o scaduta può essere annullata dalla sua schermata, e così WHMCS smette di sollecitarne il pagamento. È disponibile sul telefono perché è reversibile: una fattura annullata può essere ripristinata come non pagata dalla…
• Azioni rapide sul cliente La scheda di un cliente offre una serie di azioni per le cose che lo staff fa senza aprire un computer. Aggiungi credito carica un saldo sull'account. Invia reimpostazione password attiva l'email di reimpostazione di WHMCS, così il cliente riceve il solito link…
• Contattare un cliente e intervenire La scheda di un cliente ha in alto i pulsanti per chiamare, inviare un SMS e un'email, e un pulsante WHMCS che apre la sua scheda completa nell'area di amministrazione. I primi tre sono link del dispositivo: passano la palla al compositore del telefono, all'app dei messaggi…
• Controllare cosa possono fare i clienti Controlli cosa i clienti possono vedere e fare nell'app a due livelli. Account, Permessi dell'app clienti imposta i valori predefiniti che ogni cliente eredita: per ogni cosa, come pagare le fatture, aprire ticket o aprire cPanel, un interruttore decide se…
• Invitare i clienti all'app Puoi inviare ai clienti un'email con un link all'app e le istruzioni per aggiungerla alla schermata Home; accedono con l'account che hanno già. Invialo a uno dalla sua scheda cliente con il pulsante Invita, oppure a…
• Aprire un cliente Toccare un cliente in qualsiasi punto dell'app apre un'unica schermata con ciò che ha, ciò che deve e ciò che sta aspettando: servizi con il loro stato, domini con i giorni alla scadenza, fatture con prima quelle non pagate, e gli eventuali ticket aperti.…
• Eccezioni per un singolo cliente La schermata di un cliente ha Permessi dell'app, dove i valori predefiniti possono essere sovrascritti solo per quel cliente. Ogni permesso offre tre scelte: Predefinito segue l'impostazione globale, Attivo lo rende disponibile per questo cliente qualunque sia il valore predefinito, e Disattivo lo…
• Segnalare un problema di rete Un servizio su un server cPanel mostra gli strumenti cPanel sotto Utilizzo quando l'account è attivo, più un pulsante Apri cPanel. Scegliere uno strumento fa accedere il cliente e, dove il server lo consente, lo porta direttamente sulla…
• Leggere la dashboard La dashboard ha tre pagine: incassi, ordini e supporto. Scorri tra di esse, oppure tocca i nomi sopra, che è il modo più rapido per arrivare alla terza. Gli incassi contano il denaro effettivamente ricevuto, che non è lo stesso del denaro fatturato:…
• Attività recente Attività recente, raggiungibile dalla dashboard, è un unico flusso di ciò che è appena successo in tutta l'attività: nuovi ordini, pagamenti ricevuti, ticket aperti e cancellazioni richieste, dal più recente, nell'ultimo mese. I contatori della dashboard ti dicono quanti…
• Registrare un pagamento ricevuto Per il denaro arrivato al di fuori dell'app: un bonifico, contanti, un assegno. L'app passa il pagamento a WHMCS tramite la sua chiamata AddInvoicePayment invece di scrivere direttamente nel registro contabile, così è WHMCS a decidere se la fattura è ora…
• Risposte salvate sul telefono Le risposte predefinite già configurate in WHMCS sotto Supporto compaiono nell'app, raggruppate per categoria, e toccarne una la aggiunge a ciò che c'è già nel riquadro di risposta invece di sostituirlo. È la funzione che decide…
• Restare connessi L'accesso dello staff ha una casella Resta connesso su questo dispositivo. Lasciala spuntata e la sessione resta attiva tra una visita e l'altra come al solito. Toglila e la sessione viene mantenuta solo finché l'app non viene chiusa del tutto, il che è adatto a un…
• Evitare che un pagamento venga registrato due volte Inserisci il riferimento bancario o il numero della ricevuta nel campo Riferimento. L'app rifiuta un secondo pagamento con un riferimento già registrato su quella fattura, ed è questo che ti salva quando il telefono perde il segnale durante l'invio e tocchi di nuovo.…
• La casella di ricerca La dashboard ha una casella di ricerca che cerca contemporaneamente tra clienti, fatture, ticket e domini, così un cliente al telefono può essere trovato senza sapere in quale elenco si trova. Digita un nome, un'azienda, un'email o un numero di telefono…
• Smistare un ticket Un ticket aperto dalla coda mostra un pannello Smistamento per lo staff, sotto il suo stato. Da lì si possono cambiare lo stato, la priorità, il reparto e il membro dello staff a cui è assegnato, e ogni modifica ha effetto nel momento in cui…
• Gestire un ordine Toccare un ordine in attesa lo apre con le stesse azioni dell'app ufficiale, tranne una: accetta, annulla, annulla e rimborsa, segna come frode e riporta in attesa. Ognuna passa per l'API documentata degli ordini di WHMCS, quindi fa esattamente…

Hub di supporto 4

• Aprire l'hub dalle Impostazioni Lo staff raggiunge l'hub dalle Impostazioni nella schermata Tu, dove Apri Keen2Support ti fa accedere al tuo supporto con nome ed email già compilati, così non ti vengono richiesti di nuovo. È un link invece…
• Il feed di aiuto che legge l'hub L'hub non riceve l'aiuto da questo modulo; lo va a prendere. Una volta all'ora legge un feed servito da questo modulo e mette in cache gli articoli, così un operatore di supporto che gestisce un ticket può cercarli e incollare una risposta…
• Cosa comporta collegarsi a Keen2Support Keen2Support è il tuo supporto separato con i creatori di questa app. Il collegamento registra questa app presso l'hub usando una chiave del prodotto presa da lì, e l'app riceve un token del sito che usa in ogni successiva…
• Quale telemetria viene inviata, e quale no La telemetria è disattivata finché non la attivi. Quando è attiva, gli eventi che questa app registra già nel proprio registro delle attività vengono replicati sull'hub: cose come un accesso, un pagamento registrato, una notifica push inviata. Prima che qualcosa lasci il…

Strumenti 2

• Verificare che il server possa inviare notifiche Esegui "php modules/addons/whmcspwa/tools/selftest.php" sul server. Firma un token, firma una richiesta VAPID e cifra e poi decifra un vero payload push, senza toccare il tuo database. Devono passare diciotto controlli. Se falliscono quelli push, al server manca il…
• Numeri di versione e aggiornamenti La versione in version.php è l'unica risposta vera; la schermata Panoramica, l'API e l'app la leggono tutte da lì. Tre file caricati direttamente dal browser ne portano una copia così la loro cache si svuota all'aggiornamento. "php tools/version.php –check"…

Il tuo account 8

• Modificare un'impostazione del dominio La schermata di un dominio ha una sezione Impostazioni con tre interruttori che puoi cambiare da solo: rinnovo automatico, privacy WHOIS e blocco del trasferimento. Ognuno mostra lo stato attuale e cambia quando lo tocchi, andando direttamente al tuo account presso l'hosting. Rinnovo automatico su…
• Cambiare la password Account, Cambia password chiede la password attuale e poi una nuova. La password attuale viene controllata per prima, così chi prende in mano un telefono sbloccato non può cambiarla di nascosto. La nuova password deve essere di almeno otto…
• Modificare i tuoi dati Account, I tuoi dati, Modifica i tuoi dati ti permette di cambiare i tuoi recapiti: nome, azienda, email, telefono e indirizzo. Il salvataggio scrive direttamente nel tuo account presso l'hosting, come se lo modificassi sul suo sito, così fatture e…
• Password dimenticata Nella schermata di accesso, Password dimenticata chiede un indirizzo email e chiede all'hosting di inviarvi un link di reimpostazione. Il link e la pagina di reimpostazione sono quelli del sistema dell'hosting, esattamente come sul sito web, quindi l'app…
• Nome utente dimenticato I clienti accedono con il loro indirizzo email, quindi non c'è un nome utente separato da dimenticare. Nome utente dimenticato nella schermata di accesso lo spiega e, se l'email inserita corrisponde a un account, vi invia un breve promemoria. Come per…
• Pagare tutto in una volta Quando ci sono più fatture in sospeso, la schermata iniziale offre un unico pulsante Paga tutto con il totale complessivo, accanto a un link per vedere le singole fatture. Pagare tutto apre la pagina di pagamento cumulativo dell'hosting, che salda ogni fattura non pagata…
• Dispositivi connessi Account, Dispositivi connessi elenca tutti i posti in cui il tuo account ha attualmente un accesso attivo, con il dispositivo, il suo indirizzo e l'ultimo utilizzo, e segnala quello che stai usando. Disconnettere un dispositivo che non riconosci termina la sua sessione…
• Le tue notifiche Quando le notifiche sono attive e le hai consentite su un dispositivo, le cose di cui vieni avvisato (una nuova fattura, un pagamento andato a buon fine, una risposta a un ticket) vengono anche conservate nell'app sotto…