blog
Revenda

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.

JR · · 12 min de leitura · 3 tabelas · 4 blocos de código

Resposta curta: 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.

Neste artigo
  1. Crie o pacote antes da conta, sempre
  2. Os campos da tela e o que cada um cobra depois
  3. DNS e e-mail enquanto o domínio ainda aponta para o host antigo
  4. Trave a versão de PHP antes de instalar o WordPress
  5. O cliente recebe cPanel na porta 2083, nunca WHM
  6. Checklist de 12 itens para criar cada conta nova
  7. A frase para mandar ao cliente antes de trocar o NS
  8. Onde essa rotina costuma dar errado

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 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:

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:

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:

  1. 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.
  2. 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".
Qual roteamento de e-mail marcar na criaçãoE-mail fica no host antigoEscolha Remote Mail ExchangerE-mail em Google ou MicrosoftRemote Mail Exchanger, permanenteSite e e-mail vêm juntosLocal Mail ExchangerDomínio novo, sem históricoLocal Mail ExchangerDepois da migração do e-mailTroque em Roteamento de E-mail
Decisão de Mail Routing na criação da conta, por cenário de migração.

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

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

Ordem das etapas na conta novaPacoteLimites por tipo de clienteContaDomínio real, usuário padronizadoPHPVersão de destino na contaWordPressInstalar ou restaurar backupValidarTestar antes de trocar NS
Ordem que evita retrabalho: PHP definido na conta vazia, antes do WordPress.

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:

  1. 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.
  2. 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.
  3. 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:

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

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.

Referências

  1. Documentação oficial (cpanel) — Create a New Account. Consultado em 2026-09-16.
Leia também