# Criar conta de cliente no WHM sem quebrar a migração

O pacote reutilizável, as três decisões que definem se a migração vai doer, e a frase que explica ao cliente por que o site já está no servidor novo e o domínio ainda não.

> crie o pacote no WHM antes da conta, e resolva três decisões na ordem certa: roteamento de e-mail remoto enquanto o domínio fica no host antigo, versão de PHP travada no MultiPHP Manager antes de instalar o WordPress, e acesso entregue só no cPanel, porta 2083.

João Rizzon · 2026-09-17 · Revenda

---

Criar a conta do primeiro cliente no WHM leva dois minutos. Desfazer uma conta criada errada no meio de uma migração leva uma tarde, e o cliente assiste. São três decisões que definem se a migração vai doer: o que fazer com DNS e roteamento de e-mail enquanto o domínio ainda mora no provedor antigo, qual versão de PHP travar antes de instalar o WordPress (essa fica fora da tela de criação, no MultiPHP Manager) e o que você entrega de acesso no fim. Este é o processo que resolve os três de uma vez e vira padrão para os próximos clientes.

A referência de campos usada aqui é a página [Create a New Account](https://docs.cpanel.net/whm/account-functions/create-a-new-account/134/) da documentação do cPanel/WHM. Nomes de rótulo mudam entre versões; quando algo estiver diferente na sua build, a página oficial é quem manda.

## Crie o pacote antes da conta, sempre

O erro de agência mais comum é criar a primeira conta com limites digitados na mão. A segunda conta sai diferente. A décima não tem padrão nenhum, e aí você precisa editar dez contas para mudar uma cota.

Vá em **WHM > Packages > Add a Package** e monte um pacote por tipo de cliente que você atende, não por cliente. Dois ou três pacotes cobrem quase toda carteira de agência: site institucional WordPress, loja, e um plano maior para quem tem tráfego ou muitas caixas.

Exemplo de pacote (valores de exemplo, ajuste ao seu servidor e ao seu contrato):

| Campo do pacote | Institucional WP | Loja / volume maior |
|---|---|---||
| Disk Quota | 10 GB | 40 GB |
| Monthly Bandwidth | unlimited | unlimited |
| Max Addon Domains | 0 | 2 |
| Max Subdomains | 5 | 10 |
| Max Databases | 2 | 5 |
| Max Email Accounts | 10 | 30 |
| Max Email Per Hour | limite do servidor | limite do servidor |
| Shell Access | desativado | desativado |
| Feature List | agencia-padrao | agencia-padrao |
| cPanel Theme / Locale | jupiter / pt_BR | jupiter / pt_BR |

Duas escolhas do pacote merecem atenção porque são as que geram ticket depois:

- **Addon Domains em 0** no plano institucional. Se o cliente puder adicionar domínios, ele adiciona, e você descobre no dia em que o e-mail do domínio novo não funciona. Quando precisar, você aumenta em **Modify an Account**.
- **Feature List própria** em vez da `default`. Crie uma lista em **WHM > Feature Manager** com o que você quer que apareça no cPanel do cliente. Tirar da lista o que ele não deve mexer (cron, roteamento de e-mail, gerenciador de zona DNS, terminal) economiza mais tempo do que qualquer tutorial que você mande por e-mail.

Pacote pronto, a criação da conta passa a ser preencher domínio, usuário e senha. O resto é herdado.

## Os campos da tela e o que cada um cobra depois

A ordem da tela é: Domain Information, Package, Settings, Reseller Settings, DNS Settings e Mail Routing Settings.

Em **Domain Information**, três convenções que valem para a vida toda do servidor:

- **Domain**: use o domínio de produção, sem `www`. Mesmo que o site vá ficar semanas acessível só por URL temporária, a conta nasce com o domínio real. Criar a conta com um domínio provisório e renomear depois dá mais trabalho do que esperar.
- **Username**: padronize e nunca deixe o WHM sugerir. Algo como as primeiras letras da marca mais um sufixo curto (`acmebr`, `padariasol`). O nome do usuário aparece no caminho `/home/usuario`, no prefixo dos bancos e no prefixo dos usuários de banco, então ele entra em `wp-config.php` e em qualquer script de backup que você escrever. Trocar depois é possível, mas mexe em todos esses lugares.
- **Email**: coloque um endereço que a sua agência controla, não o do cliente. É esse endereço que recebe aviso de cota cheia e de falha de AutoSSL. Se o cliente precisa receber também, crie um alias ou redirecionamento no seu lado. Você quer ver o aviso de disco antes do cliente ver o site fora.

Em **Settings**, defina tema e idioma no pacote e confira aqui. Cliente brasileiro abrindo um cPanel em inglês gera pergunta que não é técnica.

Em **Reseller Settings**, não marque nada. A opção de transformar a conta em revendedora existe para quem revende para revendedor. Se você marcar por engano, o cliente ganha acesso a um WHM limitado, e é exatamente isso que você não quer entregar.

## DNS e e-mail enquanto o domínio ainda aponta para o host antigo

Aqui vive o mal-entendido mais caro da migração. A conta nova sempre nasce com uma zona DNS local no servidor. Essa zona não "briga" com a propagação: enquanto os nameservers no registrador apontarem para o provedor antigo, ninguém na internet consulta a sua zona. Ela só passa a valer quando você troca o NS no registrador.

O que a zona local faz desde o primeiro minuto é dizer ao próprio servidor para onde mandar e-mail daquele domínio. Esse é o risco real, e é o que você decide em **Mail Routing Settings**.

### Antes de criar a conta, olhe onde o domínio está

```
dig +short NS cliente.com.br
dig +short A cliente.com.br
dig +short MX cliente.com.br
```

Anote as três respostas no card da tarefa. Elas são o seu ponto de retorno se algo der errado, e o MX é o que decide o campo seguinte.

### Qual opção de Mail Routing Settings escolher em cada cenário

A documentação lista quatro opções: detecção automática da configuração, **Local Mail Exchanger**, **Backup Mail Exchanger** e **Remote Mail Exchanger**.

| Situação na migração | Escolha | Por quê |
|---|---|---||
| E-mail continua no provedor antigo, você está migrando só o site | Remote Mail Exchanger | O servidor entrega no MX externo em vez de tentar entregar na caixa local vazia |
| E-mail em Google Workspace, Microsoft 365 ou outro externo, permanente | Remote Mail Exchanger | Mesma razão, e vale para sempre nesse domínio |
| Site e e-mail vão os dois para o servidor novo agora | Local Mail Exchanger | Caixas criadas aqui recebem |
| Domínio novo, sem histórico | Local Mail Exchanger | Nada externo para respeitar |

A armadilha do "local" indevido é silenciosa: formulário de contato, aviso de pedido do WooCommerce e e-mail de reset de senha do WordPress saem do próprio servidor. Com roteamento local, essa mensagem é entregue na caixa local, que ninguém lê, e não chega no Gmail do cliente que está no provedor antigo. O cliente relata "formulário não funciona" e você vai procurar no plugin. Depois que o e-mail também estiver no servidor novo, troque em **cPanel > Roteamento de E-mail** ou em **WHM > Edit MX Entry**.

### O que DKIM, SPF e a opção de nameservers do registrador realmente fazem

Nessa seção ficam as caixas de DKIM, de SPF e a opção de usar os nameservers informados no registrador do domínio. Deixe DKIM e SPF ativados: eles entram na zona e só valem quando a zona valer, e você não vai querer lembrar disso no dia da troca.

Sobre a opção dos nameservers do registrador, um esclarecimento que evita expectativa errada: ela não impede a criação da zona local nem faz o servidor deixar de ser autoritativo para o domínio dentro dele. O que ela faz é preencher os registros NS da zona com os nameservers que o domínio usa no registrador, em vez dos nameservers padrão do servidor. Se o DNS do cliente é gerenciado fora (Cloudflare, painel do registrador, DNS de terceiro) e vai continuar fora, o que resolve é simplesmente não apontar o NS para a sua hospedagem: a zona local existe, ninguém a consulta, e ela fica inócua. Se o plano é usar os nameservers da sua hospedagem, deixe a opção desmarcada.

Duas regras práticas:

- **Não troque o NS no registrador no mesmo momento em que cria a conta.** Crie, suba o site, valide por URL temporária, e só então aponte. O artigo "Apontar o domínio para a hospedagem sem derrubar o e-mail" cobre a ordem dos registros nesse dia.
- **Se você criou a conta semanas antes e o IP do servidor mudou**, confira a zona em **WHM > Edit DNS Zone** antes de apontar. Zona antiga com IP velho é o clássico "apontei e continuou no site antigo".

## Trave a versão de PHP antes de instalar o WordPress

Essa decisão não está na tela de criação de conta, e é justamente por isso que ela é esquecida. A sequência que dá menos retrabalho é: conta criada, versão de PHP definida, só então WordPress instalado. Não o contrário.

O motivo é operacional, não filosófico. O instalador do WordPress e vários plugins escrevem arquivos que dependem do handler ativo (`.htaccess`, `php.ini` ou `.user.ini` na pasta, cache de página pré-compilado por plugin de cache). Se você instala em PHP 7.4 porque era o default do servidor e depois muda para 8.2, precisa revisitar esses arquivos, limpar cache de objeto e de página, e torcer para que o tema não use nada removido. Instalar já na versão de destino elimina a etapa.

### Onde definir a versão de PHP no WHM e no cPanel

- **WHM > MultiPHP Manager**: define o default do servidor e permite alterar por conta. Ajuste o default para a versão que você usa hoje na maioria dos sites, assim contas novas já nascem certas.
- **cPanel > MultiPHP Manager** (entrando na conta): define por domínio, o que você usa quando um cliente tem um sistema legado preso em versão antiga.
- **MultiPHP INI Editor**: `memory_limit`, `max_execution_time`, `upload_max_filesize`, `post_max_size`. Ajuste aqui antes de importar um backup grande, não durante o erro de importação.

O passo a passo por tela está em "Como mudar a versão do PHP no cPanel"; a diferença é que aqui você faz isso na conta vazia, o que leva trinta segundos e não tem risco.

### Como confirmar que a versão de PHP pegou no domínio

`php -v` no terminal mostra o PHP de linha de comando, que pode ser outro. O que importa é o handler do domínio. Crie um arquivo temporário em `public_html`:

```php
<?php echo PHP_VERSION;
```

E leia pelo IP do servidor, sem depender do DNS ainda apontado (IP de exemplo, use o do seu servidor):

```
curl -sk --resolve cliente.com.br:443:203.0.113.10 \
  https://cliente.com.br/_phpver.php
```

O `-k` é necessário porque o AutoSSL ainda não emitiu certificado para esse domínio: enquanto o DNS não aponta para o servidor, a validação não passa. Apague o arquivo depois de ler. Deixar um `phpinfo()` público em conta de cliente é entregar o mapa da casa.

## O cliente recebe cPanel na porta 2083, nunca WHM

O WHM controla todas as contas do servidor. Não existe cenário em que o cliente final precise dele. O acesso dele é o cPanel da própria conta, e você entra como ele pelo **WHM > List Accounts > Log in as user**, sem precisar guardar a senha do cliente.

| Serviço | Porta | Quem usa |
|---|---|---||
| cPanel (HTTPS) | 2083 | cliente e agência |
| WHM (HTTPS) | 2087 | só a agência |
| Webmail (HTTPS) | 2096 | cliente e equipe dele |

Endereço de acesso, na ordem de preferência:

- `https://hostname-do-servidor:2083`, com o hostname que tem certificado válido. Funciona antes, durante e depois da migração, e não dá aviso de segurança no navegador.
- `https://cliente.com.br:2083` ou `https://cliente.com.br/cpanel`, depois que o domínio já aponta para o servidor. Antes disso, essa URL leva ao host antigo.
- `https://IP:2083` só como último recurso. Vai dar alerta de certificado e o cliente vai te ligar por causa do alerta.

Para a equipe do cliente, não compartilhe a senha principal do cPanel. Crie o que cada pessoa precisa: caixa de e-mail em **Contas de E-mail**, acesso a arquivos em **Contas FTP** apontando para uma pasta específica. O usuário principal fica com você e com o responsável, e ponto.

## Checklist de 12 itens para criar cada conta nova

Cole isso no seu gestor de tarefas como template. Um card por cliente novo.

```
[ ] 1. Pacote correto existe no WHM (nao criar limites na mao)
[ ] 2. dig NS / A / MX do dominio anotados no card
[ ] 3. Create a New Account
       Domain: dominio real, sem www
       Username: padrao da agencia
       Package: institucional | loja
       Email: endereco da agencia
       Reseller Settings: nada marcado
       DNS: DKIM e SPF ativos; NS do registrador conforme o caso
       Mail Routing: Remote se o e-mail fica no host antigo
[ ] 4. MultiPHP Manager: versao de destino na conta
[ ] 5. MultiPHP INI Editor: memory_limit e upload conforme o site
[ ] 6. Instalar/restaurar o WordPress
[ ] 7. Validar por --resolve ou arquivo hosts, ainda sem trocar DNS
[ ] 8. Apagar arquivos de teste (_phpver.php, info.php, backups no public_html)
[ ] 9. Registrar no gestor: usuario, URL de acesso, pacote, versao PHP, roteamento de e-mail
[ ] 10. Enviar acesso ao cliente: cPanel na 2083, nunca WHM
[ ] 11. Agendar a troca de NS no registrador (janela combinada)
[ ] 12. Pos-troca: conferir AutoSSL emitido e trocar roteamento de e-mail se aplicavel
```

Os itens 9 e 12 são os que somem primeiro quando a migração corre bem. São também os dois que você vai querer ter feito seis meses depois, quando o cliente pedir uma alteração e ninguém lembrar em que versão de PHP aquele site roda.

## A frase para mandar ao cliente antes de trocar o NS

O momento em que o site já está no servidor novo mas o domínio ainda aponta para o antigo é o que mais gera ansiedade. O cliente abre o site, vê tudo igual, e conclui que nada aconteceu. Ou abre, vê o site novo em uma URL estranha, e acha que o domínio quebrou.

Mande isso:

> **** Seu site já está instalado e funcionando no servidor novo. O endereço cliente.com.br continua sendo entregue pelo provedor antigo até fazermos a troca dos nameservers no registrador, agendada para [data e hora]. Até lá, nada muda para quem acessa o site, e seus e-mails continuam chegando normalmente no provedor atual. Para conferir o site novo antes da troca, use este link temporário: [link]. Depois da troca, a atualização leva algumas horas para valer em todos os provedores de internet, e nesse período uma pessoa pode ver a versão nova e outra a antiga por um tempo curto. Seu acesso ao painel de hospedagem é este: [URL do cPanel na porta 2083], usuário [usuario].

Se o cliente perguntar por que existe essa espera, uma frase resolve: "o endereço do site é como um catálogo telefônico distribuído em milhares de cópias pelo mundo, e cada cópia atualiza no seu tempo". Não é preciso falar de TTL com quem não pediu.

## Onde essa rotina costuma dar errado

- **Conta criada com domínio que já existe no servidor.** O WHM recusa. Normalmente o domínio está como addon ou alias em outra conta, de um teste anterior. Procure em **WHM > List Accounts** e em **Domains** antes de recriar.
- **Pacote errado escolhido.** Não apague a conta. Use **WHM > Modify an Account** e troque o pacote. Antes de trocar, confira o uso atual de disco da conta em **WHM > List Accounts**: a cota do pacote novo passa a valer de imediato, e se ela for menor que o uso atual você mesmo precisa decidir se limpa arquivos ou escolhe outro pacote.
- **Roteamento de e-mail esquecido em local.** Sintoma: formulário de contato e e-mail transacional do WordPress não chegam, e o log de e-mail mostra entrega local. Corrija em **Roteamento de E-mail** e teste de novo.
- **AutoSSL não emitiu certificado.** Enquanto o DNS do domínio não aponta para o servidor, a validação não conclui. Depois da troca de NS, rode a execução do AutoSSL na conta e confira em **SSL/TLS Status**. Cobrar certificado antes do apontamento é perder tempo.
- **Arquivo de teste esquecido no public_html.** `_phpver.php`, `info.php`, um `.zip` de backup de 800 MB. Vira exposição e vira consumo de disco. O item 8 do checklist existe por isso.

A parte de dimensionamento do servidor que segura essas contas, latência e cache, está em "VPS com cPanel para agência". Este texto cobre a tarefa: a conta do cliente nascendo certa, na primeira vez e nas próximas cinquenta.

