Configuración

Después de instalar y activar el módulo de Integración WHMCS, necesitas configurar la conexión a tu instancia de WHMCS y definir cómo fluyen los datos hacia Perfex CRM. Esta página cubre la configuración de API, preferencias de sincronización, mapeo de campos y programación automatizada.

Conectar a WHMCS

El módulo se comunica con WHMCS a través de su API oficial. Necesitarás credenciales de API válidas antes de continuar.

Generar Credenciales de API de WHMCS

1. Inicia sesión en tu Área de Administración de WHMCS.
2. Navega a Setup > Staff Management > Manage API Credentials.
3. Haz clic en Generate New API Credential.
4. Ingresa una descripción (por ejemplo, "Perfex CRM Integration").
5. Copia el API Identifier y el API Secret — los necesitarás en el siguiente paso.

aviso

Guarda tus credenciales de API de forma segura. El API Secret solo se muestra una vez durante la creación. Si lo pierdes, necesitarás generar nuevas credenciales.

Ingresar Credenciales en Perfex CRM

1. En Perfex CRM, navega a la configuración del módulo WHMCS Integration.
2. Ingresa los siguientes datos:
   • WHMCS URL — la URL completa de tu instalación de WHMCS (por ejemplo, https://billing.example.com)
   • API Identifier — el identificador generado en el paso anterior
   • API Secret — la clave secreta generada en el paso anterior
3. Haz clic en Test Connection para verificar que Perfex CRM pueda comunicarse exitosamente con tu instancia de WHMCS.
4. Haz clic en Save Settings una vez que la prueba de conexión sea exitosa.

tip

Si la prueba de conexión falla, asegúrate de que la dirección IP de tu servidor Perfex CRM esté en la lista blanca en WHMCS en Setup > General Settings > Security > API IP Access Restriction. También verifica que HTTPS esté configurado y que la URL de WHMCS sea correcta.

Ajustes de Sincronización

El panel de ajustes de sincronización te permite controlar qué datos se importan y cómo se manejan dentro de Perfex CRM.

Tipos de Datos

Tipo de Datos	Descripción
Clients	Sincroniza perfiles de clientes incluyendo nombre, correo electrónico, teléfono, dirección y datos de la empresa
Invoices	Sincroniza facturas con líneas de detalle, totales, impuestos, estado de pago y fechas de vencimiento
Contacts	Sincroniza contactos adicionales asociados a cada cuenta de cliente de WHMCS

Activa o desactiva cada tipo de datos según tus necesidades. Como mínimo, Clients debe estar habilitado ya que las facturas y contactos están vinculados a los registros de clientes.

Manejo de Duplicados

Cuando un registro sincronizado coincide con un cliente existente de Perfex CRM (por dirección de correo electrónico), puedes elegir cómo manejar el conflicto:

• Skip — no importar el registro si ya existe una coincidencia
• Update — sobrescribir el registro existente de Perfex CRM con datos de WHMCS
• Create New — crear un registro separado independientemente de los duplicados

info

La configuración recomendada es Update, que mantiene tus datos de Perfex CRM sincronizados con WHMCS mientras evita entradas de clientes duplicadas.

Mapeo de Campos

La sección de mapeo de campos te permite definir cómo los campos de WHMCS corresponden a los campos de Perfex CRM. El módulo viene con valores predeterminados sensatos, pero puedes personalizar los mapeos para:

• Campos estándar — nombre, correo electrónico, teléfono, dirección, empresa, ciudad, estado, código postal, país
• Campos personalizados — mapea campos personalizados de WHMCS a campos personalizados de Perfex CRM

Para editar los mapeos de campos:

1. Ve a WHMCS Integration > Settings > Field Mapping.
2. Para cada campo de WHMCS, selecciona el campo correspondiente de Perfex CRM en el menú desplegable.
3. Haz clic en Save Mapping.

Programación de Sincronización Automatizada

En lugar de ejecutar sincronizaciones manualmente, puedes configurar una programación automatizada usando un cron job del servidor.

Configurar el Cron Job

Agrega la siguiente entrada al crontab de tu servidor para ejecutar la sincronización en el intervalo deseado:

# Ejecutar sincronización de WHMCS cada 6 horas
0 */6 * * * php /path/to/perfex/index.php whmcs_integration sync >/dev/null 2>&1

Ajusta el tiempo del cron según la frecuencia con que cambian tus datos de WHMCS. Los intervalos comunes incluyen:

Intervalo	Expresión Cron	Caso de Uso
Cada hora	0 * * * *	Entornos de facturación de alto volumen
Cada 6 horas	0 */6 * * *	Uso estándar (recomendado)
Una vez al día	0 2 * * *	Entornos de bajo volumen

aviso

Ejecutar la sincronización con demasiada frecuencia en conjuntos de datos grandes puede aumentar la carga del servidor. Monitorea los recursos de tu servidor después de habilitar la sincronización automatizada y ajusta el intervalo según corresponda.

¿Qué Sigue?

• Guía de Uso — aprende a ejecutar sincronizaciones manuales, administrar clientes y facturas importados, y usar bots, plantillas y contactos masivos