Perfex CRM Integration for WHMCS
Perfex CRM Integration for WHMCS relie votre plateforme de facturation WHMCS à votre installation Perfex CRM et maintient automatiquement les deux systèmes alignés. Clients, contacts, factures, paiements, commandes, services, domaines et tickets d'assistance circulent entre les deux systèmes en quasi temps réel : votre CRM reflète donc toujours la réalité de la facturation, et votre système de facturation reflète toujours le travail réalisé par vos équipes commerciales et support dans le CRM.
L'offre Free vous apporte une synchronisation unidirectionnelle fiable des clients et des contacts, de WHMCS vers Perfex CRM. Une licence Pro débloque la synchronisation bidirectionnelle (les modifications effectuées dans Perfex remontent vers WHMCS), ainsi que les factures, les paiements, les commandes, les tickets d'assistance, un panneau des services et domaines directement dans Perfex, et un assistant de reprise pour vos données historiques existantes.
Le problème qu'il résout
WHMCS est votre système de facturation et de provisionnement. Perfex CRM est l'outil dans lequel vous gérez vos prospects, vos projets, vos tâches et vos relations clients. Sans passerelle entre les deux, le même client existe en double, dans deux bases de données, et les deux copies divergent en quelques semaines. Une personne met à jour une adresse dans WHMCS, une autre saisit un numéro de téléphone dans Perfex, et plus aucun des deux systèmes n'est fiable.
Ce produit supprime la recopie manuelle. Chaque modification pertinente génère un événement, cet événement est mis en file d'attente, et la file est livrée à l'autre système via un canal HTTPS signé.
Deux modules, tous deux indispensables
Le produit est livré sous forme de deux composants, et les deux doivent être installés. Aucune des deux moitiés ne sert à quoi que ce soit isolément.
| Composant | Installé dans | Rôle | Licence |
|---|---|---|---|
⚙️ perfexbridge (module complémentaire WHMCS) | WHMCS, dans modules/addons/perfexbridge | Le module payant. Il écoute les événements WHMCS, les met en file d'attente, les signe et les transmet à Perfex. Il détient tous les paramètres de synchronisation ainsi que la clé de licence Pro. Dans l'administration WHMCS, il apparaît sous le nom Perfex CRM Bridge. | Offre Free par défaut. Une clé de licence Pro débloque les fonctionnalités Pro. |
🧩 whmcs_bridge (module compagnon Perfex CRM) | Perfex CRM, dans modules/whmcs_bridge | Le compagnon gratuit. Il reçoit les événements signés et écrit les clients, contacts, factures, paiements, prospects et tickets dans Perfex. Il affiche l'onglet WHMCS sur la fiche client. Dans l'administration Perfex, il apparaît sous Setup > WHMCS Bridge. | Toujours gratuit. Aucune clé de licence, jamais. |
Si vous n'installez que le module complémentaire WHMCS, les événements s'accumulent dans une file d'attente sans destination. Si vous n'installez que le compagnon Perfex, rien ne lui sera jamais envoyé. L'offre (Free ou Pro) est déterminée uniquement par la clé de licence présente du côté WHMCS. Le compagnon Perfex est identique dans les deux cas.
Les deux composants portent le même numéro de version, actuellement 1.3.4, et doivent toujours être mis à jour ensemble.
Le produit s'appelle Perfex CRM Integration for WHMCS. À l'intérieur des deux applications, les modules s'identifient de façon plus brève : le module complémentaire WHMCS est listé sous le nom Perfex CRM Bridge dans Addon Modules, et le compagnon Perfex sous le nom WHMCS Bridge dans Setup > Modules. Ce sont ces noms qu'il faut rechercher pendant l'installation.
Free ou Pro
| Fonctionnalité | Free | Pro |
|---|---|---|
| 👥 Synchronisation unidirectionnelle des clients, de WHMCS vers Perfex CRM | ✅ | ✅ |
| 👤 Synchronisation unidirectionnelle des contacts, de WHMCS vers Perfex CRM | ✅ | ✅ |
| ⚡ Capture des événements en temps réel via les hooks WHMCS, livrés par le cron WHMCS | ✅ | ✅ |
| 🔗 Appairage en un seul copier-coller grâce au Connection code | ✅ | ✅ |
| ✅ Setup checklist et Test Connection | ✅ | ✅ |
| 📝 Journaux d'activité des deux côtés | ✅ | ✅ |
| 🔁 Synchronisation bidirectionnelle des clients et contacts, les modifications Perfex remontent vers WHMCS * | ➖ | ✅ |
| 📄 Réplication des factures, les factures WHMCS deviennent des factures Perfex * | ➖ | ✅ |
| 💳 Synchronisation des paiements et transactions, les factures répliquées sont soldées dans Perfex * | ➖ | ✅ |
| 🛒 Synchronisation des commandes, une commande WHMCS devient un prospect Perfex ou une note client * | ➖ | ✅ |
| 🎫 Synchronisation des tickets d'assistance, tickets, réponses et statuts dans les deux sens * | ➖ | ✅ |
| 🌐 Panneau des services et domaines sur la fiche client Perfex * | ➖ | ✅ |
| ⏬ Assistant de reprise pour vos données historiques existantes * | ➖ | ✅ |
| 🗂️ Listes déroulantes de correspondance des départements de tickets dans Perfex * | ➖ | ✅ |
| ⏱️ Tâche Perfex par ticket pour le suivi du temps via les feuilles de temps natives * | ➖ | ✅ |
* Licence Pro requise.
Tous les champs Pro sont visibles et enregistrables avec l'offre Free. Ils n'ont simplement aucun effet tant qu'une licence valide n'est pas active, et la page d'administration le précise à côté de chacun d'eux. Consultez Licences et activation Pro pour savoir comment acheter et activer une licence.
Prérequis
| Prérequis | Détail |
|---|---|
| 🖥️ WHMCS | 8.x ou 9.x. Testé à partir de la version 8.1.3. |
| 🐘 PHP | De 7.2 à 8.5. Une seule build fonctionne sur toutes ces versions. Les deux modules embarquent leurs propres couches de compatibilité, il n'y a donc pas de téléchargement distinct par version de PHP. |
| 📇 Perfex CRM | 3.x, vérifié avec la version 3.4.0. |
| 🔒 HTTPS des deux côtés | Obligatoire. Le transport impose HTTPS et vérifie le certificat TLS. Une URL en http:// simple fait échouer chaque envoi, par conception, et le champ d'URL WHMCS côté Perfex refuse l'enregistrement s'il ne commence pas par https://. |
| ⏰ Cron système WHMCS | Il doit être actif. La passerelle livre les événements en file d'attente et revalide la licence à chaque exécution du cron. Sans cron, rien n'est livré. |
| 🌐 Réseau, pour la synchronisation bidirectionnelle Pro | Votre installation WHMCS doit également être joignable depuis le serveur Perfex en HTTPS. |
| 🔌 Extensions PHP | cURL, sur les deux serveurs. |
C'est de loin la cause la plus fréquente du « rien n'est jamais envoyé ». Le transport HTTP est restreint au protocole https et valide le certificat aux deux extrémités. Un certificat auto-signé n'est acceptable que s'il est réellement validé par le serveur appelant. Il n'existe aucun réglage pour désactiver ce contrôle, et c'est délibéré : le secret partagé et les données de vos clients transitent par ce canal.
Le fonctionnement de la synchronisation, en un paragraphe
Rien n'est envoyé pendant qu'un administrateur attend. Un hook WHMCS se déclenche, l'événement est écrit dans une table outbox, et le cron système WHMCS vide cette file d'attente en envoyant chaque événement à Perfex en HTTPS via une requête POST. Chaque requête est signée en HMAC-SHA256 à l'aide d'un secret partagé détenu par les deux parties, dans une fenêtre anti-rejeu de 300 secondes. Les échecs sont réessayés avec un délai croissant et, après 15 tentatives, basculent en état de rebut (dead) pour inspection par un opérateur. Le sens Perfex vers WHMCS de l'offre Pro emprunte le même canal signé en sens inverse, piloté par le cron Perfex. Une suppression d'écho à plusieurs niveaux empêche une même modification de rebondir indéfiniment entre les systèmes. L'explication complète se trouve dans Fonctionnement et utilisation au quotidien.
Avant de commencer
Réunissez ces éléments et l'installation complète prend environ dix minutes :
- Un accès administrateur aux deux systèmes, WHMCS et Perfex CRM.
- Un accès au gestionnaire de fichiers de votre panneau d'hébergement, ou en FTP, pour le serveur WHMCS. WHMCS ne propose pas d'installateur de modules intégré à l'administration.
- Les deux installations joignables en HTTPS avec des certificats valides.
- La confirmation que le cron système WHMCS est actif. WHMCS indique la dernière exécution du cron sous Utilities > System > System Health Status.
- Le fichier
upload.zip(themesic.com/marketplace/whmcs-perfex.zip) que vous avez téléchargé, décompressé de manière à disposer dewhmcs-addon/addon.zipet deperfex-module/module.zip.
Et ensuite ?
- Installation - installez d'abord le compagnon Perfex, puis le module complémentaire WHMCS, et franchissez le piège d'Access Control.
- Configuration - appairez les deux côtés avec un unique Connection code, puis réglez chaque option.
- Licences et activation Pro - acheter, activer, vérifier et supprimer une licence Pro.
- Fonctionnement et utilisation au quotidien - le moteur de synchronisation, ce qui est synchronisé et dans quel sens, où se trouvent les journaux, et l'assistant de reprise.
- Dépannage - chaque incident courant, avec sa cause et sa solution.
WHMCS est une marque déposée de WHMCS Ltd. Perfex CRM est une marque déposée de MSTdev. Themesic Interactive est un développeur indépendant, sans lien d'affiliation, d'approbation ou de parrainage avec l'une ou l'autre de ces sociétés.