Perfex CRM Integration for WHMCS
Perfex CRM Integration for WHMCS conecta tu plataforma de facturación WHMCS con tu instalación de Perfex CRM y mantiene ambas alineadas de forma automática. Clientes, contactos, facturas, pagos, pedidos, servicios, dominios y tickets de soporte circulan entre los dos sistemas casi en tiempo real, de modo que tu CRM siempre refleja la realidad de la facturación y tu sistema de facturación siempre refleja lo que hicieron tus equipos de ventas y soporte en el CRM.
El plan Free te ofrece una sincronización unidireccional fiable de clientes y contactos desde WHMCS hacia Perfex CRM. Una licencia Pro desbloquea la sincronización bidireccional (las ediciones hechas en Perfex vuelven a WHMCS), además de facturas, pagos, pedidos, tickets de soporte, un panel de servicios y dominios dentro de Perfex, y un asistente de importación masiva para tus datos históricos existentes.
El problema que resuelve
WHMCS es tu sistema de facturación y aprovisionamiento. Perfex CRM es donde gestionas oportunidades, proyectos, tareas y relaciones con los clientes. Sin un puente entre ambos, el mismo cliente existe dos veces, en dos bases de datos, y las dos copias empiezan a divergir en cuestión de semanas. Alguien actualiza una dirección en WHMCS, otra persona registra un teléfono en Perfex, y ninguno de los dos sistemas resulta ya fiable.
Este producto elimina la copia manual. Cada cambio relevante genera un evento, el evento se pone en cola y la cola se entrega al otro sistema a través de un canal HTTPS firmado.
Dos módulos, ambos obligatorios
El producto se distribuye como dos componentes, y ambos deben instalarse. Ninguna de las dos mitades hace nada útil por separado.
| Componente | Se instala en | Qué hace | Licenciamiento |
|---|---|---|---|
⚙️ perfexbridge (addon de WHMCS) | WHMCS, en modules/addons/perfexbridge | El módulo de pago. Escucha los eventos de WHMCS, los encola, los firma y los envía a Perfex. Contiene todos los ajustes de sincronización y la clave de licencia Pro. En el administrador de WHMCS aparece como Perfex CRM Bridge. | Plan Free por defecto. Una clave de licencia Pro desbloquea las funciones Pro. |
🧩 whmcs_bridge (complemento para Perfex CRM) | Perfex CRM, en modules/whmcs_bridge | El complemento gratuito. Recibe los eventos firmados y escribe clientes, contactos, facturas, pagos, oportunidades y tickets en Perfex. Muestra la pestaña WHMCS en el perfil del cliente. En el administrador de Perfex aparece en Setup > WHMCS Bridge. | Siempre gratuito. Nunca requiere clave de licencia. |
Si instalas solo el addon de WHMCS, los eventos se acumulan en una cola sin destino. Si instalas solo el complemento de Perfex, nunca recibirá nada. El plan (Free o Pro) lo determina exclusivamente la clave de licencia del lado de WHMCS. El complemento de Perfex es idéntico en ambos casos.
Ambos componentes comparten el mismo número de versión, actualmente 1.3.4, y deben actualizarse siempre a la vez.
El producto es Perfex CRM Integration for WHMCS. Dentro de las dos aplicaciones, los módulos se identifican de forma más breve: el addon de WHMCS aparece como Perfex CRM Bridge en Addon Modules, y el complemento de Perfex aparece como WHMCS Bridge en Setup > Modules. Esos son los nombres que debes buscar durante la instalación.
Free frente a Pro
| Funcionalidad | Free | Pro |
|---|---|---|
| 👥 Sincronización unidireccional de clientes, de WHMCS a Perfex CRM | ✅ | ✅ |
| 👤 Sincronización unidireccional de contactos, de WHMCS a Perfex CRM | ✅ | ✅ |
| ⚡ Captura de eventos en tiempo real mediante hooks de WHMCS, entregados por el cron de WHMCS | ✅ | ✅ |
| 🔗 Emparejamiento con un solo pegado mediante el Connection code | ✅ | ✅ |
| ✅ Lista de verificación de configuración y Test Connection | ✅ | ✅ |
| 📝 Registros de actividad en ambos lados | ✅ | ✅ |
| 🔁 Sincronización bidireccional de clientes y contactos, las ediciones de Perfex vuelven a WHMCS * | ➖ | ✅ |
| 📄 Duplicación de facturas, las facturas de WHMCS se convierten en facturas de Perfex * | ➖ | ✅ |
| 💳 Sincronización de pagos y transacciones, las facturas duplicadas se liquidan en Perfex * | ➖ | ✅ |
| 🛒 Sincronización de pedidos, un pedido de WHMCS se convierte en una oportunidad de Perfex o en una nota de cliente * | ➖ | ✅ |
| 🎫 Sincronización de tickets de soporte, tickets, respuestas y estado en ambas direcciones * | ➖ | ✅ |
| 🌐 Panel de servicios y dominios en el perfil del cliente de Perfex * | ➖ | ✅ |
| ⏬ Asistente de importación masiva para los datos históricos existentes * | ➖ | ✅ |
| 🗂️ Desplegables de mapeo de departamentos de tickets en Perfex * | ➖ | ✅ |
| ⏱️ Tarea de Perfex por ticket para registrar tiempo con las hojas de horas nativas * | ➖ | ✅ |
* Requiere licencia Pro.
Todos los campos Pro son visibles y se pueden guardar en el plan Free. Simplemente no tienen efecto hasta que haya una licencia válida activa, y la página de administración lo indica junto a cada uno. Consulta Licenciamiento y activación de Pro para saber cómo comprarla y activarla.
Requisitos
| Requisito | Detalle |
|---|---|
| 🖥️ WHMCS | 8.x o 9.x. Probado desde la 8.1.3 en adelante. |
| 🐘 PHP | De 7.2 a 8.5. Una única compilación funciona en todas ellas. Ambos módulos incluyen sus propias capas de compatibilidad, así que no hay descargas distintas por versión de PHP. |
| 📇 Perfex CRM | 3.x, verificado con la 3.4.0. |
| 🔒 HTTPS en ambos lados | Obligatorio. El transporte fija HTTPS y verifica el certificado TLS. Una URL http:// sin cifrar hace fallar todos los envíos por diseño, y el campo de URL de WHMCS del lado de Perfex se niega a guardarse si no empieza por https://. |
| ⏰ Cron del sistema de WHMCS | Debe estar en funcionamiento. El puente entrega los eventos encolados y revalida la licencia en cada ejecución del cron. Sin cron no se entrega nada. |
| 🌐 Red, para la sincronización bidireccional de Pro | Tu instalación de WHMCS también debe ser accesible desde el servidor de Perfex por HTTPS. |
| 🔌 Extensiones de PHP | cURL, en ambos servidores. |
Esta es, con diferencia, la causa más habitual del "nunca envía nada". El transporte HTTP está restringido al protocolo https y valida el certificado en ambos extremos. Un certificado autofirmado solo es aceptable si realmente se valida en el servidor que hace la llamada. No existe ningún ajuste para desactivarlo, y es deliberado: el secreto compartido y los datos de tus clientes viajan por este canal.
Cómo funciona la sincronización, en un párrafo
No se envía nada de forma síncrona mientras un administrador espera. Se dispara un hook de WHMCS, el evento se escribe en una tabla outbox, y el cron del sistema de WHMCS vacía esa cola y envía cada evento a Perfex mediante POST sobre HTTPS. Cada petición se firma con HMAC-SHA256 usando un secreto compartido que ambos lados poseen, dentro de una ventana antirreplay de 300 segundos. Los fallos se reintentan con un retardo creciente y, tras 15 intentos, pasan a un estado dead-letter para que un operador los revise. La dirección Perfex a WHMCS de Pro utiliza el mismo canal firmado a la inversa, impulsada por el cron de Perfex. Varias capas de supresión de eco impiden que un mismo cambio rebote indefinidamente entre los sistemas. La explicación completa está en Cómo funciona y uso diario.
Antes de empezar
Reúne lo siguiente y toda la configuración te llevará unos diez minutos:
- Acceso de administrador a ambos sistemas, WHMCS y Perfex CRM.
- Acceso al Administrador de archivos de tu panel de hosting, o por FTP, para el servidor de WHMCS. WHMCS no dispone de instalador de módulos dentro del administrador.
- Ambas instalaciones accesibles por HTTPS con certificados válidos.
- Confirmación de que el cron del sistema de WHMCS está en funcionamiento. WHMCS informa de la última ejecución del cron en Utilities > System > System Health Status.
- El archivo
upload.zip(themesic.com/marketplace/whmcs-perfex.zip) que descargaste, descomprimido de forma que tengaswhmcs-addon/addon.zipyperfex-module/module.zip.
Qué viene ahora
- Instalación - instala primero el complemento de Perfex, después el addon de WHMCS, y supera el escollo de Access Control.
- Configuración - empareja los dos lados con un único Connection code y luego ajusta todas las opciones.
- Licenciamiento y activación de Pro - compra, activa, verifica y elimina una licencia Pro.
- Cómo funciona y uso diario - el motor de sincronización, qué se sincroniza y hacia dónde, dónde están los registros y el asistente de importación masiva.
- Resolución de problemas - todos los fallos habituales, con su causa y su solución.
WHMCS es una marca comercial de WHMCS Ltd. Perfex CRM es una marca comercial de MSTdev. Themesic Interactive es un desarrollador independiente y no está afiliado, respaldado ni patrocinado por ninguna de las dos.