A integração entre WHMCS e cPanel/WHM representa um marco na automação para empresas de hospedagem na web. Esta combinação poderosa permite que provedores de hospedagem gerenciem clientes, faturamento e provisionamento de serviços de forma totalmente integrada, eliminando tarefas manuais e reduzindo significativamente a carga de trabalho administrativa.
Este guia completo irá orientá-lo através de todo o processo de integração, desde a configuração inicial do servidor até a criação de produtos automatizados e solução de problemas comuns, permitindo que você aproveite ao máximo estas plataformas para expandir seu negócio de hospedagem.
Pré-requisitos para a Integração
Antes de iniciar o processo de integração, certifique-se de que possui os seguintes elementos:
- Acesso administrativo ao WHMCS instalado e configurado
- Credenciais de acesso root ou de administrador ao WHM/cPanel
- Um servidor com cPanel/WHM instalado e configurado
- Pacotes de hospedagem previamente criados no WHM (para associar aos produtos no WHMCS)
- Informações de nameservers e endereços IP do seu servidor
Passo a Passo da Integração
1. Adicionar o Servidor no WHMCS
O primeiro passo crucial é registrar seu servidor cPanel/WHM no WHMCS:
- Acesse a área administrativa do WHMCS e navegue até Opções > Produtos/Serviços > Servidores.
- Clique no botão Adicionar Novo Servidor (“Add New Server”).
- Preencha as informações básicas do servidor:
- Nome: Um identificador de sua escolha para este servidor (ex: “Meu Servidor Principal”).
- Hostname: O nome do servidor onde as contas de hospedagem serão criadas (ex: servidor.seudominio.com).
- Endereço IP: A IP principal dedicada do servidor.
- Configure os Nameservers:
- Primary Nameserver: ns1.seudominio.com
- Primary Nameserver IP: IP correspondente
- Secondary Nameserver: ns2.seudominio.com
- Secondary Nameserver IP: IP correspondente
2. Configurar os Detalhes de Conexão
Esta é a etapa mais crítica para estabelecer comunicação segura entre WHMCS e WHM. Na seção Server Details, preencha:
- Tipo: Selecione cPanel.
- Nome de Usuário: Insira o nome de usuário de acesso ao WHM.
- Senha: A senha do WHM (alguns tutoriais recomendam deixar em branco se usar Access Hash).
- Access Hash ou API Token: A opção mais segura atualmente é usar um API Token.
Como obter o API Token no WHM:
- Acesse seu WHM
- No menu lateral, navegue até Desenvolvimento > Manage API Tokens
- Gere um novo token e copie-o integralmente
- Cole o token no campo correspondente no WHMCS
Para conexão segura, selecione a opção Secure e use a porta 2087.
3. Testar e Salvar a Conexão
Após preencher todas as informações, clique no botão Test Connection para verificar se a configuração foi bem-sucedida. Se o teste retornar “SUCCESSFUL”, prossiga clicando em Salvar Alterações. Em caso de falha, verifique se todas as credenciais foram inseridas corretamente.
4. Criar um Grupo de Servidores
Para organizar sua infraestrutura, crie um grupo de servidores:
- Ainda em Opções > Produtos/Serviços > Servidores, clique em Criar Novo Grupo.
- Atribua um nome identificador ao grupo.
- Em Fill Type, selecione a opção para criar contas no servidor com menos contas.
- Em Selected Servers, selecione o servidor que você acabou de adicionar e clique para adicioná-lo ao grupo.
- Salve as alterações.
Configurando Produtos e Serviços Automatizados
1. Criar um Produto de Hospedagem no WHMCS
- Acesse Opções > Produtos/Serviços > Produtos/Serviços.
- Clique em Criar um Novo Grupo se necessário, ou Criar um Novo Produto para adicionar um plano específico.
- Preencha as informações básicas do produto (nome, descrição, etc.) e configure os preços conforme necessário.
2. Configurar o Módulo para Automação
Na aba Configurações de Módulo do produto, defina:
- Nome do Módulo: Selecione cPanel.
- Grupo do Servidor: Selecione o grupo de servidores criado anteriormente.
- WHM Package Name: Insira exatamente o nome do pacote pré-criado no WHM. Para revendedores, o formato é
usuario_nomepaquete. - Habilite a opção Configurar o produto automaticamente assim que receber o primeiro pagamento para total automação.
Diferenças entre Contas de Hospedagem Compartilhada e Revenda
- Shared Hosting: Preencha campos como “Max Addon Domains” conforme seu plano. Não preencha os campos “Limit Reseller by Number” e “Limit Reseller by Usage”.
- Reseller Hosting: Além do nome do pacote WHM, preencha os campos específicos para revendedores (“Limit Reseller by Number” e “Limit Reseller by Usage”) de acordo com o plano oferecido.
Solução de Problemas Comuns
1. “You do not have permission to use Selected Package”
- Causa: Nome do pacote WHM incorreto.
- Solução: Verifique se o “WHM Package Name” no produto WHMCS está exatamente igual ao nome do pacote no WHM.
2. “Package Not Allowed or Exceeded Resource/Account Allocation”
- Causa: Possivelmente, você tem acesso de revendedor e está tentando criar uma conta sem um nome de pacote válido (não pré-criado no WHM).
- Solução: Certifique-se de que o pacote já existe no WHM e que o nome coincide exatamente com o configurado no WHMCS.
3. “Resellers are not permitted to create subdomains of the server’s main domain”
- Causa: Nenhum domínio foi selecionado durante o processo.
- Solução: Ative a opção “Require Domain” para o produto em Setup > Product/Services > Edit, obrigando o cliente a inserir um domínio ao fazer o pedido.
4. Falha na Teste de Conexão
- Causas possíveis: Credenciais incorretas, problemas de conectividade de rede, configurações de firewall.
- Soluções: Verifique usuário e senha, teste com API Token em vez de senha, verifique se a porta 2087 está liberada.
Melhores Práticas e Considerações de Segurança
- Use API Tokens: São mais seguros que senhas tradicionais e podem ser revogados facilmente se necessário.
- Conexões Seguras: Sempre utilize a opção “Secure” com a porta 2087 para criptografar a comunicação.
- Permissões Mínimas: Aplicar o princípio do menor privilégio às contas de integração.
- Backups Regulares: Mantenha backups tanto do WHMCS quanto das configurações do servidor.
- Atualizações: Mantenha WHMCS, cPanel/WHM e todos os plugins sempre atualizados.
Conclusão
A integração completa entre WHMCS e cPanel/WHM transforma a operação de um provedor de hospedagem, automatizando desde o pedido e pagamento até a criação da conta de hospedagem, permitindo que você se concentre no crescimento do negócio enquanto o sistema gerencia os processos operacionais.
Seguindo este guia detalhado, você estará bem equipado para configurar uma integração robusta e eficiente que servirá como base para uma operação de hospedagem escalável e profissional. Lembre-se de sempre testar minuciosamente cada configuração antes de implementar em produção e manter-se atualizado com as novas funcionalidades que ambas as plataformas oferecem regularmente.
Guia do Host 