---
title: Gerenciando clientes
description: Encontre e atenda clientes: lista de clientes, país por IP, origem de indicação, ações de conta, pedidos de exclusão e transferências.
url: https://nexcmp.com/pt/docs/customers/managing-customers/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Gerenciando clientes {#managing-customers}

> **Onde no admin:** Customers › Customers › List (`/customers`), Deletion requests (`/customers/requests`), Service transfers (`/customers/transfers`) e API keys (`/customers/apikeys`).

## O que faz {#what-it-does}

A área de Clientes é onde a equipe de suporte consulta uma conta, visualiza sua carteira, serviços, tickets e histórico de login, além de tomar medidas: bloquear, desbloquear, verificar e-mail, redefinir a senha, adicionar ou remover crédito, personificar, criar uma VM ou fechar a conta.

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Função | Um administrador. Cada ação de gravação solicita um motivo e é registrada no log de auditoria (System › Logs › Admin actions). |
| E-mail | E-mails de redefinição de senha e convite exigem uma [SMTP configuration](https://nexcmp.com/pt/docs/administration/smtp-and-emails/) funcional. |

## A lista de clientes {#the-customer-list}

Abra **Customers › List**. Os clientes são contas do seu site principal; contas de revendedores também aparecem e podem ser filtradas por site.

![Lista de clientes com os filtros e as colunas de país, origem de indicação, saldo e contagem de VMs](https://nexcmp.com/pt/docs/images/customers/managing-customers-01-list.webp)

| Coluna | Significado |
|---|---|
| **Email** (e nome) | Clique para abrir o cliente. |
| **State** | *Active*, *Locked* ou *Deleted*, além de e-mail *verified* ou *unverified*. Passe o mouse sobre uma tag de bloqueio para ler o motivo. |
| **Login** | Métodos de login que o cliente possui: senha, Google, GitHub, passkey. |
| **Country** | Bandeira e nome derivados do **IP address**: o país do IP de registro ou, quando este for desconhecido, do último IP de login. A dica de ferramenta indica qual foi usado. |
| **Referral source** | *Referral* com um link para quem indicou e o código de indicação quando o cliente se registrou através de um link de afiliado; caso contrário, "Not recorded". |
| **Balance**, **VMs** | Saldo da carteira (valores negativos em vermelho) e o número de VMs ativas. |
| **IP registrado / último** | O IP usado no cadastro e no último login com um país de duas letras. Use para identificar várias contas de um mesmo endereço. |
| **Tenant** | O ID de tenant interno do cliente. |
| **Created**, **Last login** | Tempos relativos. |
| **Site** | Exibido quando você possui revendedores. |

**Search** aceita e-mail, nome ou IP. **Filters:** estado (all, active, locked, deleted), método de login (any, Google, GitHub, passkey, no password yet) e site. Os filtros são mantidos na URL, permitindo salvar a lista filtrada nos favoritos ou compartilhá-la com um colega.

**A ordenação é global.** Clicar no cabeçalho de *Email*, *State*, *Balance*, *VMs*, *Created* ou *Last login* ordena a base de clientes **inteira** no servidor, e não apenas a página que você está visualizando, e o número da página volta para 1.

**A lista é atualizada automaticamente.** Ela é atualizada a cada poucos segundos enquanto você a visualiza (pausando enquanto uma caixa de diálogo estiver aberta ou enquanto você digita), de modo que novos cadastros e alterações de saldo aparecem sem a necessidade de recarregar a página. A página do cliente é atualizada a cada 30 segundos aproximadamente enquanto estiver visível; cada aba carrega seus próprios dados ao ser aberta pela primeira vez.

### Criar um cliente {#create-a-customer}

1. Clique em **Create customer**.
2. Insira o **e-mail**, um **display name** opcional, uma **password** opcional (vazio = o cliente define através do link de convite) e escolha se deseja **send the invitation e-mail**.
3. Confirme. Uma conta criada manualmente conta como verificada quando você envia o convite.

## A página de um cliente {#a-customer-s-page}

Clique em uma linha. A página possui oito abas; a aba selecionada é mantida na URL para que você possa salvá-la nos favoritos. As abas são carregadas ao serem abertas pela primeira vez e mantêm seu estado quando você alterna entre elas.

| Aba | Conteúdo |
|---|---|
| **Overview** | Identidade, informações de cadastro e do último login, resumo da carteira e dos serviços |
| **Services** | Uma tabela para os serviços do cliente, com filtros de tipo e estado, busca, ordenação no servidor e paginação |
| **Billing** | Carteira e crédito, livro-razão, faturas, pagamentos, reembolsos, forma de pagamento salva e recarga automática |
| **Quota** | Limites e sobreposições de recursos; consulte [Cotas](https://nexcmp.com/pt/docs/billing/quotas/) |
| **Security** | Sessões, autenticação, métodos de login, histórico de login e chaves de API; consulte [Chaves de API](https://nexcmp.com/pt/docs/developers/api-keys/) |
| **Support** | Tickets recentes |
| **Affiliate** | Status do programa de indicação |
| **Log** | Histórico de auditoria e atividade |

Botões de ação no cabeçalho (ocultos para contas excluídas):

| Botão | O que faz |
|---|---|
| **Lock account** / **Unlock** | Bloqueia o login e o acesso à API. Opcionalmente, também para todas as VMs (sem excluí-las). Serviços pré-pagos que não são VMs (Kubernetes, Private Cloud, VPN e assim por diante) também são parados. VMs bloqueadas por um administrador devem ser abertas separadamente na página da VM. |
| **Verify email** | Marca o e-mail como verificado sem que o cliente precise clicar em um link. |
| **Send reset link** | Envia um e-mail com um link de redefinição de senha (válido por 1 hora, uso único). Se o SMTP não estiver configurado, o link será exibido uma vez para que você possa enviá-lo manualmente. Um administrador nunca vê a senha. |
| **Impersonate** | Entra como o cliente por uma hora. Consulte [Log in as a customer](https://nexcmp.com/pt/docs/customers/login-as/). |
| **Credit / debit** | Adiciona ou remove saldo da carteira por meio de um ajuste no razão. Consulte [Invoices and ledger](https://nexcmp.com/pt/docs/billing/invoices-and-ledger/). |
| **Revoke sessions** | Desconecta o cliente em todos os lugares; os tokens de aplicativo deixam de funcionar. |
| **Create VM** | Cria uma VM para o cliente. |
| **Soft delete** | Encerra a conta. Você deve digitar o e-mail para confirmar. |


### Gerenciar um serviço individual {#manage-an-individual-service}

Abra a aba **Services** do cliente, localize um serviço por nome, ID, IP ou configuração e use as ações de linha. As mesmas ações estão disponíveis na própria lista de administração do serviço. A caixa de diálogo oferece apenas ações compatíveis com esse serviço e seu estado atual.

| Ação | Efeito |
|---|---|
| **Lock** | Interrompe o serviço mantendo seus dados. O cliente o visualiza como bloqueado e não pode operá-lo. Fazer uma recarga não remove o bloqueio aplicado por um administrador; a renovação automática fica bloqueada enquanto estiver bloqueado. |
| **Unlock** | Reverte o bloqueio do administrador. Não remove bloqueios não relacionados por abuso ou outras proteções. |
| **Cancel without refund** | Cancela o serviço sem lançamento de reembolso no ledger. A confirmação avisa que o cancelamento não pode ser desfeito. |
| **Cancel and refund** | Mostra os pagamentos originais, a alocação de carteira/crédito, reembolsos anteriores e o valor máximo reembolsável. Revise o valor antes de confirmar. |

Insira um motivo para cada ação. O motivo é destinado aos administradores; o cliente recebe um evento de serviço neutro ou uma notificação. O saldo reembolsado da carteira retorna para a carteira, e os créditos ou alocações promocionais retornam aos créditos. Esta ação não devolve valores via Stripe, transferência bancária ou PayPal.

Para vários serviços do mesmo tipo, selecione até 50 linhas e escolha uma ação em massa. O resultado lista o sucesso ou a falha de cada linha. Os reembolsos em massa usam o valor sugerido de cada serviço; serviços cujo reembolso sugerido seja zero são ignorados no modo de reembolso e precisam de revisão individual ou cancelamento sem reembolso.

DDoS Shield, discos e backups são linhas somente leitura aqui. Add-ons de largura de banda acompanham seu serviço pai. O acesso a AI Models pode ser bloqueado, mas não possui uma assinatura para cancelar. Para bloquear um servidor Bare Metal alugado, atue na assinatura dele em vez do seu pedido.

### Encerrando uma conta (exclusão lógica / soft delete) {#closing-an-account-soft-delete}

A conta é definida como *deleted*, bloqueada, suas sessões são revogadas e suas comissões de indicação ainda não pagas são estornadas. As faturas e o razão permanecem para fins contábeis. A ação é recusada enquanto o cliente ainda tiver **qualquer serviço ativo** (VM, Kubernetes, Private Cloud, Dedicated, VPN, proxy IPv6), uma conta S3 ou uso de S3 pendente de pagamento. Exclua esses itens primeiro.

## Solicitações de exclusão {#deletion-requests}

Um cliente pode solicitar a exclusão na página da sua conta. As solicitações aparecem em **Customers › Deletion requests** (filtro padrão: pendentes) exibindo o cliente, o motivo, o número de VMs ativas, o saldo e o horário da solicitação.

- **Approve deletion** só é possível quando o cliente não tem nenhuma VM ativa. Digite o e-mail para confirmar. A conta passa por exclusão lógica; **o saldo restante da carteira não é reembolsado automaticamente** — crie um reembolso primeiro se houver valores a pagar.
- **Reject** exige um motivo.

## Transferências de serviços {#service-transfers}

**Customers › Service transfers** lista as solicitações para mover uma **VM ou uma assinatura de VPN** de uma conta para outra **no mesmo site**.

- A tela é apenas de leitura e criação: você pode criar uma solicitação em nome de um cliente ou cancelar uma. Deliberadamente, **não** há um botão para aprová-la pelo proprietário ou pelo destinatário.
- Fluxo: o proprietário confirma por meio de um link de e-mail de uso único (válido por 30 minutos, com TOTP se ativado), então o destinatário faz login e aceita (o destinatário assume as obrigações de pagamento). Uma solicitação não aceita em até 7 dias expira.
- Regras: o serviço deve estar ativo, sem fatura em aberto e sem tarefa em execução; o destinatário deve ser um cliente ativo com e-mail verificado no mesmo site. A transferência de uma VM remove a chave SSH e desativa a renovação automática; a transferência de uma VPN altera as senhas de conexão.
- As faturas já emitidas permanecem com o proprietário anterior; o novo proprietário pode ler o histórico de faturamento do serviço com os dados do proprietário anterior ocultos.
- Os clientes podem criar suas próprias solicitações em **Transfers** no portal (5 solicitações por hora e 3 abertas por vez).

## Verificar {#verify}

1. Crie um cliente com um e-mail de convite. A nova conta aparece no topo da lista em poucos segundos.
2. Ordenar por **Balance**: a ordem abrange todos os clientes.
3. Bloquear o cliente: a etiqueta de estado muda para *Locked* e o cliente não pode mais fazer login. Desbloqueie-o.

## Limites e notas {#limits-notes}

- A coluna de país é uma orientação baseada em IP, não uma prova de residência. Endereços privados ou desconhecidos não fornecem país.
- Bloquear uma conta não reembolsa nada e não exclui VMs, a menos que você também escolha interrompê-las.
- Desbloquear a conta não desbloqueia VMs que um administrador bloqueou; abra-as separadamente na página da VM.

## Resolução de problemas {#troubleshooting}

| Sintoma | Causa | Correção |
|---|---|---|
| "O cliente ainda possui serviços ativos... pare/exclua primeiro" | O cliente possui serviços ou uma conta S3 | Remova-os e, em seguida, faça a exclusão lógica. |
| A aprovação de exclusão diz "N VMs alive" | Mesmo motivo | Exclua as VMs primeiro. |
| Link de redefinição exibido em vez de "e-mail queued" | SMTP não configurado | Configure o e-mail ou envie o link você mesmo. |
| Não é possível remover um método de login (`last_login_method`) | É a única forma de o cliente fazer login | Adicione outro método primeiro. |
| O bloqueio não interrompe os serviços pré-pagos | Erros de interrupção foram relatados | Leia a mensagem após o bloqueio; o sistema tenta parar automaticamente novamente. |
| Uma transferência não pode ser criada | Fatura não paga, tarefa em execução, destinatário em outro site ou não verificado | Corrija a condição e tente novamente. |