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

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

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

---

## 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 `cPanel` ativo.
- **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](https://docs.cpanel.net/knowledge-base/third-party/how-to-purchase-and-install-whmcs/). 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.

```bash
# 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:

> **** "Sua hospedagem está suspensa por falta de pagamento. Nada foi apagado: arquivos, banco de dados e e-mails continuam no servidor. Assim que o pagamento for confirmado, o site volta ao ar automaticamente, sem precisar reenviar nada."

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

