Aller au contenu principal

Dépannage

Vous rencontrez des problèmes ? Pas d'inquiétude — la plupart des problèmes ont des solutions simples ! Trouvez votre problème ci-dessous et suivez la solution.

Échec de la vérification du webhook​

Erreur : "The callback URL or verify token couldn't be validated."

Causes possibles et corrections :​

#CauseCorrection
1L'URL n'est pas en HTTPSInstallez un certificat SSL sur votre serveur
2Faute de frappe dans l'URL de callbackCopiez-collez directement depuis les paramètres du module
3Faute de frappe dans le verify tokenCopiez-collez directement depuis les paramètres du module
4Le serveur bloque les requêtesVérifiez votre pare-feu / plugins de sécurité
5Problèmes de redirection .htaccessAssurez-vous que l'URL ne redirige pas (pas de problèmes de redirection www ↔ non-www)
6Sélectionné "User" au lieu de "Page"Changez le menu déroulant en "Page" dans les webhooks Facebook

Comment déboguer :​

  1. Ouvrez votre navigateur et visitez votre URL webhook directement : 
    https://yourcrm.com/facebookleadsintegration/webhook?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=test123
  2. Si tout fonctionne correctement, vous devriez voir test123 affiché sur la page
  3. Si vous voyez une page d'erreur, le problème est côté serveur
astuce

Ça ne fonctionne toujours pas ? Vérifiez les logs d'erreur de votre serveur dans /path/to/your/crm/application/logs/

Erreur "Invalid Scopes" lors de la connexion Facebook​

Erreur : "Invalid Scopes: pages_manage_metadata"

Correction :​

Cela signifie que le module demande une permission obsolète. Assurez-vous d'utiliser la dernière version du module (v2.0.0+), qui utilise les permissions correctes :

  • pages_show_list
  • pages_read_engagement
  • leads_retrieval
  • pages_manage_ads
  • ads_management

Mettez à jour votre module vers la dernière version pour corriger cela.

"Error Accessing App" / "App Not Active"​

Erreur : Lors de la tentative de connexion avec Facebook, vous voyez "Error Accessing App" ou "The app is not active."

Causes possibles et corrections :​

#CauseCorrection
1Mauvais App ID dans les paramètres du moduleVérifiez que l'App ID correspond à votre application Meta
2L'application a été supprimée ou désactivéeVérifiez votre application sur developers.facebook.com/apps
3Vous n'êtes pas admin/développeur de l'applicationAjoutez-vous dans App Roles → Roles
4Restrictions de l'applicationVérifiez App Settings → Basic → App Restrictions

Le prospect de test fonctionne mais les vrais prospects n'arrivent pas​

Le bouton "Send Test Lead" du module fonctionne, mais les vrais prospects de Facebook n'apparaissent pas.

Vérifiez ceci :​

#VérificationComment
1Votre Page est-elle abonnée ?Settings → Connected Pages → Doit afficher "Monitoring"
2Le webhook est-il vérifié ?Settings → Connection Status → Webhook doit être vert
3"leadgen" est-il abonné ?Meta App → Webhooks → Page → "leadgen" doit être coché
4L'annonce utilise-t-elle la bonne Page ?Ads Manager → Ad Set → Assurez-vous qu'elle utilise la Page abonnée
5L'annonce est-elle en cours ?Ads Manager → Le statut de la campagne doit être "Active"

Tester avec l'outil Facebook :​

Utilisez l'outil Lead Ads Testing Tool pour envoyer un prospect de test webhook réel. Si cela fonctionne mais pas les vraies annonces, le problème vient probablement de la configuration de votre campagne publicitaire.

Erreur 500 sur les pages du module​

Symptôme : Les pages du module affichent une page blanche ou "500 Internal Server Error"

Corrections :​

  1. Vérifiez les logs d'erreur PHP :

    /path/to/your/crm/application/logs/log-YYYY-MM-DD.php

  2. Causes courantes :

    • Version PHP trop ancienne (nécessite 7.4+)
    • Extensions PHP manquantes (cURL, JSON)
    • Permissions de fichiers incorrectes
    • Fichiers du module corrompus lors du téléversement

  3. Corriger les permissions des fichiers :

    find /path/to/modules/facebookleadsintegration -type f -exec chmod 644 {} \;
    find /path/to/modules/facebookleadsintegration -type d -exec chmod 755 {} \;

  4. Re-téléversez le module si les fichiers sont peut-être corrompus

Le bouton Copy ne fonctionne pas​

Symptôme : Cliquer sur le bouton "Copy" à côté de l'URL webhook ou du verify token ne fait rien.

Correction :​

  • Assurez-vous que votre CRM est accessible via HTTPS — l'API Clipboard nécessite un contexte sécurisé
  • Essayez de sélectionner manuellement le texte et d'appuyer sur Ctrl+C
  • Vérifiez la console du navigateur pour les erreurs JavaScript (F12 → onglet Console)

Les prospects restent bloqués en "Pending Retry"​

Symptôme : Sync History affiche des prospects avec le statut "Pending" qui ne sont pas traités.

Corrections :​

  1. Traiter manuellement : Allez dans Sync History → Cliquez sur "Process Retry Queue"
  2. Vérifier le cron : La file de réessai est traitée automatiquement via le cron job de Perfex CRM
    • Assurez-vous que votre cron job s'exécute : Setup → Settings → Cron Job
    • L'URL du cron doit être appelée toutes les 5 minutes
  3. Vérifier le message d'erreur dans Sync History pour comprendre pourquoi le prospect a échoué initialement

Jeton d'accès expiré​

Symptôme : Le test de connexion échoue avec "Token expired" ou les prospects cessent d'arriver.

Correction :​

Le module échange les jetons à courte durée contre des jetons à longue durée (valides ~60 jours). Pour actualiser :

  1. Allez dans Meta Leads → Settings
  2. Faites défiler jusqu'à Connected Pages
  3. Cliquez sur "Connect with Facebook" à nouveau
  4. Connectez-vous et accordez les permissions
  5. Le jeton est automatiquement actualisé
astuce

Définissez un rappel pour vous reconnecter tous les 50 jours afin de garder le jeton à jour !

Les champs ne se mappent pas correctement​

Symptôme : Les données prospect apparaissent dans les mauvais champs ou sont manquantes.

Étapes de débogage :​

  1. Allez dans Sync History → Cliquez sur une entrée de prospect pour voir les données brutes
  2. Vérifiez les noms de champs que Facebook envoie
  3. Allez dans Field Mapping → Assurez-vous que le nom du champ Facebook correspond
  4. N'oubliez pas : Les champs standard (email, full_name, phone_number) sont mappés automatiquement

Problèmes courants de noms de champs :​

Ce que vous attendezCe que Facebook envoieSolution
namefull_nameDéjà auto-mappé
phonephone_numberDéjà auto-mappé
companycompany_nameDéjà auto-mappé
budgetcustom_question_1Créez un mapping personnalisé

Le module n'apparaît pas après l'installation​

Corrections :​

  1. Vérifiez l'emplacement des fichiers : Le dossier du module doit être dans modules/facebookleadsintegration/
  2. Vérifiez le nom du fichier : Le fichier principal doit être facebookleadsintegration.php (tout en minuscules)
  3. Activez le module : Allez dans Setup → Modules → Cliquez sur Activate
  4. Vérifiez les permissions : Les fichiers doivent être lisibles par le serveur web (644 pour les fichiers, 755 pour les répertoires)

Problèmes spécifiques au serveur​

Utilisateurs Cloudflare​

Si vous utilisez Cloudflare, mettez les IP webhook de Facebook sur liste blanche :

  1. Allez dans Cloudflare → WAF (Web Application Firewall)
  2. Créez une règle pour Allow les requêtes provenant de Facebook
  3. Ou ajoutez-les à la liste blanche de votre pare-feu :
    • Les IP webhook de Facebook se trouvent sur : https://developers.facebook.com/docs/sharing/webmasters/getting-started/webhooks/

Utilisateurs Nginx​

Assurez-vous que votre configuration Nginx autorise les requêtes POST vers l'URL du webhook et ne bloque pas le User-Agent de Facebook.

Hébergement partagé​

La plupart des hébergements partagés fonctionnent bien. Si vous avez des problèmes :

  • Vérifiez que allow_url_fopen est activé en PHP
  • Vérifiez que l'extension cURL est installée
  • Vérifiez si votre hébergeur bloque les webhooks entrants (certains hébergeurs axés sécurité le font)

Vous avez encore besoin d'aide ?​

Si aucune des corrections ci-dessus ne résout votre problème :

  1. Vérifiez les logs d'erreur Perfex CRM
  2. Vérifiez l'historique de synchronisation du module pour les messages d'erreur
  3. Prenez une capture d'écran de tout message d'erreur
  4. Contactez-nous à [email protected] avec :
    • Votre version de Perfex CRM
    • La version de PHP
    • Le message d'erreur
    • Les étapes pour reproduire le problème

Consultez la FAQ pour plus de réponses FAQ