Licenciamiento y activación de Pro

El plan Free es una forma admitida y permanente de usar Perfex CRM Integration for WHMCS. Sincroniza clientes y contactos en un solo sentido, de WHMCS a Perfex, en tiempo real. Para eso nunca necesitas una clave.

Una licencia Pro desbloquea todo lo demás. Esta página explica cómo comprarla, activarla, comprobarla y eliminarla.

Qué desbloquea Pro

Desbloqueado por Pro	Qué significa en el día a día
🔁 Sincronización bidireccional de clientes y contactos	Una dirección corregida en Perfex vuelve a WHMCS, según la política de conflictos que hayas elegido
📄 Duplicación de facturas	Las facturas de WHMCS aparecen en el cliente de Perfex con sus líneas de detalle, su fila de impuestos y su estado
💳 Sincronización de pagos y transacciones	Una factura pagada en WHMCS pone su duplicado de Perfex en Paid, registrando la pasarela y el ID de transacción
🛒 Sincronización de pedidos	Un pedido de WHMCS se convierte en una oportunidad de Perfex, en una nota del cliente o en nada, según prefieras
🎫 Sincronización de tickets de soporte	Los tickets, las respuestas y los cambios de estado circulan en ambas direcciones, con tareas de Perfex opcionales por ticket para las hojas de horas
🌐 Panel de servicios y dominios	Una pestaña WHMCS en el perfil de cada cliente de Perfex, con los servicios y dominios de ese cliente
⏬ Asistente de importación masiva	Importa tus clientes, facturas, servicios y dominios existentes, no solo la actividad nueva
🗂️ Desplegables de mapeo de departamentos	Asigna los departamentos de tickets de WHMCS a departamentos de Perfex eligiendo de una lista en lugar de escribir IDs

La comparación completa está en la tabla Free frente a Pro.

La licencia reside únicamente en el lado de WHMCS

El complemento de Perfex es gratuito y nunca contiene una clave. El addon de WHMCS decide el plan y se lo comunica a Perfex, para que la página de ajustes de Perfex pueda explicar por qué la sincronización bidireccional está funcionando o no. Tu clave de licencia en sí nunca viaja hasta Perfex.

Comprar Pro: la ventana de compra superpuesta

Esta es la vía rápida, y no requiere copiar ni pegar nada.

1. En cualquiera de las dos páginas de administración, haz clic en un enlace de mejora:
   • WHMCS: Addons > Perfex CRM Bridge. El enlace aparece como Buy a Pro licence junto al campo Pro License Key, y como Upgrade to Pro en la fila de licencia de la lista de verificación y en los recuadros promocionales de Pro.
   • Perfex: Setup > WHMCS Bridge, panel WHMCS plan, botón Upgrade to Pro.
2. Se abre una ventana superpuesta de pago seguro, encima de la página en la que ya estabas.
3. Completa la compra.
4. La activación se produce automáticamente:
   • Iniciada desde WHMCS: la clave de licencia devuelta por el proceso de compra se escribe en el campo Pro License Key del propio formulario de ajustes y ese formulario se envía por ti. El guardado verifica la clave en vivo, cambia el plan a Pro y se lo comunica al lado de Perfex, todo en la misma petición.
   • Iniciada desde Perfex: la clave se retransmite a tu instalación de WHMCS por el canal firmado del puente. WHMCS la verifica en vivo antes de almacenar nada, activa Pro y devuelve el nuevo estado del plan de inmediato, de modo que el panel de plan de Perfex pasa a Pro sin necesidad de recargar. Perfex nunca almacena la clave.
5. Pro se activa al instante. No hay que esperar a ninguna ejecución del cron ni escribir nada.

La ventana superpuesta es una mejora, no una dependencia

Si el script de la ventana superpuesta queda bloqueado por una extensión del navegador, una política de seguridad de contenido estricta o una red lenta, el enlace se comporta simplemente como siempre y abre la página de pago alojada en una pestaña nueva. No se rompe nada; solo tendrás que terminar con el pegado manual que se describe más abajo.

Si el navegador se cerró antes de completar la activación

Sigues teniendo tu clave. Dos redes de seguridad, en este orden:

1. En la página. Si la compra se completó pero la activación automática no pudo ejecutarse, la clave se muestra en la página en un campo seleccionable, con un botón de copia en el lado de Perfex, e instrucciones exactas sobre dónde pegarla. Una clave pagada nunca existe únicamente dentro de una ventana superpuesta cerrada.
2. En tu bandeja de entrada. La clave siempre se te envía por correo electrónico en el momento de la compra, y también está disponible en tu portal de cliente del proveedor de pago. Si el navegador se bloqueó en el peor momento, revisa tu correo.

Después sigue la vía manual que se describe a continuación.

Activar una clave manualmente

Usa esta vía siempre que ya tengas una clave: la del correo de compra, la de tu portal de cliente, o cuando traslades una licencia a otra instalación de WHMCS.

1. En WHMCS, abre Addons > Perfex CRM Bridge.
2. Baja hasta Settings > Pro licence.
3. Pega la clave en Pro License Key. Las claves empiezan por sk_.
4. Haz clic en Save Settings.

Esa es toda la activación. Guardar una clave que realmente ha cambiado ejecuta la comprobación en vivo en ese mismo momento, así que la página vuelve mostrando ya tu plan. No necesitas pulsar nada más ni esperar a ninguna ejecución del cron.

El banner te indica exactamente una de estas tres cosas:

Banner	Significado	Qué hacer
🟢 Verde - "Settings saved. Licence verified - your Pro plan is active..."	El servidor de licencias confirmó la clave. La cabecera de la página y la fila License / plan de la lista de verificación ya indican Pro, los recuadros promocionales de Pro han desaparecido y el asistente de importación masiva está desbloqueado.	Nada. Ya está.
🔴 Rojo - "Settings saved. The licence server rejected this key..."	La clave fue rechazada, y el mensaje indica el motivo del propio servidor: una clave desconocida, una suscripción caducada, una licencia cancelada o el cupo de activaciones ya agotado.	Comprueba que la clave esté pegada exactamente como aparece en tu correo de compra, sin caracteres de menos ni de más, y guarda de nuevo.
🟠 Ámbar - "Settings saved. Could not reach the licence server..."	Ni aprobación ni rechazo: tu servidor no ha podido contactar con el servicio de licencias en este momento.	La clave sí se ha guardado y los reintentos continúan automáticamente. Comprueba que tu servidor pueda acceder a api.freemius.com por HTTPS y después haz clic en Check licence now. Mientras tanto, el periodo de gracia te protege.

"Settings saved." siempre es cierto, sea cual sea el color

Los ajustes se escriben en la base de datos antes de ejecutar cualquier comprobación de licencia, así que un banner rojo nunca significa "el guardado ha fallado". Significa "guardado, y tu clave fue rechazada". Nunca tendrás que volver a rellenar el formulario.

Guardar ajustes no relacionados no cuesta nada

Solo una clave de licencia que haya cambiado realmente desencadena una comprobación. Pausar la sincronización, cambiar el destino de los pedidos o editar el administrador de respuestas de tickets no genera ninguna llamada de red, y el banner se queda en un simple "Settings saved.".

Check licence now

El botón Check licence now está en la parte superior de la página del módulo de WHMCS, junto a Test Connection y Run Sync Now.

Fuerza una comprobación inmediata de la clave ya almacenada, ignorando la limitación de una vez al día. Úsalo cuando:

• acabas de renovar o ampliar tu licencia y quieres recuperar Pro de inmediato;
• un guardado devolvió ámbar y desde entonces has resuelto el problema de red o de cortafuegos;
• quieres confirmar el estado actual antes de abrir un ticket de soporte.

El botón tiene un breve periodo de espera de unos segundos para evitar dobles pulsaciones. Si lo pulsas dos veces seguidas, la segunda responde "checked a moment ago" sin enviar una segunda petición. Espera unos segundos y volverá a comprobar con normalidad.

Si no hay ninguna clave almacenada, el botón responde con un banner rojo indicando que la clave está vacía y que la instalación está en el plan Free. No sale ninguna petición de tu servidor.

Mantener la activación: comprobación diaria y periodo de gracia de 14 días

Una vez almacenada una clave, el cron de WHMCS la revalida una vez al día. No tienes que hacer nada.

Si no se puede contactar con el servicio de licencias, el módulo no te desactiva. Ese caso se interpreta como "no lo sabemos", nunca como "rechazado", y un periodo de gracia de 14 días mantiene Pro plenamente operativo mientras se reintenta.

Tres detalles que conviene conocer:

• El reloj de la gracia cuenta desde la última comprobación correcta, no desde el último intento. La cuenta atrás mostrada en la página son días reales restantes, y no se reinicia cada vez que falla un reintento.
• Un rechazo real termina la gracia de inmediato. Si el servidor de licencias afirma activamente que la licencia está caducada, cancelada o no es válida, eso es una respuesta, y la gracia no se aplica. Bloquear el endpoint de licencias en tu cortafuegos no puede mantener viva una licencia revocada.
• La gracia amplía, nunca arranca de cero. Una clave que jamás se ha confirmado no tiene ninguna gracia sobre la que apoyarse. Si pegas una clave completamente nueva mientras el servicio de licencias es inaccesible, la clave se almacena y se reintenta, pero Pro no se activa hasta que una comprobación tenga éxito.

Estados del plan que puedes ver en la cabecera de la página

Texto de la cabecera	Significado
Free plan - no licence key set.	No hay clave. Es el nivel Free, funcionando con normalidad.
Pro license set - awaiting first verification.	Hay una clave almacenada pero nunca se ha confirmado. Haz clic en Check licence now.
Pro active until YYYY-MM-DD (UTC)	Todo correcto.
Pro active - lifetime licence	Una licencia sin fecha de caducidad.
Pro (grace) - could not reach the licence server, retrying daily. Pro keeps working for N more day(s).	Interrupción temporal. Todavía no hay nada roto para ti.
Free plan - this licence has expired.	Renueva y después haz clic en Check licence now.
Free plan - this licence was cancelled.	La licencia fue cancelada o reembolsada. Contacta con soporte si se trata de un error.
Free plan - the licence key was rejected.	Clave incorrecta, o cupo de activaciones agotado. El mensaje reproduce la redacción del propio servidor.
Free plan - the licence server could not be reached and the grace period has run out.	Resuelve la conectividad con el endpoint de licencias y después haz clic en Check licence now.

La misma frase aparece en la fila License / plan de la lista de verificación, así que nunca tendrás que buscarla.

Plazas de activación

Una instalación de WHMCS consume una plaza de activación de tu licencia. El módulo genera un identificador estable una sola vez y lo reutiliza siempre, de modo que volver a comprobar, volver a guardar o trasladar tu sitio a otro dominio nunca consume una segunda plaza.

Si ves un rechazo que menciona que la licencia ya está en uso en el número máximo de instalaciones, puedes eliminar la clave de la instalación que ya no la necesite, lo que libera la plaza al instante, o contactar con soporte para revisar tu cupo.

Eliminar una clave y volver a Free

1. En WHMCS, abre Addons > Perfex CRM Bridge > Settings > Pro licence.
2. Marca Remove the stored key (revert to Free).
3. Haz clic en Save Settings.

Qué ocurre:

• La instalación vuelve a Free de inmediato, independientemente de lo que siga en caché. Las funciones Pro se detienen.
• Se libera la plaza de activación, de modo que la licencia puede activarse en otra instalación.
• Se informa al lado de Perfex del cambio a un plan inferior, para que su panel WHMCS plan no siga anunciando Pro durante el resto del día.

Elimina la clave antes de migrar o dar de baja un sitio

Si eliminas una instalación de WHMCS sin quitar antes la clave, su plaza de activación seguirá ocupada. Eliminar la clave lleva cinco segundos y te ahorra una gestión con soporte más adelante.

Qué pasa con tus datos cuando termina Pro

No se elimina nada. En una instalación Free:

• La sincronización de clientes y contactos sigue funcionando, en un solo sentido, exactamente como siempre.
• WHMCS deja de encolar eventos de facturas, pagos, pedidos, servicios, dominios y tickets. La barrera está en el origen, así que no se acumula nada ni se reintenta inútilmente.
• Los cambios del lado de Perfex que ya estaban encolados para WHMCS se rechazan con un mensaje claro, "Two-way sync requires Pro on the WHMCS side", en el panel Outbound queue, se reintentan y acaban en estado dead-letter.
• Todo lo ya sincronizado permanece en Perfex. La pestaña WHMCS de los perfiles de cliente sigue mostrando las últimas instantáneas almacenadas; simplemente deja de actualizarse.

Reactiva una clave válida y todo se reanuda con el siguiente evento.

Resolución de problemas de licencias

Síntoma	Causa	Solución
Guardar una clave no produce ningún efecto visible	Has pegado la misma clave que ya estaba almacenada. Solo una clave modificada desencadena una comprobación.	Haz clic en Check licence now.
El banner sale ámbar siempre	Tu servidor no puede acceder al endpoint de licencias por HTTPS.	Permite el tráfico HTTPS saliente hacia api.freemius.com en cualquier cortafuegos o proxy de salida del servidor de WHMCS. Después haz clic en Check licence now.
"The licence key was rejected" con una clave aparentemente correcta	Un pegado truncado, o el cupo de activaciones agotado.	Vuelve a copiar la clave del correo de compra de una sola vez. Las claves tienen 32 caracteres y pueden contener signos de puntuación, así que no recortes nada. Si el mensaje menciona instalaciones, libera una plaza.
Perfex sigue mostrando Free después de que WHMCS muestre Pro	El estado del plan aún no había llegado a Perfex.	Haz clic en Check licence now o en Test Connection en WHMCS; ambos entregan el estado del plan a Perfex al momento. Recarga la página de ajustes de Perfex.
El panel de plan de Perfex indica Unknown	El lado de WHMCS nunca ha informado, o lleva mucho tiempo sin hacerlo.	Haz clic en Test Connection en WHMCS y después recarga la página de Perfex. Si sigue en Unknown, puede que el cron de WHMCS se haya detenido o que los dos lados ya no estén emparejados.

Hay más información en Resolución de problemas.