Licences et activation Pro
L'offre Free est une manière pérenne et prise en charge d'utiliser Perfex CRM Integration for WHMCS. Elle synchronise les clients et les contacts dans un seul sens, de WHMCS vers Perfex, en temps réel. Aucune clé n'est nécessaire pour cela.
Une licence Pro débloque tout le reste. Cette page couvre son achat, son activation, sa vérification et sa suppression.
Ce que débloque Pro
| Débloqué par Pro | Ce que cela change au quotidien |
|---|---|
| 🔁 Synchronisation bidirectionnelle des clients et contacts | Une adresse corrigée dans Perfex remonte vers WHMCS, selon la politique de conflit que vous avez choisie |
| 📄 Réplication des factures | Les factures WHMCS apparaissent sur le client Perfex avec leurs lignes de détail, leur ligne de taxe et leur statut |
| 💳 Synchronisation des paiements et transactions | Une facture WHMCS payée bascule sa copie Perfex en Paid, avec la passerelle de paiement et l'identifiant de transaction enregistrés |
| 🛒 Synchronisation des commandes | Une commande WHMCS devient un prospect Perfex, ou une note sur le client, ou rien du tout, selon votre préférence |
| 🎫 Synchronisation des tickets d'assistance | Tickets, réponses et changements de statut circulent dans les deux sens, avec des tâches Perfex facultatives par ticket pour les feuilles de temps |
| 🌐 Panneau des services et domaines | Un onglet WHMCS sur chaque fiche client Perfex, listant les services et domaines de ce client |
| ⏬ Assistant de reprise | Importez vos clients, factures, services et domaines existants, et pas seulement la nouvelle activité |
| 🗂️ Listes déroulantes de correspondance des départements | Faites correspondre les départements de tickets WHMCS aux départements Perfex en choisissant dans une liste plutôt qu'en saisissant des ID |
Le comparatif complet côte à côte se trouve dans le tableau Free ou Pro.
Le compagnon Perfex est gratuit et ne détient jamais de clé. Le module complémentaire WHMCS détermine l'offre et l'annonce à Perfex, afin que la page de paramètres Perfex puisse expliquer pourquoi la synchronisation bidirectionnelle fonctionne ou non. Votre clé de licence elle-même ne transite jamais vers Perfex.
Acheter Pro : la surcouche de paiement
C'est la méthode rapide, et elle ne nécessite aucun copier-coller.
- Sur l'une ou l'autre des pages d'administration, cliquez sur un lien de mise à niveau :
- WHMCS : Addons > Perfex CRM Bridge. Le lien apparaît sous la forme Buy a Pro licence à côté du champ Pro License Key, et sous la forme Upgrade to Pro sur la ligne de licence de la checklist et dans les encarts de présentation Pro.
- Perfex : Setup > WHMCS Bridge, panneau WHMCS plan, bouton Upgrade to Pro.
- Une surcouche de paiement sécurisée s'ouvre sur place, par-dessus la page où vous vous trouviez déjà.
- Finalisez l'achat.
- L'activation se fait automatiquement :
- Démarrage depuis WHMCS : la clé de licence issue de la réponse de paiement est inscrite dans le champ Pro License Key du formulaire de paramètres, et ce formulaire est soumis pour vous. L'enregistrement vérifie la clé en ligne, bascule l'offre en Pro et en informe le côté Perfex, le tout dans la même requête.
- Démarrage depuis Perfex : la clé est relayée vers votre installation WHMCS via le canal signé de la passerelle. WHMCS la vérifie en ligne avant de stocker quoi que ce soit, active Pro et renvoie immédiatement le nouvel état de l'offre, de sorte que le panneau d'offre Perfex bascule sur Pro sur place, sans rechargement. Perfex ne stocke jamais la clé.
- Pro est actif immédiatement. Il n'y a pas d'attente d'une exécution du cron, et rien à saisir.
Si le script de la surcouche est bloqué par une extension de navigateur, une politique de sécurité de contenu stricte ou un réseau lent, le lien se comporte simplement comme avant et ouvre la page de paiement hébergée dans un nouvel onglet. Rien ne casse ; vous terminez simplement par le collage manuel décrit ci-dessous.
Si le navigateur s'est fermé avant la fin de l'activation
Vous disposez toujours de votre clé. Deux filets de sécurité, dans cet ordre :
- Sur la page. Si l'achat a abouti mais que l'activation automatique n'a pas pu s'exécuter, la clé est affichée sur la page dans un champ sélectionnable, avec un bouton Copy du côté Perfex, et des instructions précises sur l'endroit où la coller. Une clé payée n'existe jamais uniquement à l'intérieur d'une surcouche fermée.
- Dans votre boîte de réception. La clé vous est toujours envoyée par e-mail au moment de l'achat, et elle est également disponible dans votre espace client chez le prestataire de paiement. Si le navigateur s'est bloqué au mauvais moment, consultez vos e-mails.
Suivez ensuite la procédure manuelle ci-dessous.
Activer une clé manuellement
Utilisez cette méthode dès lors que vous disposez déjà d'une clé : depuis l'e-mail d'achat, depuis votre espace client, ou lorsque vous transférez une licence vers une autre installation WHMCS.
- Dans WHMCS, ouvrez Addons > Perfex CRM Bridge.
- Faites défiler jusqu'à Settings > Pro licence.
- Collez la clé dans Pro License Key. Les clés commencent par
sk_. - Cliquez sur Save Settings.
L'activation se résume à cela. L'enregistrement d'une clé réellement modifiée déclenche la vérification en ligne sur-le-champ : la page revient donc en affichant déjà votre offre. Vous n'avez rien d'autre à faire, et vous n'avez pas à attendre une exécution du cron.
La bannière vous indique exactement l'une de ces trois situations :
| Bannière | Signification | Que faire |
|---|---|---|
| 🟢 Verte - « Settings saved. Licence verified - your Pro plan is active... » | Le serveur de licences a confirmé la clé. L'en-tête de la page et la ligne License / plan de la checklist indiquent déjà Pro, les encarts de présentation Pro ont disparu et l'assistant de reprise est débloqué. | Rien. C'est terminé. |
| 🔴 Rouge - « Settings saved. The licence server rejected this key... » | La clé a été refusée, et le message précise le motif donné par le serveur : clé inconnue, abonnement expiré, licence annulée, ou quota d'activations déjà épuisé. | Vérifiez que la clé est collée exactement telle qu'elle apparaît dans votre e-mail d'achat, sans caractère manquant ni superflu, puis enregistrez à nouveau. |
| 🟠 Orange - « Settings saved. Could not reach the licence server... » | Ni approbation, ni rejet : votre serveur n'a pas pu joindre le service de licences pour le moment. | La clé est enregistrée et les nouvelles tentatives se poursuivent automatiquement. Vérifiez que votre serveur peut joindre api.freemius.com en HTTPS, puis cliquez sur Check licence now. La période de grâce vous protège entre-temps. |
Les paramètres sont écrits en base de données avant toute vérification de licence : une bannière rouge ne signifie donc jamais « votre enregistrement a échoué ». Elle signifie « enregistré, et votre clé a été refusée ». Vous n'avez jamais à ressaisir le formulaire.
Seule une clé de licence réellement modifiée déclenche une vérification. Mettre la synchronisation en pause, changer la cible des commandes ou modifier l'administrateur de réponse aux tickets ne génère aucun appel réseau, et la bannière reste un simple « Settings saved. »
Check licence now
Le bouton Check licence now se trouve en haut de la page du module WHMCS, à côté de Test Connection et de Run Sync Now.
Il force une nouvelle vérification immédiate de la clé déjà enregistrée, en ignorant la limitation à une vérification par jour. Utilisez-le lorsque :
- vous venez de renouveler ou de prolonger votre licence et souhaitez récupérer Pro immédiatement ;
- un enregistrement s'est soldé par une bannière orange et vous avez depuis corrigé le problème de réseau ou de pare-feu ;
- vous voulez confirmer l'état actuel avant d'ouvrir un ticket d'assistance.
Le bouton dispose d'un court délai anti-double-clic de quelques secondes. Appuyez deux fois de suite et la seconde pression répond « checked a moment ago » sans envoyer de seconde requête. Patientez quelques secondes et la vérification s'effectue normalement.
Si aucune clé n'est enregistrée, le bouton répond par une bannière rouge indiquant que la clé est vide et que l'installation est sur l'offre Free. Aucune requête ne quitte votre serveur.
Rester activé : revérification quotidienne et période de grâce de 14 jours
Une fois une clé enregistrée, le cron WHMCS la revalide une fois par jour. Vous n'avez rien à faire.
Si le service de licences ne peut pas être joint, le module ne vous désactive pas pour autant. Ce cas est interprété comme « nous ne savons pas », jamais comme « rejeté », et une période de grâce de 14 jours maintient Pro pleinement opérationnel pendant les nouvelles tentatives.
Trois détails méritent d'être connus :
- Le compteur de grâce démarre à la dernière vérification réussie, et non à la dernière tentative. Le décompte affiché sur la page correspond à de véritables jours restants, et ne se réinitialise pas à chaque échec de tentative.
- Un rejet réel met immédiatement fin à la grâce. Si le serveur de licences déclare activement que la licence est expirée, annulée ou invalide, c'est une réponse, et la grâce ne s'applique pas. Bloquer le point de terminaison de licence sur votre pare-feu ne permet pas de maintenir en vie une licence révoquée.
- La grâce prolonge, elle n'amorce jamais. Une clé qui n'a jamais été confirmée une seule fois ne dispose d'aucune grâce sur laquelle s'appuyer. Si vous collez une clé toute neuve alors que le service de licences est injoignable, la clé est enregistrée et de nouvelles tentatives ont lieu, mais Pro ne s'active pas tant qu'une vérification n'a pas réellement abouti.
Les états d'offre que vous pouvez voir dans l'en-tête de page
| Texte de l'en-tête | Signification |
|---|---|
Free plan - no licence key set. | Aucune clé. C'est l'offre Free, en fonctionnement normal. |
Pro license set - awaiting first verification. | Une clé est enregistrée mais n'a jamais été confirmée. Cliquez sur Check licence now. |
Pro active until YYYY-MM-DD (UTC) | Tout va bien. |
Pro active - lifetime licence | Une licence sans date d'expiration. |
Pro (grace) - could not reach the licence server, retrying daily. Pro keeps working for N more day(s). | Indisponibilité temporaire. Rien n'est encore cassé pour vous. |
Free plan - this licence has expired. | Renouvelez, puis cliquez sur Check licence now. |
Free plan - this licence was cancelled. | La licence a été annulée ou remboursée. Contactez l'assistance s'il s'agit d'une erreur. |
Free plan - the licence key was rejected. | Mauvaise clé, ou quota d'activations épuisé. Le message reprend la formulation du serveur. |
Free plan - the licence server could not be reached and the grace period has run out. | Rétablissez la connectivité vers le point de terminaison de licence, puis cliquez sur Check licence now. |
La même phrase apparaît sur la ligne License / plan de la setup checklist : vous n'avez donc jamais à la chercher.
Emplacements d'activation
Une installation WHMCS consomme un emplacement d'activation sur votre licence. Le module génère un identifiant stable une seule fois et le réutilise indéfiniment : revérifier, réenregistrer ou déplacer votre site vers un autre domaine ne consomme donc jamais un second emplacement.
Si vous obtenez un rejet indiquant que la licence est déjà utilisée sur le nombre maximum d'installations, supprimez la clé de l'installation qui n'en a plus besoin, ce qui libère l'emplacement immédiatement, ou contactez l'assistance au sujet de votre quota.
Supprimer une clé et revenir à Free
- Dans WHMCS, ouvrez Addons > Perfex CRM Bridge > Settings > Pro licence.
- Cochez Remove the stored key (revert to Free).
- Cliquez sur Save Settings.
Ce qui se produit :
- L'installation revient immédiatement à Free, quel que soit ce qui reste en cache. Les fonctionnalités Pro s'arrêtent.
- L'emplacement d'activation est libéré, la licence peut donc être activée sur une autre installation.
- Le côté Perfex est informé du déclassement, afin que son panneau WHMCS plan cesse d'annoncer Pro pour le reste de la journée.
Si vous supprimez une installation WHMCS sans avoir d'abord retiré la clé, son emplacement d'activation reste consommé. Retirer la clé prend cinq secondes et vous évite un aller-retour avec l'assistance plus tard.
Ce qu'il advient de vos données à la fin de Pro
Rien n'est supprimé. Sur une installation Free :
- La synchronisation des clients et des contacts continue de fonctionner, dans un seul sens, exactement comme auparavant.
- WHMCS cesse de mettre en file d'attente les événements de factures, paiements, commandes, services, domaines et tickets. Le filtrage s'opère à la source : rien ne s'accumule et rien n'est réessayé inutilement.
- Les modifications côté Perfex déjà en file d'attente pour WHMCS sont refusées avec un message explicite « Two-way sync requires Pro on the WHMCS side » dans le panneau Outbound queue, réessayées, puis finalement mises au rebut.
- Tout ce qui a déjà été synchronisé reste dans Perfex. L'onglet WHMCS des fiches clients continue d'afficher les derniers instantanés enregistrés ; il cesse simplement de se mettre à jour.
Réactivez une clé valide et tout reprend dès l'événement suivant.
Dépannage des licences
| Symptôme | Cause | Solution |
|---|---|---|
| L'enregistrement d'une clé ne produit aucun effet visible | Vous avez collé la même clé que celle déjà enregistrée. Seule une clé modifiée déclenche une vérification. | Cliquez sur Check licence now. |
| La bannière est orange à chaque fois | Votre serveur ne parvient pas à joindre le point de terminaison de licence en HTTPS. | Autorisez le trafic HTTPS sortant vers api.freemius.com à travers tout pare-feu ou proxy de sortie sur le serveur WHMCS. Cliquez ensuite sur Check licence now. |
| « The licence key was rejected » avec une clé qui semble correcte | Un collage tronqué, ou un quota d'activations épuisé. | Recopiez la clé depuis l'e-mail d'achat en une seule fois. Les clés comptent 32 caractères et peuvent contenir de la ponctuation : ne supprimez rien. Si le message mentionne des installations, libérez un emplacement. |
| Perfex affiche encore Free alors que WHMCS affiche Pro | L'état de l'offre n'était pas encore parvenu à Perfex. | Cliquez sur Check licence now ou sur Test Connection dans WHMCS ; les deux transmettent l'état de l'offre à Perfex sur-le-champ. Rechargez la page de paramètres Perfex. |
| Le panneau d'offre Perfex indique Unknown | Le côté WHMCS n'a jamais transmis d'information, ou n'en a pas transmis depuis longtemps. | Cliquez sur Test Connection dans WHMCS, puis rechargez la page Perfex. Si l'état reste Unknown, le cron WHMCS s'est peut-être arrêté, ou les deux côtés ne sont plus appairés. |
Plus de détails dans Dépannage.