Gerenciando clientes

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

O que faz

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

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 funcional.

A lista de clientes

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

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

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

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
Security	Sessões, autenticação, métodos de login, histórico de login e chaves de API; consulte Chaves de API
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.
Credit / debit	Adiciona ou remove saldo da carteira por meio de um ajuste no razão. Consulte 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

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)

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

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

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

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

• 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

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.