Automatize a venda de hospedagem com o WiseCP: 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 WiseCP. Última atualização: 5 de outubro de 2026 Fontes: documentação oficial do módulo WiseCP DNA Reseller Hosting (GitHub) e documentação do WiseCP

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

1. Pegue o endereço do servidor, o usuário e o token de API no painel da Domain Name API.
2. Baixe o módulo no GitHub e copie a pasta DNAHosting para coremio/modules/Servers/ no WiseCP.
3. Adicione o servidor em Server Settings > Add new server e escolha DNAHosting como tipo de automação.
4. Confirme a conexão e o painel detectado com Test Connectivity.
5. Na aba Module Settings do seu pacote de hospedagem, escolha o servidor e o pacote na lista.
6. Faça um pedido de teste para confirmar que a conta abre no seu painel de revenda.

O que o módulo faz?

O DNAHosting é um módulo de servidor que permite gerenciar pelo WiseCP 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 de administrador; cada conta que ele abre conta na sua cota.

O que o módulo não faz

Gerenciamento de contas e redirecionamentos de e-mail, venda de contas de revenda, importação de contas existentes para o WiseCP e acesso ao painel root pela administração ficam fora do escopo. O módulo só guarda credenciais de revenda, então não existe um painel root para ele abrir.

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 WiseCP se conectar à sua conta de revenda, ele precisa do endereço do servidor, do seu usuário de revenda 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 ativo.
3. Abra a aba do painel de controle. Ali aparecem o endereço do painel, o usuário, a senha e o token de API.

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

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

O nome da pasta aparece do jeito que está na lista de tipos de automação, então não renomeie a pasta.

Passo 3: adicione o servidor compartilhado

Vá em Services > Hosting Management > Server Settings > Add new server, escolha DNAHosting como tipo de automação e informe os dados do Passo 1.

Passo 4: teste a conexão

Clique em Test Connectivity antes de salvar, ou salve direto; o WiseCP roda o teste sozinho e não adiciona o servidor sem sucesso no teste. Um resultado verde confirma as credenciais e o painel detectado. Se algo der errado, aparece um código HTTP específico ou um erro do painel.

Passo 5 (opcional): crie um grupo de servidores

Se você tem mais de um servidor de revenda, pode criar um grupo em Server Settings > Server Groups e ligar o pacote ao grupo em vez de a um único servidor. Se tem só um servidor, pule este passo.

Passo 6: ligue seu pacote de hospedagem ao módulo

Abra o pacote de hospedagem em Hosting Management e vá na aba Module Settings. Em Server Selection, escolha Single Server ou Server Group e marque seu servidor DNAHosting; o módulo então mostra os campos dele.

Não é preciso digitar o nome do pacote. Para um pacote exibido no cPanel como exampleuser_paket2, o módulo resolve o prefixo usuario_ sozinho. No Plesk, a lista traz todos os Service Plans definidos no servidor.

Passo 7: confirme com um pedido de teste

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

Ao terminar o teste, encerre o serviço de teste pelo WiseCP para que a conta também seja excluída do seu painel de revenda e não ocupe cota.

Usando o módulo no dia a dia

Depois da instalação, criação, suspensão e encerramento de contas ficam totalmente sob controle do WiseCP. Quando você faz essas ações no WiseCP, o módulo aplica cada uma no seu painel de revenda. Ações automáticas, como suspensão e encerramento, seguem as configurações de automação do WiseCP.

O que saber sobre Plesk e cPanel

Diferenças em relação ao módulo do WHMCS

Os módulos WHMCS e WiseCP da Domain Name API fazem o mesmo trabalho, mas os campos de instalação e alguns comportamentos são diferentes. Se você usa as duas plataformas, fique atento a estas diferenças.

Solução de problemas

Toda a troca entre o módulo e o painel pode ser vista nos registros de módulo do WiseCP (em Tools > Logs; “Modül İşlem Kayıtları” na interface em turco), mas só enquanto o registro estiver ligado.

O botão que liga o registro fica no topo da mesma página. Ligue antes de reproduzir o problema e desligue ao terminar. O token de API ou a senha do servidor, as senhas de contas que o módulo cria ou altera e os tokens de sessão do acesso com um clique são ocultados como *** antes de serem gravados.

Os demais erros HTTP vêm com um resumo em texto simples tirado do corpo da resposta do painel. Olhe esse resumo, não só o código de status.

Atualizando o módulo

Para passar para uma versão nova, substitua a pasta coremio/modules/Servers/DNAHosting/ pela pasta da nova versão e teste a conexão de novo nas configurações do servidor. As mudanças de cada versão ficam no arquivo CHANGELOG.md do repositório.

Perguntas frequentes

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

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

Onde eu baixo o módulo?

No repositório da Domain Name API no GitHub (domainreseller/reseller-hosting-wisecp). Para usar, você precisa de uma revenda de hospedagem Domain Name API ativa e do WiseCP instalado no seu próprio servidor.

O módulo funciona com cPanel e com Plesk?

Sim. Um único módulo atende os dois painéis; você não escolhe o tipo de painel, porque o módulo sonda o servidor e detecta. Só não misture servidores cPanel e Plesk no mesmo grupo; crie um grupo para cada painel.

Em qual campo vai o endereço do servidor?

No campo IP Address. O campo Hostname, no topo do formulário, é só um rótulo que define como o servidor aparece na lista; o módulo não o usa para se conectar.

Onde eu coloco o token de API?

No campo Password. No cPanel, coloque o token de API do WHM; no Plesk, a API key ou a senha do painel. Este módulo não usa o campo Access Hash, que nem aparece no formulário dos servidores DNAHosting.

Como eu informo o nome do pacote?

Não precisa digitar. Na aba Module Settings do pacote, a lista é puxada ao vivo do servidor; escolha na lista o pacote que você vai vender. O módulo resolve sozinho o prefixo usuario_ do cPanel.

O teste de conexão falha. O que eu faço?

Confira se o endereço está no IP Address, se a porta é 2087 para cPanel ou 8443 para Plesk e se o SSL está ligado. Depois garanta que a restrição de IP do token inclui o IP do seu servidor WiseCP.

Recebo um erro HTTP 403. O que eu faço?

Esse erro indica que a conta de revenda do token não tem permissão de nível WHM para a ação. Primeiro gere o token de novo no WHM com a sua própria conta de revenda. Se o problema continuar, fale com nosso suporte, porque as permissões de revenda são definidas na sua conta.

O módulo precisa de cron?

Não. O módulo não cria tabelas no banco de dados, não precisa de cron e não tem dependências do Composer. Instalar é só copiar a pasta DNAHosting.

O módulo gerencia contas de e-mail?

Não. Gerenciamento de contas e redirecionamentos de e-mail, venda de contas de revenda, importação de contas existentes para o WiseCP e acesso ao painel root ficam fora do escopo. Os clientes gerenciam o e-mail no próprio painel cPanel ou Plesk.

Por que o encerramento é recusado no Plesk?

No Plesk, o encerramento verifica a propriedade: o módulo só encerra as assinaturas que ele mesmo abriu. O encerramento também é recusado se o mesmo domínio ainda estiver ligado a outro serviço ativo ou suspenso no mesmo servidor.

Posso trocar o domínio de um serviço no Plesk?

Num serviço ativo, não. O Plesk encontra a assinatura pelo domínio, então a troca quebraria as ações seguintes; por isso é bloqueada. No cPanel o domínio pode ser editado, mas a conta continua atendendo o domínio antigo até você trocá-lo no painel.

Onde eu acompanho o que o módulo faz?

Nos registros de módulo do WiseCP, em Tools > Logs. Eles só são gravados enquanto o botão no topo da página está ligado. Tokens, senhas e tokens de sessão são ocultados antes de serem gravados.

Onde contam as contas que eu abro?

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

Próximos passos