Configuration

Après avoir installé et activé le module d'intégration WHMCS, vous devez configurer la connexion à votre instance WHMCS et définir comment les données sont importées dans Perfex CRM. Cette page couvre la configuration de l'API, les préférences de synchronisation, le mappage des champs et la planification automatisée.

Connexion à WHMCS

Le module communique avec WHMCS via son API officielle. Vous aurez besoin d'identifiants API valides avant de poursuivre.

Génération des identifiants API WHMCS

1. Connectez-vous à votre Zone d'administration WHMCS.
2. Naviguez vers Configuration > Gestion du personnel > Gérer les identifiants API.
3. Cliquez sur Générer un nouvel identifiant API.
4. Saisissez une description (ex. : "Intégration Perfex CRM").
5. Copiez l'Identifiant API et le Secret API — vous en aurez besoin à l'étape suivante.

attention

Conservez vos identifiants API en lieu sûr. Le Secret API n'est affiché qu'une seule fois lors de la création. En cas de perte, vous devrez générer de nouveaux identifiants.

Saisie des identifiants dans Perfex CRM

1. Dans Perfex CRM, naviguez vers les paramètres du module Intégration WHMCS.
2. Saisissez les informations suivantes :
   • URL WHMCS — l'URL complète de votre installation WHMCS (ex. : https://billing.example.com)
   • Identifiant API — l'identifiant généré à l'étape précédente
   • Secret API — la clé secrète générée à l'étape précédente
3. Cliquez sur Tester la connexion pour vérifier que Perfex CRM peut communiquer avec succès avec votre instance WHMCS.
4. Cliquez sur Enregistrer les paramètres une fois le test de connexion réussi.

astuce

Si le test de connexion échoue, assurez-vous que l'adresse IP de votre serveur Perfex CRM est autorisée dans WHMCS sous Configuration > Paramètres généraux > Sécurité > Restriction d'accès IP de l'API. Vérifiez également que HTTPS est configuré et que l'URL WHMCS est correcte.

Paramètres de synchronisation

Le panneau des paramètres de synchronisation vous permet de contrôler quelles données sont importées et comment elles sont gérées dans Perfex CRM.

Types de données

Type de données	Description
Clients	Synchroniser les profils clients incluant nom, email, téléphone, adresse et détails de l'entreprise
Factures	Synchroniser les factures avec les lignes de détail, totaux, taxes, statut de paiement et dates d'échéance
Contacts	Synchroniser les contacts supplémentaires associés à chaque compte client WHMCS

Activez ou désactivez chaque type de données selon vos besoins. Au minimum, les Clients doivent être activés car les factures et les contacts sont liés aux enregistrements clients.

Gestion des doublons

Lorsqu'un enregistrement synchronisé correspond à un client Perfex CRM existant (correspondance par adresse email), vous pouvez choisir comment gérer le conflit :

• Ignorer — ne pas importer l'enregistrement si une correspondance existe déjà
• Mettre à jour — écraser l'enregistrement Perfex CRM existant avec les données WHMCS
• Créer un nouveau — créer un enregistrement séparé indépendamment des doublons

info

Le paramètre recommandé est Mettre à jour, qui maintient vos données Perfex CRM synchronisées avec WHMCS tout en évitant les entrées clients en double.

Mappage des champs

La section de mappage des champs vous permet de définir comment les champs WHMCS correspondent aux champs Perfex CRM. Le module est livré avec des valeurs par défaut sensées, mais vous pouvez personnaliser les mappages pour :

• Champs standard — nom, email, téléphone, adresse, entreprise, ville, état/province, code postal, pays
• Champs personnalisés — mapper les champs personnalisés WHMCS aux champs personnalisés Perfex CRM

Pour modifier les mappages de champs :

1. Allez dans Intégration WHMCS > Paramètres > Mappage des champs.
2. Pour chaque champ WHMCS, sélectionnez le champ Perfex CRM correspondant dans le menu déroulant.
3. Cliquez sur Enregistrer le mappage.

Planification de synchronisation automatisée

Plutôt que d'exécuter les synchronisations manuellement, vous pouvez configurer une planification automatisée à l'aide d'une tâche cron côté serveur.

Configuration de la tâche cron

Ajoutez l'entrée suivante au crontab de votre serveur pour exécuter la synchronisation à l'intervalle souhaité :

# Exécuter la synchronisation WHMCS toutes les 6 heures
0 */6 * * * php /path/to/perfex/index.php whmcs_integration sync >/dev/null 2>&1

Ajustez le timing du cron en fonction de la fréquence de modification de vos données WHMCS. Les intervalles courants incluent :

Intervalle	Expression cron	Cas d'utilisation
Toutes les heures	0 * * * *	Environnements de facturation à fort volume
Toutes les 6 heures	0 */6 * * *	Utilisation standard (recommandé)
Une fois par jour	0 2 * * *	Environnements à faible volume

attention

Exécuter la synchronisation trop fréquemment sur de grands ensembles de données peut augmenter la charge du serveur. Surveillez les ressources de votre serveur après avoir activé la synchronisation automatisée et ajustez l'intervalle en conséquence.

Et ensuite ?

• Guide d'utilisation — apprenez à exécuter des synchronisations manuelles, gérer les clients et factures importés, et utiliser les bots, templates et contacts en masse