← Voltar para a Central de Ajuda
Automação & Revenda (WHMCS)

Como conectar o WHMCS ao seu servidor WHM (Automação Mágica)

Atualizado recentemente • Engenharia Altiva Hub

Este é o passo decisivo para transformar a sua agência em uma operação automatizada estilo SaaS. Ao conectar o **WHMCS** ao seu **WHM Master**, o sistema passa a criar contas cPanel, definir senhas, suspender por inadimplência e alterar senhas sem qualquer intervenção manual.

Passo 1: Gerar o Token de API no WHM

Por questões de segurança, a autenticação entre o WHMCS e o WHM é feita através de um **API Token** seguro em vez de salvar a sua senha principal:

  1. Acesse o seu painel WHM Master da Altiva Hub.
  2. No menu de busca lateral, digite Manage API Tokens e clique na opção.
  3. Clique no botão + Generate Token.
  4. No campo Token Name, digite um identificador (Ex: WHMCS_Agencia).
  5. Role até o final da página e clique em Save.
  6. Uma chave longa de caracteres alfanuméricos será exibida. **Copie e guarde esta chave em um local seguro**, pois ela não será mostrada novamente pelo WHM!

Passo 2: Adicionar o Servidor no WHMCS

  1. Acesse o painel de administração do seu WHMCS (/admin).
  2. Acesse a engrenagem de configurações no canto superior direito e vá em System Settings > Servers.
  3. Clique no botão + Add New Server.
  4. Preencha os dados do servidor:
    • Name: Nome interno para o servidor (Ex: Servidor Principal Altiva).
    • Hostname: Informe o nome do servidor fornecido na sua Área do Cliente (Ex: us1.altiva.host ou o domínio do servidor).
    • IP Address: Insira o endereço IP do seu servidor da Altiva Hub.
  5. No bloco Server Details:
    • Type: Selecione cPanel no menu suspenso.
    • Username: Insira o nome de usuário master do seu WHM.
    • API Token: Cole o token completo gerado no Passo 1.
    • Marque a opção Secure (SSL) para garantir comunicação criptografada pela porta 2087.
  6. Clique no botão Test Connection para validar. Se tudo estiver correto, uma mensagem verde de sucesso será exibida!
  7. Clique em Save Changes.
Vincular Pacotes do WHM aos Produtos do WHMCS: Após cadastrar o servidor, vá em System Settings > Products/Services no WHMCS, crie os seus planos de hospedagem e na aba Module Settings escolha o módulo cPanel, o servidor cadastrado e digite o nome exato do pacote configurado no seu WHM (Ex: pacote_padrao).

Configurando a Ação de Automação Automática

Na aba Module Settings do produto no WHMCS, selecione a regra de aprovação desejada:

  • Automatically setup the product as soon as the first payment is received (Recomendado): O cPanel é criado e os dados são enviados ao cliente assim que a fatura/PIX é pago.
  • Automatically setup the product as soon as an order is placed: Cria a conta na hora que o pedido é feito, antes mesmo do pagamento.
  • Do not automatically setup this product: Exige que você clique manualmente em "Create" dentro do pedido no WHMCS.

Quer aceitar pagamentos via PIX automático?

Instale o módulo Efí Pay (Gerencianet) para emitir PIX dinâmico e dar baixa nas faturas em tempo real no seu WHMCS.

Ver Guia do Módulo Efí Pay (PIX)