Automatize a venda de hospedagem com o WHMCS: instalação e uso do módulo de revenda da Domain Name API

Para quem é este guia: revendedores da Domain Name API que querem automatizar a venda de hospedagem com o WHMCS. Última atualização: 5 de outubro de 2026 Fontes: documentação oficial do módulo DNA Reseller Hosting (GitHub) e documentação do WHMCS

Versão rápida: coloque o módulo para funcionar em 7 passos

1. Pegue o endereço do servidor, o usuário, a senha e o token de API no painel da Domain Name API.
2. Baixe o módulo no GitHub e copie a pasta dnahosting para modules/servers/ no WHMCS.
3. No WHMCS, adicione o servidor em Servers > Add New Server e escolha DNA Reseller Hosting como módulo.
4. Confirme a conexão com Test Connection e salve o servidor.
5. Crie um grupo de servidores e coloque o servidor nele.
6. Na aba Module Settings do seu produto de hospedagem, escolha o módulo, o grupo e o nome do pacote.
7. Faça um pedido de teste para confirmar que a conta abre no seu painel de revenda.

O que o módulo faz?

O DNA Reseller Hosting é um módulo de servidor (provisioning) que permite gerenciar pelo WHMCS as contas de hospedagem dos seus clientes, através da conta de revenda cPanel ou Plesk que você recebe da Domain Name API. O módulo trabalha com as permissões da sua conta de revenda, não com acesso root ou admin; cada conta aberta conta na sua cota de revenda.

Antes de começar

Se ainda não tiver um pacote, crie antes: veja Como criar um pacote de hospedagem no WHM para cPanel ou Como criar um Service Plan no Plesk para Plesk.

Instalação passo a passo

Passo 1: pegue seus dados de conexão

Para o WHMCS se conectar à sua conta de revenda, ele precisa do endereço do servidor, do seu usuário de revenda, da sua senha e de um token de API. Você recebe esses dados depois do pedido e pode vê-los quando quiser no painel da Domain Name API.

1. Entre no painel da Domain Name API e abra a seção Reseller Hosting e a lista de serviços de hospedagem.
2. Clique no ícone de engrenagem ao lado do seu serviço de revenda ativo.
3. Abra a aba do painel de controle. Ali aparecem os endereços do painel, o usuário, a senha e o token de API; copie com os ícones de copiar.

Passo 2: baixe o módulo e envie para o WHMCS

Baixe o módulo no GitHub e copie a pasta dnahosting do pacote para o diretório modules/servers da sua instalação do WHMCS. Repositório do módulo: domainreseller/reseller-hosting-whmcs. Nenhuma tabela é criada no banco de dados, não é preciso configurar cron e não há dependências do Composer.

Passo 3: adicione o servidor no WHMCS

Vá em Configuration > System Settings > Servers > Add New Server, escolha DNA Reseller Hosting como módulo e informe os dados do Passo 1.

Passo 4: teste a conexão

Clique em Go to Advanced Mode > Test Connection. Se os dados estiverem certos, aparece uma mensagem de sucesso; depois salve o servidor.

Passo 5: crie um grupo de servidores

Em Servers > Create New Group, crie um grupo e coloque o servidor nele, ou adicione o servidor a um grupo existente. No WHMCS, os produtos são ligados a um grupo, não direto a um servidor.

Você pode colocar servidores cPanel e Plesk no mesmo grupo; o módulo detecta o tipo de painel de cada servidor automaticamente.

Passo 6: ligue seu produto ao módulo

Crie um produto de hospedagem novo ou edite um existente em Configuration > System Settings > Products/Services e, na aba Module Settings, escolha o módulo, o grupo e o nome do pacote.

Na mesma aba, escolha quando o produto é instalado automaticamente. Para a maioria dos revendedores, a opção certa é Automatically setup the product as soon as the first payment is received: a conta abre quando o pagamento chega. Se você quiser aprovar os pedidos manualmente, use when you manually accept a pending order.

Passo 7: confirme com um pedido de teste

Antes do primeiro cliente real, faça um pedido deste produto em nome de um cliente de teste e confirme de ponta a ponta que a conta abre.

Ao terminar o teste, remova o serviço de teste no WHMCS com Terminate. Assim a conta também é excluída do seu painel de revenda e não ocupa cota. Se você usar só Delete, a conta continua no painel.

Usando o módulo no dia a dia

Depois da instalação, criação, suspensão, reativação e encerramento de contas ficam totalmente sob controle do WHMCS. Quando você faz essas ações no WHMCS, o módulo aplica cada uma no seu painel de revenda.

Suspensão e encerramento automáticos

A suspensão automática de serviços não pagos, a reativação após o pagamento e o encerramento dos que ficam muito tempo sem pagamento dependem das Automation Settings e do cron do sistema do WHMCS, não do módulo. Quando o WHMCS dispara essas ações, o módulo as aplica no painel. Para as configurações, veja a página Automation Settings na documentação do WHMCS.

Diferenças entre cPanel e Plesk

Solução de problemas

Quando uma ação do módulo falha, o primeiro lugar para olhar é o Activity Log. O módulo registra ali toda ação que falhou, com o prefixo dnahosting:, o número do serviço e o domínio.

Module Debug Mode: Setup > General Settings > Other > Module Debug Mode. Ative logo antes de reproduzir o problema e desative ao terminar. Linhas com o prefixo note: não são requisições, e sim explicações do próprio módulo. Tokens de API e senhas de clientes nunca são gravados em texto simples nos registros.

Atualizando o módulo

Para passar para uma versão nova, substitua a pasta modules/servers/dnahosting/ pela pasta da nova versão e confirme a conexão com Test Connection. Como o módulo guarda as configurações de produto por posição, as configurações novas são sempre adicionadas no fim da lista, então as configurações atuais dos seus produtos são mantidas. As mudanças de cada versão ficam no arquivo CHANGELOG.md do repositório.

Perguntas frequentes

O que é o módulo WHMCS da revenda de hospedagem Domain Name API?

O DNA Reseller Hosting é um módulo de servidor que conecta ao WHMCS a conta de revenda cPanel ou Plesk que você recebe da Domain Name API. Quando seus clientes compram hospedagem no WHMCS, a conta abre automaticamente; suspensão, reativação, encerramento e trocas de senha e pacote também são feitos pelo WHMCS.

Onde eu baixo o módulo?

No repositório da Domain Name API no GitHub (domainreseller/reseller-hosting-whmcs). Para usar, você precisa de uma revenda de hospedagem Domain Name API ativa e da sua própria licença do WHMCS.

O módulo funciona com cPanel e com Plesk?

Sim. Um único módulo atende os dois painéis e detecta o tipo de painel de cada servidor automaticamente. O mesmo produto pode ser ligado a um grupo com servidores cPanel e Plesk. Override de disco/tráfego e IP dedicado só valem no cPanel.

Onde encontro os dados para colocar no WHMCS?

No painel da Domain Name API, abra a seção Reseller Hosting, clique no ícone de engrenagem ao lado do seu serviço e abra a aba do painel de controle. Ali aparecem o endereço do servidor, o usuário, a senha e o token de API.

O que eu coloco no campo Hostname?

Só o endereço do servidor: sem https:// no início e sem porta no final. Por exemplo, se o painel mostra https://<server-address>:2087, coloque no WHMCS apenas a parte <server-address>.

O Test Connection falha. O que eu faço?

Confira primeiro a porta: o cPanel usa 2087 e o Plesk 8443; se deixar vazio, o módulo escolhe a certa. Depois confira se o hostname está sem https:// e sem porta, se o token foi gerado no WHM e se a restrição de IP do token inclui o IP do seu servidor WHMCS.

O que eu coloco no campo Package / Plan?

O nome do pacote ou plano do seu painel de revenda. No cPanel, sem o prefixo: para um pacote exibido como exampleuser_paket2, digite só paket2. No Plesk, use o nome do Service Plan.

Preciso configurar um cron para o módulo?

O módulo em si não precisa de cron próprio. Mas a suspensão automática, a reativação após o pagamento e o encerramento automático dependem do cron do sistema do WHMCS, então garanta que ele rode regularmente.

Onde contam as contas que eu abro?

O módulo trabalha com as permissões da sua conta de revenda. Cada conta aberta pelo WHMCS conta na sua cota de revenda da Domain Name API e aparece no seu painel de revenda.

Como meu cliente entra no painel dele?

O cliente entra no painel cPanel ou Plesk com um clique pelo botão Log in to Panel na área do cliente do WHMCS. O botão Log in to Server, na lista de servidores, só funciona em servidores cPanel.

Posso mudar pelo WHMCS os limites de disco e tráfego no Plesk?

Não. No Plesk, quem define os limites é o Service Plan. Os campos Disk Quota e Bandwidth do produto são ignorados mesmo preenchidos, e uma nota vai para o log do módulo. Para mudar um limite, edite o plano no Plesk.

Onde eu olho quando uma ação falha?

Primeiro, na linha com o prefixo dnahosting: em Utilities > Logs > Activity Log. Se precisar de mais detalhes, ative por pouco tempo o Module Debug Mode e veja no Module Log a requisição enviada ao painel e a resposta.

Meu token de API está seguro?

O módulo nunca grava o token nem as senhas de clientes em texto simples nos registros e não guarda credenciais no cache. Para mais segurança, restrinja o token ao IP do seu servidor WHMCS na aba do painel de controle.

Perco as configurações dos produtos ao atualizar o módulo?

Não. O módulo guarda as configurações de produto por posição e só adiciona as novas no fim da lista. Basta substituir a pasta pela nova versão e rodar o Test Connection.

Próximos passos