Por qué conectar los dos sistemas

WHMCS por sí solo sabe emitir facturas, pero no sabe crear cuentas de hosting. Para eso necesita hablar con tu WHM. Cuando configuras esta conexión, cada vez que un cliente compre un plan y pague, WHMCS le dará la orden a WHM de crear la cuenta cPanel con el dominio, el paquete y la contraseña correctos, y enviará los datos al cliente por correo. Todo en menos de un minuto y sin tu intervención.

Paso 1: preparar WHM

Ingresa a tu WHM como usuario raíz del reseller. Lo primero es generar credenciales seguras que WHMCS usará para conectarse.

Generar un API token

Entra a la sección de administración de usuarios API de WHM y crea un token nuevo. Asígnale un nombre descriptivo como whmcs-produccion. WHM te mostrará una cadena larga una sola vez: cópiala a un lugar seguro porque no vuelve a aparecer. Este token reemplaza con ventaja al acceso por contraseña o por clave SSH, porque lo puedes revocar en cualquier momento sin tocar el resto del servidor.

Paso 2: agregar el servidor en WHMCS

En WHMCS ve a la configuración y busca la sección de gestión de servidores. Pulsa "Añadir nuevo servidor" y llena estos campos:

• Nombre: algo legible como Servidor Principal.
• Hostname: el nombre de host real de tu WHM, por ejemplo server1.tuproveedor.com.
• Dirección IP: la IP principal del servidor. La obtienes de la página de inicio de WHM.
• Nameservers: los dos o cuatro nameservers que quieres que tus clientes usen, por ejemplo ns1.tudominio.com y ns2.tudominio.com. Apúntalos previamente a la IP del servidor desde tu zona DNS.
• Tipo: selecciona cPanel en la lista desplegable de módulos.
• Nombre de usuario: tu usuario de reseller en WHM.
• Contraseña o hash: pega aquí el API token generado en el paso anterior y marca la casilla que indica que estás usando token en lugar de contraseña.
• Seguridad: activa SSL para que toda la comunicación vaya cifrada, y el puerto 2087.

Guarda y pulsa "Probar conexión". Si todo está bien, WHMCS responde con la versión de WHM detectada. Si falla, revisa que el token sea correcto, que la IP del servidor WHMCS esté en la lista blanca del firewall del WHM y que el hostname resuelva.

Paso 3: agrupar en un grupo de servidores

Aunque tengas un solo servidor, WHMCS exige que esté dentro de un "grupo de servidores". Crea un grupo llamado por ejemplo Grupo cPanel y añade tu servidor dentro. Cuando crees productos de hosting, les asignarás este grupo, no el servidor directamente. Esto te permite después escalar: si agregas un segundo servidor al grupo, WHMCS distribuye cuentas entre ambos automáticamente.

Paso 4: verificar los paquetes de WHM

WHMCS va a usar los "packages" que tengas definidos en WHM para limitar recursos (espacio, ancho de banda, bases de datos, correos). Si todavía no creaste ninguno, vuelve a WHM, entra a la sección de paquetes y crea al menos uno por cada plan que pienses vender. El nombre del paquete es clave: en un paso posterior, cada producto de WHMCS apuntará a un paquete con ese nombre exacto, así que usa nombres claros como bronce, plata y oro.

Qué sigue

Con el servidor conectado y los paquetes creados, ya puedes armar los productos de venta en WHMCS y vincular cada uno al paquete correspondiente. Esa es la parte donde la magia del aprovisionamiento automático realmente sucede.