Conectar WHMCS
Guía paso a paso para conectar tu instalación WHMCS a MRRlytics vía API.
Requisitos previos
Antes de conectar tu WHMCS, asegúrate de tener:
- Acceso de administrador a tu instalación WHMCS
- WHMCS versión 8.0 o superior
- Acceso API habilitado en WHMCS (Configuración > Ajustes Generales > Seguridad > Permitir Acceso API)
- Una cuenta de MRRlytics con una organización configurada
Paso 1: Crear credenciales API en WHMCS
En tu panel de administración de WHMCS:
1. Ve a Configuración > Gestión de Personal > Credenciales API
2. Haz clic en "Generar Nueva Credencial API"
3. Añade una descripción como "Integración MRRlytics"
4. Configura los permisos de acceso. MRRlytics necesita acceso de lectura a:
- Clientes
- Productos/Servicios
- Facturas
- Dominios
- Solicitudes de Cancelación
5. Copia el Identificador API y el Secreto API
Paso 2: Añadir la instancia en MRRlytics
En tu dashboard de MRRlytics:
1. Navega a Ajustes > Instancias
2. Haz clic en "Añadir Instancia"
3. Rellena el formulario:
- Nombre: Un nombre descriptivo para esta instalación WHMCS
- URL WHMCS: La URL completa de tu admin WHMCS (ej. https://billing.ejemplo.com)
- Identificador API: Pega desde WHMCS
- Secreto API: Pega desde WHMCS
4. Haz clic en "Guardar"
MRRlytics validará la conexión y confirmará que funciona.
Paso 3: Sincronización inicial
Después de añadir la instancia, inicia tu primera sincronización haciendo clic en "Sincronizar Ahora". La sincronización inicial importa:
- Todos los clientes activos y sus servicios
- Catálogo de productos y grupos de productos
- Historial de facturas
- Registros de dominios
- Solicitudes de cancelación
Esto puede tardar entre 2 y 10 minutos dependiendo del tamaño de tu base de datos.
Frecuencia de sincronización
MRRlytics sincroniza tus datos automáticamente:
- Sincronización incremental: Cada 15 minutos (recoge nuevos cambios)
- Sincronización completa: Una vez al día a medianoche UTC (recalcula todas las métricas)
También puedes ejecutar una sincronización manual en cualquier momento desde la página de Ajustes.
Seguridad
Tus credenciales API de WHMCS se cifran con AES-256 antes de almacenarse. Nunca son visibles en el dashboard después de guardarlas. Solo accedemos a tus datos WHMCS a través de la API oficial con los permisos que otorgaste. Toda la comunicación usa cifrado TLS 1.3.
Solución de problemas
Problemas comunes:
- "Conexión fallida": Verifica que tu URL WHMCS es correcta y accesible desde internet. Asegúrate de que el acceso API está habilitado en la configuración de WHMCS.
- "Error de autenticación": Comprueba tu Identificador API y Secreto. Son sensibles a mayúsculas y minúsculas.
- "Tiempo de espera agotado": Si tu WHMCS tarda en responder, la sincronización puede expirar. Inténtalo de nuevo o revisa el rendimiento de tu servidor WHMCS.
- "Sin datos después de sincronizar": Asegúrate de que tus credenciales API tienen los permisos correctos de lectura para clientes, productos y facturas.