# Achar a conta do cliente no WHM pelo domínio em segundos

Como usar List Accounts para triagem diária: achar a conta pelo domínio, filtrar por revendedor ou pacote e identificar suspensão antes de investigar o site.

> abra **Account Information >> List Accounts** no WHM e pesquise por domínio, usuário ou IP: a linha de resultado já traz usuário cPanel, pacote, IP, versão de PHP (se o MultiPHP estiver configurado) e o destaque de conta suspensa.

João Rizzon · 2026-10-14 · Revenda

---

## O que a tela List Accounts responde em uma consulta

No WHM, `Account Information >> List Accounts` é a tela que lista todas as contas que você administra em um lugar só, com busca integrada e com os dados que a agência costuma precisar antes de abrir qualquer coisa: usuário cPanel, domínio principal, pacote, IP e estado da conta. A [documentação oficial do cPanel](https://docs.cpanel.net/whm/account-information/list-accounts/) descreve essa interface como a que lista e permite buscar as contas do servidor, com acesso rápido ao cPanel de cada uma.

Para quem mantém sites de clientes, o ganho é bem prático. O cliente manda uma mensagem citando só o domínio. Você precisa descobrir, em segundos, qual usuário cPanel é aquele, se a conta está suspensa, qual pacote está em uso e por onde entrar. Sem a lista, esse caminho vira tentativa e erro no gerenciador de contas.

## O que você precisa ter antes: root ou revendedor, e MultiPHP para ver PHP

- Acesso ao WHM como **root** (servidor inteiro) ou como **revendedor** (apenas as contas que você possui).
- A conta precisa existir no mesmo servidor. List Accounts não enxerga contas de outro servidor, nem de outra revenda.
- Para ver a coluna de versão de PHP por conta, o servidor precisa ter o MultiPHP configurado. Sem gerenciador MultiPHP ativo, não existe versão por conta a exibir.

Se você é revendedor, parta do princípio de que a lista já vem filtrada: ela mostra o que é seu. Isso é um recurso, não uma limitação, e evita que você mexa em conta de terceiro por engano.

## Do domínio ao usuário cPanel em cinco passos

### Onde fica List Accounts no menu do WHM

No menu lateral do WHM, use a busca e digite `List Accounts`, ou navegue por **Account Information >> List Accounts**.

### Buscar por domínio, por usuário ou por IP

A interface permite pesquisar as contas por critérios como **domínio**, **usuário** e **endereço IP**, além dos demais campos da listagem. Para o caso mais comum (o cliente mandou só o endereço do site), selecione domínio.

### Por que digitar `exemplo.com.br` e não `https://www.exemplo.com.br/`

Busque por `exemplo.com.br`, não por `https://www.exemplo.com.br/`. A caixa compara com o valor armazenado no registro da conta, e esse valor não guarda prefixo de protocolo nem `www.`: com eles, a busca não encontra nada. A comparação aceita fragmento, então `exemplo` retorna todas as contas cujo domínio contenha esse texto, e mais de uma linha pode voltar.

### Os seis campos da linha de resultado e o que cada um decide

O resultado traz, na mesma linha, os campos que decidem o próximo passo:

| Campo | Para que serve no dia a dia |
|---|---||
| Usuário (cPanel) | É o que você vai usar em SSH, FTP, nome de banco e prefixo de tabela |
| Domínio | Confirma que é a conta certa, e não um homônimo |
| Pacote (plan) | Diz quais limites a conta herdou: disco, contas de e-mail, bancos |
| IP | Identifica se a conta está em IP compartilhado ou dedicado |
| Versão de PHP | Mostra o que o site realmente roda, quando o MultiPHP está configurado |
| Estado suspenso | Contas suspensas aparecem destacadas na listagem |

### Entrar no cPanel do cliente sem pedir a senha

A própria listagem oferece acesso ao cPanel da conta a partir do resultado. Para a agência, isso corta o passo de pedir senha ao cliente: você entra como administrador do servidor.

**Resultado esperado:** uma única linha retornada, com o usuário cPanel correspondente ao domínio, e botão de acesso ao painel daquela conta.

## Filtrar por revendedor e por pacote quando a lista inteira é ruído

Quando você tem root em um servidor com várias revendas, ou gerencia carteiras separadas (clientes diretos, clientes de parceiro, sites internos), a lista completa é ruído. Dois recortes resolvem quase tudo.

Um aviso sobre o que é documentado e o que é prática: a [documentação do List Accounts](https://docs.cpanel.net/whm/account-information/list-accounts/) descreve a busca pelos campos da listagem, e proprietário e pacote estão entre as colunas exibidas. Se o critério de busca correspondente não aparecer na sua versão do WHM, ordene pela coluna e leia o bloco, o resultado prático é o mesmo. Os usos abaixo são rotina de operação, não parâmetro oficial.

**Por revendedor.** Útil para responder "quais contas estão sob o fulano" sem abrir conta por conta. É também o jeito mais rápido de conferir uma migração de carteira: se uma conta mudou de dono, ela some de uma lista e aparece na outra.

**Por pacote.** O pacote carrega os limites. Filtrar por pacote responde perguntas de operação que, de outro jeito, viram planilha: quais sites ainda estão no plano antigo, quais contas herdaram o pacote com limite de disco menor, quais precisam de upgrade antes da próxima campanha do cliente.

Um uso que compensa o tempo: antes de renovar contrato com um cliente, filtre por pacote e compare com o que está sendo cobrado. Divergência entre pacote entregue e pacote vendido é o tipo de erro que só aparece quando alguém olha a lista inteira.

## Conta suspensa aparece destacada, e isso descarta DNS, plugin e PHP

Contas suspensas recebem destaque visual na listagem. Isso faz da tela o lugar mais rápido para responder "o site do cliente caiu" quando a causa é administrativa, e não técnica.

O roteiro de triagem que vale padronizar na agência:

- Busque o domínio em List Accounts.
- Se a linha estiver destacada como suspensa, o problema não é DNS, não é plugin e não é PHP. É estado da conta.
- Confira o motivo e a data de suspensão no gerenciamento da conta antes de reativar. Suspensão por abuso, por inadimplência ou por limite excedido pedem tratativas diferentes.
- Só depois de descartar suspensão vá investigar aplicação, banco e DNS.

Frase pronta para o cliente, enquanto você investiga: *"Localizei a conta do seu domínio no servidor. A conta existe e os arquivos e e-mails seguem preservados, mas ela está suspensa no painel, por isso o site não abre e o visitante vê uma página de conta suspensa. Estou verificando o motivo e retorno com o prazo de reativação."* Serve porque é verdadeira e não promete o que você ainda não sabe.

## Quando a busca não devolve o que você esperava

### A busca por domínio não retorna nada, mas o site existe

Quase sempre o cliente informou um **domínio adicional, subdomínio ou domínio estacionado**, e não o domínio principal da conta. A listagem gira em torno do domínio principal registrado para cada conta. Saídas:

- Busque por um fragmento, só `exemplo` em vez de `loja.exemplo.com.br`.
- Procure pelo usuário cPanel, se o cliente souber informar.
- Se nada aparecer, confirme para onde o domínio aponta antes de concluir que a conta não existe:

```bash
dig +short exemplo.com.br A
dig +short www.exemplo.com.br CNAME
```

Se o IP de resposta não for o do seu servidor, a conta está em outro lugar. Isso acontece bastante com sites antigos que o cliente "acha" que estão com você.

### A coluna de versão de PHP não aparece

A versão de PHP por conta depende do MultiPHP estar configurado no servidor. Sem gerenciador MultiPHP ativo, não há versão por conta para listar: todas rodam a versão única do servidor. Nesse caso, confirme a versão em uso dentro do próprio cPanel ou via linha de comando, em vez de esperar o dado na listagem.

### A conta existe no servidor, mas não aparece para você

Se você entra como revendedor, só vê as contas que são suas. Conta pertencente a outro revendedor, ou criada diretamente pelo root fora da sua carteira, não aparece. Não é bug de busca. Peça ao administrador do servidor a transferência de propriedade da conta, se for o caso.

### Dois resultados para domínios parecidos

Busca por fragmento retorna tudo que contém o texto, como descrito no passo 3. `exemplo` traz `exemplo.com.br` e `exemplos.com`. Confira o domínio completo na linha antes de clicar em acessar o cPanel. Entrar na conta errada é o erro mais caro dessa tela.

## Transformar a consulta em rotina da agência

Transforme a tela em processo escrito, porque o ganho real aparece quando mais de uma pessoa do time usa o mesmo caminho.

- **Registre o usuário cPanel junto do domínio** na ficha do cliente. Buscar por usuário é mais confiável que buscar por domínio quando existem domínios adicionais.
- **Revisão mensal por pacote.** Filtre por pacote e compare com a lista de contratos. Ajuste divergências antes de o cliente notar.
- **Checklist de abertura de chamado:** domínio informado, usuário cPanel correspondente, estado da conta, pacote, IP, versão de PHP. Esses seis campos saem de uma única consulta e evitam a ida e volta com o cliente.
- **Antes de culpar o código**, olhe se a conta está suspensa. É o teste mais barato que existe e descarta uma classe inteira de hipóteses.

Uma observação honesta: List Accounts é tela de leitura e triagem. Ela não diz por que a conta foi suspensa, não mostra consumo de recursos em tempo real e não substitui log. Serve para você chegar rápido ao lugar certo, e é exatamente isso que ela faz bem.

## Fonte consultada

- cPanel, documentação oficial do WHM, [List Accounts](https://docs.cpanel.net/whm/account-information/list-accounts/), consultado em 13/10/2026.

