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.