WHMCS e WHM: a conta nasce sozinha quando a fatura é paga
Como ligar WHMCS e WHM para o pagamento criar a conta cPanel, e a lista do que continua sendo trabalho manual em toda venda.

Resposta curta: a conta nasce sozinha quando quatro elos estão ligados: produto no WHMCS com módulo cPanel, grupo de servidores com token de API do WHM, nome exato do pacote do WHM no produto e a opção de setup automático em "After payment".
Neste artigo
- O encadeamento que faz a conta nascer paga
- Pré-requisito: licença e onde instalar o WHMCS
- Montando o produto que provisiona sozinho
- O campo de nameserver que faz o e-mail sair certo
- O que a automação não faz
- Checklist de padronização para quem tem muitos clientes
- Quando ainda vale criar a conta à mão
O encadeamento que faz a conta nascer paga
A automação de provisionamento não é um botão. É uma corrente de quatro elos, e ela quebra sempre no elo que ninguém configurou:
- Produto no WHMCS com módulo de servidor
cPanelativo. - Grupo de servidores apontando para a credencial do WHM da sua revenda (usuário e token de API).
- Pacote do WHM (o *package*) nomeado no campo do produto, que define disco, banda, contas de e-mail e banco.
- Ação automática na fatura paga, que o WHMCS dispara quando o pagamento é confirmado pelo gateway.
Se os quatro estão certos, o cliente paga e a conta é criada sem intervenção, com senha gerada, e-mail de boas-vindas enviado e login do cPanel funcionando. Quanto tempo isso leva não depende do módulo: depende de o gateway confirmar o pagamento e da fila de tarefas do WHMCS. Se o terceiro elo estiver com nome errado, a criação falha: o WHM recusa o pacote inexistente e o módulo devolve erro. O pedido fica marcado como pendente, com a mensagem do módulo registrada no log do módulo e no histórico do pedido, em Utilities > Logs > Module Log. Não existe queda silenciosa para um pacote padrão, o que muda o sintoma: em vez de cota errada daqui a um mês, você tem conta não criada agora. A documentação oficial do cPanel sobre instalação e licenciamento do WHMCS está em docs.cpanel.net. Vale ler antes de comprar licença, porque a forma de aquisição muda o que você precisa configurar depois.
Pré-requisito: licença e onde instalar o WHMCS
O WHMCS é software de terceiro, licenciado à parte da sua revenda. A documentação do cPanel descreve o caminho de compra e instalação da licença, e para por aí: ela não cobre configuração de produto, grupo de servidores ou pacote. Os caminhos de menu daqui para baixo são os da interface do WHMCS e do WHM, conferidos na tela, e podem mudar de lugar entre versões.
Duas decisões práticas antes de qualquer tela:
- Onde o WHMCS roda. Instalar o painel de faturamento dentro da mesma conta cPanel que hospeda sites de cliente é tentador e ruim. Se a conta for suspensa, por cota ou por qualquer motivo, você perde o sistema que gerencia as suspensões. Coloque o WHMCS em conta própria, com domínio próprio.
- Qual domínio aparece no e-mail. O domínio onde o WHMCS está instalado é o que o cliente vai ver em link de fatura e em redefinição de senha. Trocar depois dá trabalho.
Não instale em subdiretório temporário com a ideia de mover depois. A URL entra em e-mail transacional, em webhook de gateway e no registro de licença.
Montando o produto que provisiona sozinho
Três telas, nesta ordem. O WHMCS deixa salvar o produto antes de o servidor e o pacote existirem, então não é impedimento do sistema: é a ordem que evita retrabalho, porque o produto precisa do grupo de servidores e do nome do pacote já criados para apontar para alguma coisa.
1. Servidor
Em Setup > Products/Services > Servers, adicione o servidor da sua revenda. O módulo é cPanel. Preencha hostname, usuário do WHM e, de preferência, token de API em vez de senha. Token tem escopo e pode ser revogado sem trocar a senha do painel.
Use o botão de teste de conexão antes de sair da tela. Erro comum: hostname apontando para IP compartilhado com firewall bloqueando a porta do WHM, ou token criado sem permissão de criação de conta.
Depois crie um Server Group e coloque o servidor dentro. Mesmo com um servidor só. Produto aponta para grupo, não para servidor, e isso evita refazer tudo quando você adicionar a segunda revenda.
2. Pacote no WHM
No WHM, em Packages > Add a Package, crie um pacote por plano que você vende. Nomes sem acento, sem espaço, sem maiúscula inconsistente: site-basico, site-pro, loja-woo. O nome é string e será copiado à mão no WHMCS.
Defina no pacote o que o cliente pode usar: cota de disco, banda, número de contas de e-mail, bancos, subdomínios, e a feature list. É aqui que você decide se o plano barato tem acesso a cron ou a SSH, não no WHMCS.
3. Produto no WHMCS
Em Products/Services, crie o produto, defina preço e ciclo e vá à aba Module Settings:
- Module Name:
cPanel - Server Group: o grupo criado no passo 1
- Package Name: exatamente o nome do pacote do WHM
- Automatically setup the product: After payment
Essa última opção é o gatilho. "When order is placed" cria conta antes de o dinheiro entrar e vira porta para abuso. "Manually" é o que você está tentando abandonar.
| Opção de setup automático | Quando a conta é criada | Use quando |
|---|---|---|
| Manually | Nunca, você clica | Plano sob medida, migração combinada |
| When order is placed | No checkout, antes do pagamento | Quase nunca |
| After payment | Pagamento confirmado | Padrão recomendado |
| After manual acceptance of order | Você aprova o pedido | Venda com análise antifraude |
O campo de nameserver que faz o e-mail sair certo
O e-mail de boas-vindas é o único documento que o cliente vai guardar. Se ele sair com nameserver errado, você troca três mensagens por venda e perde o ganho da automação.
São dois lugares, e eles não conversam entre si:
- No servidor cadastrado no WHMCS, há campos de nameserver (normalmente quatro). O que você escrever ali é o que entra no template de boas-vindas.
- No WHM, na configuração de nameservers do servidor (Basic WebHost Manager Setup), fica o que ele usa ao criar a zona DNS de cada conta nova. É uma configuração do servidor inteiro, não por conta.
Preencha os dois com os mesmos valores, os da sua revenda ou os da hospedagem que revende. E faça o teste bobo: compre seu próprio produto com cupom de 100%, receba o e-mail, copie o nameserver do corpo da mensagem e confira se ele resolve.
# valide o nameserver que você colocou no WHMCS
dig +short ns1.seudominio.com.br
dig +short ns2.seudominio.com.br
# e confira se a zona do cliente responde por ele
dig +short NS dominiodocliente.com.br
Se dig não devolver IP para o nameserver, o e-mail está mandando o cliente para um lugar que não existe. Isso não aparece em teste de conexão do módulo.
O que a automação não faz
Esta é a tabela que evita promessa errada na proposta comercial. Tudo abaixo continua sendo trabalho humano, seu ou do cliente.
| Tarefa | Automatizada no pagamento | Quem faz, e quando |
|---|---|---|
| Criar a conta cPanel | Sim | WHMCS, via módulo |
| Definir cota, banda, e-mails | Sim | Pacote do WHM |
| Enviar login e senha | Sim | Template de boas-vindas |
| Apontar o domínio no registrador | Não | Cliente ou você, no painel do registrador |
| Emitir SSL do domínio do cliente | Não | Só depois do DNS apontado e propagado |
| Migrar site existente | Não | Backup/restore ou plugin, manual |
| Configurar e-mail no celular do cliente | Não | Suporte, caso a caso |
| Suspender por inadimplência | Sim, se ativado | WHMCS, conforme regra de cobrança |
| Apagar dados na suspensão | Não | Suspensão bloqueia acesso, não remove arquivo |
| Terminar conta e apagar dados | Sim, se ativado | Só na terminação, não na suspensão |
O ponto da penúltima linha costuma gerar discussão com cliente: suspender não apaga nada. O site sai do ar, o e-mail para de receber, os arquivos continuam lá. Quem apaga é a terminação, e ela só roda se você configurar prazo para isso.
Frase pronta para o cliente, por e-mail ou WhatsApp:
Checklist de padronização para quem tem muitos clientes
Faça uma vez, replique em toda venda:
- Um pacote no WHM por plano vendido, com nome em minúscula e sem espaço.
- Um produto no WHMCS por pacote. Relação 1 para 1, sem exceção criativa.
- Servidor cadastrado com token de API, não com senha do WHM.
- Produto apontando para grupo de servidor, mesmo com um servidor só.
- Setup automático em "After payment" em todos os produtos.
- Nameservers preenchidos no servidor do WHMCS e validados com
dig. - Template de boas-vindas revisado: link do cPanel, nameserver, aviso de que o domínio precisa ser apontado.
- Regra de suspensão e de terminação definida por escrito, com os dias, antes da primeira venda.
- Compra-teste com cupom de 100% a cada mudança de pacote ou de servidor.
- Token de API revogado e recriado quando alguém sai da equipe.
A compra-teste com cupom de 100% é o que mais economiza tempo. Mudança em pacote do WHM não dispara erro no WHMCS: ela só aparece na próxima conta criada, já errada.
Quando ainda vale criar a conta à mão
Automatizar tudo não é objetivo em si. Três casos em que o manual continua melhor:
- Migração de site existente. A conta precisa nascer vazia e com o domínio ainda apontado para o servidor antigo. Provisionar automático aqui costuma atrapalhar, porque cria a zona DNS local e confunde o teste de propagação.
- Plano fora da tabela. Cliente com cota ou recurso negociado. Criar produto novo para uma venda só polui o catálogo e quebra a relação 1 para 1 entre produto e pacote.
- Primeira venda após trocar de servidor. Faça uma conta manual pelo WHM antes de confiar no módulo. Se o WHM recusar, você descobre pelo erro real do painel, não por uma mensagem genérica de módulo.
Fora disso, cada conta criada à mão é um ponto onde o pacote errado entra no sistema e ninguém percebe.
Referências
- Documentação oficial (cpanel) — How to Purchase and Install WHMCS. Consultado em 2026-10-09.