blog
Revenda

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.

JR · · 7 min de leitura · 2 tabelas · 1 bloco de código

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
  1. O encadeamento que faz a conta nascer paga
  2. Pré-requisito: licença e onde instalar o WHMCS
  3. Montando o produto que provisiona sozinho
  4. O campo de nameserver que faz o e-mail sair certo
  5. O que a automação não faz
  6. Checklist de padronização para quem tem muitos clientes
  7. 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:

  1. Produto no WHMCS com módulo de servidor cPanel ativo.
  2. Grupo de servidores apontando para a credencial do WHM da sua revenda (usuário e token de API).
  3. Pacote do WHM (o *package*) nomeado no campo do produto, que define disco, banda, contas de e-mail e banco.
  4. 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.

Os quatro elos do provisionamento automáticoProduto no WHMCSMódulo de servidor cPanel ativoGrupo de servidoresCredencial do WHM, token de APIPacote no WHMDisco, banda, e-mails, feature listGatilho After paymentConta nasce com pagamento confirmado
Os quatro elos do provisionamento. A corrente quebra no elo não configurado, e o pedido fica pendente com erro no Module Log.

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:

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:

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:

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:

O que roda sozinho e onde começa o manualPagamento confirmadoGateway avisa o WHMCSConta cPanel criadaCota e limites vêm do pacoteE-mail de boas-vindasLogin, senha e nameserversApontar domínio: manualCliente ou você, no registradorEmitir SSL: manualSó após DNS propagadoMigrar site: manualBackup/restore ou plugin
Onde a automação termina. As três últimas caixas continuam sendo trabalho humano e precisam estar claras na proposta.

Checklist de padronização para quem tem muitos clientes

Faça uma vez, replique em toda venda:

  1. Um pacote no WHM por plano vendido, com nome em minúscula e sem espaço.
  2. Um produto no WHMCS por pacote. Relação 1 para 1, sem exceção criativa.
  3. Servidor cadastrado com token de API, não com senha do WHM.
  4. Produto apontando para grupo de servidor, mesmo com um servidor só.
  5. Setup automático em "After payment" em todos os produtos.
  6. Nameservers preenchidos no servidor do WHMCS e validados com dig.
  7. Template de boas-vindas revisado: link do cPanel, nameserver, aviso de que o domínio precisa ser apontado.
  8. Regra de suspensão e de terminação definida por escrito, com os dias, antes da primeira venda.
  9. Compra-teste com cupom de 100% a cada mudança de pacote ou de servidor.
  10. 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:

Fora disso, cada conta criada à mão é um ponto onde o pacote errado entra no sistema e ninguém percebe.

Referências

  1. Documentação oficial (cpanel) — How to Purchase and Install WHMCS. Consultado em 2026-10-09.
Leia também