---
title: Gestione dei clienti
description: Trova e assisti i clienti: elenco clienti, paese da IP, origine referral, azioni account, richieste di eliminazione e trasferimenti di servizi.
url: https://nexcmp.com/it/docs/customers/managing-customers/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Gestione dei clienti {#managing-customers}

> setItems("**Dove nell'admin:** Customers › Customers › List (`/customers`), Deletion requests (`/customers/requests`), Service transfers (`/customers/transfers`) e API keys (`/customers/apikeys`)."),

## Descrizione {#what-it-does}

setItems("L'area Clienti consente al personale di supporto di cercare un account, visualizzarne portafoglio, servizi, ticket e cronologia degli accessi, e intervenire: bloccare, sbloccare, verificare l'e-mail, reimpostare la password, aggiungere o rimuovere credito, impersonare, creare una VM o chiudere l'account."),

## Requisiti {#requirements}

| Elemento | Requisito |
|---|---|
| Ruolo | setItems("Un amministratore. Ogni azione di scrittura richiede un motivo e viene registrata nel log di audit (System › Logs › Admin actions)."), |
| setItems("E-mail"), | setItems("Le e-mail di reset della password e di invito richiedono una [SMTP configuration](https://nexcmp.com/it/docs/administration/smtp-and-emails/) funzionante."), |

## setItems("L'elenco dei clienti"), {#the-customer-list}

setItems("Apri **Customers › List**. I clienti sono gli account del tuo sito principale; compaiono anche gli account dei rivenditori, filtrabili per sito."),

setItems("![Elenco clienti con filtri e colonne per paese, origine referral, saldo e conteggio VM](https://nexcmp.com/it/docs/images/customers/managing-customers-01-list.webp)"),

| setItems("Colonna"), | Significato |
|---|---|
| setItems("**Email** (e nome)"), | setItems("Clicca per aprire il cliente."), |
| setItems("**State**"), | setItems("*Active*, *Locked* o *Deleted*, oltre a e-mail *verified* o *unverified*. Passa il mouse su un tag di blocco per leggerne il motivo."), |
| setItems("**Login**"), | setItems("Metodi di accesso del cliente: password, Google, GitHub, passkey."), |
| setItems("**Country**"), | setItems("Bandiera e nome derivati dall'**IP address**: il paese dell'IP di registrazione o, se sconosciuto, dell'ultimo accesso. Il tooltip indica quale è stato usato."), |
| **Origine referral** | *Referral* con il link al referente e il codice di riferimento quando il cliente si è iscritto tramite un link di affiliazione; altrimenti "Non registrato". |
| **Balance**, **VM** | Saldo del portafoglio (valori negativi in rosso) e numero di VM attive. |
| **IP registrato / ultimo** | L'IP utilizzato durante la registrazione e all'ultimo accesso, con il paese a due lettere. Usalo per individuare più account da un unico indirizzo. |
| **Tenant** | L'ID tenant interno del cliente. |
| **Creato**, **Ultimo accesso** | Tempi relativi. |
| **Site** | Mostrato quando si dispone di rivenditori. |

**Search** accetta e-mail, nome o IP. **Filtri:** stato (tutti, attivi, bloccati, eliminati), metodo di accesso (qualsiasi, Google, GitHub, passkey, nessun password ancora) e sito. I filtri vengono mantenuti nell'URL, consentendo di aggiungere un elenco filtrato ai preferiti o di condividerlo con un collega.

**L'ordinamento è globale.** Facendo clic sull'intestazione di *Email*, *State*, *Balance*, *VMs*, *Created* o *Last login* viene ordinata l'**intera** base di clienti sul server e non solo la pagina visualizzata, e il numero di pagina torna a 1.

**L'elenco si aggiorna automaticamente.** Si aggiorna ogni pochi secondi mentre lo consulti (va in pausa se una finestra di dialogo è aperta o mentre scrivi), quindi le nuove registrazioni e le variazioni di saldo compaiono senza ricaricare la pagina. La pagina del cliente si aggiorna ogni 30 secondi circa quando è visibile; ogni scheda carica i propri dati alla prima apertura.

### Crea un cliente {#create-a-customer}

1. Fai clic su **Create customer**.
2. Inserisci l'**e-mail**, un **display name** opzionale, una **password** opzionale (vuota = il cliente la imposta tramite il link di invito) e scegli se **send the invitation e-mail**.
3. Conferma. Un account creato manualmente viene considerato verificato quando invii l'invito.

## La pagina di un cliente {#a-customer-s-page}

Fai clic su una riga. La pagina presenta otto schede; la scheda selezionata viene mantenuta nell'URL per consentirti di aggiungerla ai preferiti. Le schede si caricano alla prima apertura e mantengono il loro stato quando passi a un'altra.

| Scheda | Contenuto |
|---|---|
| **Overview** | Identità, informazioni di registrazione e ultimo accesso, riepilogo del wallet e dei servizi |
| **Services** | Una tabella per i servizi del cliente, con filtri per tipo e stato, ricerca, ordinamento lato server e paginazione |
| **Billing** | Wallet e credito, registro contabile, fatture, pagamenti, rimborsi, metodo di pagamento salvato e ricarica automatica |
| **Quota** | Limiti di risorse e override; vedi [Quote](https://nexcmp.com/it/docs/billing/quotas/) |
| **Security** | Sessioni, autenticazione, metodi di accesso, cronologia accessi e chiavi API; vedi [Chiavi API](https://nexcmp.com/it/docs/developers/api-keys/) |
| **Support** | Ticket recenti |
| **Affiliate** | Stato del programma di affiliazione |
| **Log** | Cronologia delle attività e di audit |

Pulsanti di azione nell'intestazione (nascosti per gli account eliminati):

| Pulsante | Descrizione |
|---|---|
| **Lock account** / **Unlock** | Blocca l'accesso e l'uso dell'API. Facoltativamente arresta anche tutte le VM (senza eliminarle). Vengono arrestati anche i servizi prepagati diversi dalle VM (Kubernetes, Private Cloud, VPN e così via). Le VM bloccate da un amministratore devono essere sbloccate separatamente nella pagina della VM. |
| **Verify email** | Contrassegna l'e-mail come verificata senza che il cliente debba fare clic su un link. |
| **Send reset link** | Invia via e-mail un link per la reimpostazione della password (valido 1 ora, monouso). Se l'SMTP non è configurato, il link viene mostrato una sola volta per poterlo inviare autonomamente. Un amministratore non vede mai la password. |
| **Impersonate** | Effettua l'accesso come cliente per un'ora. Vedi [Log in as a customer](https://nexcmp.com/it/docs/customers/login-as/). |
| **Credit / debit** | Aggiunge o rimuove fondi dal portafoglio tramite una rettifica contabile. Vedi [Invoices and ledger](https://nexcmp.com/it/docs/billing/invoices-and-ledger/). |
| **Revoke sessions** | Disconnette il cliente ovunque; i token dell'app smettono di funzionare. |
| **Create VM** | Crea una VM per il cliente. |
| **Soft delete** | Chiude l'account. È necessario digitare l'e-mail per confermare. |


### Gestire un singolo servizio {#manage-an-individual-service}

Apri la scheda **Services** del cliente, individua un servizio per nome, ID, IP o configurazione e utilizza le azioni di riga. Le stesse azioni sono disponibili nell'elenco di amministrazione del servizio. La finestra di dialogo propone solo le azioni supportate da tale servizio e dal suo stato attuale.

| Action | Effetto |
|---|---|
| **Lock** | Arresta il servizio conservandone i dati. Il cliente lo vede come bloccato e non può gestirlo. L'esecuzione di una ricarica non rimuove il blocco applicato da un amministratore; il rinnovo automatico rimane bloccato per tutta la durata del blocco. |
| **Unlock** | Annulla il blocco impostato dall'amministratore. Non rimuove un blocco indipendente per abuso o per altre protezioni. |
| **Cancel without refund** | Annulla il servizio senza creare una voce di rimborso nel registro contabile. Il messaggio di conferma avverte che l'annullamento non può essere revocato. |
| **Cancel and refund** | Mostra i pagamenti originali, la loro ripartizione tra wallet e credito, i rimborsi precedenti e l'importo massimo rimborsabile. Verifica l'importo prima di confermare. |

Inserisci un motivo per ogni azione. Il motivo è riservato agli amministratori; il cliente riceve una notifica o un evento di servizio neutro. Il denaro rimborsato nel wallet torna nel wallet, mentre il credito o le allocazioni promozionali tornano al credito. Questa azione non restituisce denaro tramite Stripe, bonifico bancario o PayPal.

Per più servizi dello stesso tipo, seleziona fino a 50 righe e scegli un'azione massiva. Il risultato mostra l'esito positivo o negativo per ciascuna riga. I rimborsi massivi utilizzano l'importo suggerito di ciascun servizio; i servizi per cui il rimborso suggerito è pari a zero vengono ignorati in modalità di rimborso e richiedono una verifica individuale o la cancellazione senza rimborso.

DDoS Shield, dischi e backup sono qui righe di sola lettura. Gli add-on di larghezza di banda seguono il rispettivo servizio principale. L'accesso a AI Models può essere bloccato, ma non ha un abbonamento da annullare. Per bloccare un server Bare Metal noleggiato, intervieni sul relativo abbonamento anziché sull'ordine.

### Chiusura di un account (soft delete) {#closing-an-account-soft-delete}

L'account viene impostato come *eliminato*, bloccato, le sue sessioni vengono revocate e le commissioni di referral non ancora pagate vengono stornate. Fatture e registro contabile rimangono a fini contabili. L'azione viene rifiutata se il cliente possiede ancora **qualsiasi servizio attivo** (VM, Kubernetes, Private Cloud, Dedicated, VPN, proxy IPv6), un account S3 o un utilizzo S3 non saldato. Eliminali prima.

## Richieste di eliminazione {#deletion-requests}

Un cliente può richiedere l'eliminazione dalla pagina del proprio account. Le richieste compaiono in **Customers › Deletion requests** (filtro predefinito: in sospeso) con il cliente, il motivo, il numero di VM attive, il saldo e l'ora della richiesta.

- **Approve deletion** è possibile solo quando il cliente non ha alcuna VM attiva. Digita l'e-mail per confermare. L'account viene eliminato tramite soft delete; **il saldo residuo del portafoglio non viene rimborsato automaticamente** — crea prima un rimborso se è dovuto.
- **Reject** richiede una motivazione.

## Trasferimenti di servizi {#service-transfers}

**Customers › Service transfers** elenca le richieste di spostamento di una **VM o di un abbonamento VPN** da un account a un altro **sullo stesso sito**.

- La schermata è di sola lettura e creazione: puoi creare una richiesta per conto di un cliente o annullarla. Deliberatamente **non** è presente alcun pulsante per approvarla da parte del proprietario o del destinatario.
- Flusso: il proprietario conferma tramite un link e-mail monouso (valido 30 minuti, con TOTP se abilitato), quindi il destinatario effettua l'accesso e accetta (il destinatario si assume gli obblighi di pagamento). Una richiesta non accettata entro 7 giorni scade.
- Regole: il servizio deve essere attivo, senza fatture non pagate e senza processi in esecuzione; il destinatario deve essere un cliente attivo con un'e-mail verificata sullo stesso sito. Il trasferimento di una VM rimuove la chiave SSH e disattiva il rinnovo automatico; il trasferimento di una VPN modifica le password di connessione.
- Le fatture già emesse rimangono al precedente proprietario; il nuovo proprietario può leggere la cronologia di fatturazione del servizio con i dati del precedente proprietario nascosti.
- I clienti possono creare le proprie richieste in **Transfers** nel portale (5 richieste all'ora e 3 aperte contemporaneamente).

## Verifica {#verify}

1. Crea un cliente con un'e-mail di invito. Il nuovo account viene visualizzato in cima all'elenco nel giro di pochi secondi.
2. Ordina per **Balance**: l'ordine copre tutti i clienti.
3. Blocca il cliente: l'etichetta dello stato diventa *Locked* e il cliente non può più effettuare l'accesso. Sbloccalo.

## Limiti e note {#limits-notes}

- La colonna del paese è un'indicazione basata sull'IP, non una prova di residenza. Gli indirizzi privati o sconosciuti non restituiscono alcun paese.
- Il blocco di un account non rimborsa nulla e non elimina le VM a meno che tu non decida anche di arrestarle.
- Lo sblocco dell'account non sblocca le VM bloccate da un amministratore; sbloccale separatamente nella pagina della VM.

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| "Il cliente ha ancora servizi attivi... arresta/elimina prima" | Il cliente ha servizi attivi o un account S3 | Rimuovili, quindi procedi con l'eliminazione soft. |
| L'approvazione dell'eliminazione indica "N VMs alive" | Stesso motivo | Elimina prima le VM. |
| Viene mostrato il link di reset anziché "e-mail queued" | SMTP non configurato | Configura l'e-mail o invia il link tu stesso. |
| Impossibile rimuovere un metodo di accesso (`last_login_method`) | È l'unico modo per il cliente di effettuare l'accesso | Aggiungi prima un altro metodo. |
| Il blocco non interrompe i servizi prepagati | Sono stati segnalati errori di arresto | Leggi il messaggio dopo il blocco; il sistema tenta nuovamente l'arresto in modo automatico. |
| Impossibile creare un trasferimento | Fattura non pagata, operazione in corso, destinatario su un altro sito o non verificato | Risolvi la condizione e riprova. |