Aller au contenu principal

Configurer les webhooks

Maintenant, nous allons indiquer à Facebook où envoyer les données de leads. C'est ce qu'on appelle un « webhook » - c'est comme donner à Facebook l'adresse postale de votre CRM.

Qu'est-ce qu'un webhook ?​

En termes simples :

Quelqu'un remplit votre formulaire de lead sur Facebook/Instagram
         ↓
Facebook dit : « Hé, j'ai un nouveau lead ! »
         ↓
Facebook envoie les données du lead à VOTRE URL de webhook
         ↓
Votre module le reçoit et crée le lead dans Perfex CRM

Un webhook est simplement une URL sur votre serveur à laquelle Facebook envoie des données. Le module crée cette URL automatiquement - vous devez juste en informer Facebook.

Obtenir les détails de votre webhook depuis Perfex​

Avant d'aller sur Facebook, récupérons les détails depuis votre module :

  1. Connectez-vous à Perfex CRM
  2. Allez dans Meta Leads → Settings dans la barre latérale
  3. D'abord, saisissez votre App ID et App Secret (de l'étape 1) et cliquez sur Save Settings
  4. Faites défiler jusqu'à la section Webhook Settings
  5. Vous verrez deux valeurs :
ChampExempleCe que c'est
Webhook Callback URLhttps://yourcrm.com/facebookleadsintegration/webhookOù Facebook envoie les données
Verify Tokena1b2c3d4e5f6g7h8i9j0Un code secret pour vérifier la connexion
  1. Cliquez sur le bouton Copy à côté de chaque valeur
attention

L'URL de callback DOIT commencer par https:// - Facebook exige SSL ! Si votre URL commence par http://, vous devez d'abord installer un certificat SSL.

Ajouter les webhooks à votre application Meta​

1. Ouvrir le tableau de bord de votre application Meta​

Allez sur votre application à :

https://developers.facebook.com/apps/

Cliquez sur votre application pour l'ouvrir.

2. Ajouter le produit Webhooks​

  1. Dans la barre latérale gauche, cherchez « Add Product » ou faites défiler le tableau de bord
  2. Trouvez « Webhooks » dans la liste des produits
  3. Cliquez sur « Set Up » ou « Configure »
astuce

Si vous voyez déjà « Webhooks » dans la barre latérale gauche, cliquez directement dessus - pas besoin de l'ajouter à nouveau.

3. Sélectionner « Page » comme type d'objet​

  1. Sur la page Webhooks, vous verrez un menu déroulant qui indique « User » par défaut
  2. Changez ce menu déroulant en « Page »
attention

C'est essentiel ! Vous DEVEZ sélectionner « Page » - pas « User », pas « Application », rien d'autre. Les données de leads passent par les abonnements Page.

4. S'abonner au webhook​

  1. Cliquez sur le bouton « Subscribe to this object » (ou « Edit Subscription » si déjà configuré)
  2. Une boîte de dialogue apparaîtra demandant deux valeurs :
ChampQuoi saisir
Callback URLCollez votre URL de webhook depuis le module (par ex., https://yourcrm.com/facebookleadsintegration/webhook)
Verify TokenCollez votre Verify Token depuis le module
  1. Cliquez sur « Verify and Save »

5. Ce qui se passe quand vous cliquez sur « Verify and Save »​

Facebook enverra immédiatement une demande de vérification à votre URL de webhook :

Facebook : « Hé, c'est vraiment votre serveur ? »
Votre module : « Oui ! Voici le verify token pour le prouver ! »
Facebook : « Parfait, vérifié ! »

Si ça fonctionne : Vous verrez un message de succès et la boîte de dialogue se ferme.

Si ça échoue : Consultez la section Dépannage pour les corrections courantes.

6. S'abonner aux événements « leadgen »​

Après la vérification, vous devez indiquer à Facebook quels événements envoyer :

  1. Vous verrez une liste de types d'événements sous les abonnements « Page »
  2. Trouvez « leadgen » dans la liste (vous devrez peut-être faire défiler)
  3. Cliquez sur le bouton « Subscribe » à côté de « leadgen »
astuce

« leadgen » est le SEUL événement dont vous avez besoin. Vous n'avez pas besoin de vous abonner à d'autres événements (comme « messages » ou « feed »). Juste « leadgen ».

Vérification réussie !​

Votre configuration de webhook devrait maintenant ressembler à ceci :

Webhooks
├── Object: Page
├── Callback URL: https://yourcrm.com/facebookleadsintegration/webhook ✅
├── Verify Token: ✅ Verified
└── Subscriptions:
    └── ✅ leadgen (subscribed)

De retour dans votre module Perfex CRM, l'indicateur de statut du webhook devrait maintenant afficher vert/Verified !

Comment tester le webhook​

Vous voulez vous assurer que le webhook fonctionne ?

  1. Allez dans votre Perfex CRM → Meta Leads → Settings
  2. Cliquez sur le bouton « Test Connection »
  3. Vous devriez voir toutes les coches vertes

Nous ferons des tests plus approfondis plus tard dans la section Tester les leads.

Erreurs courantes à éviter​

ErreurCorrection
Sélectionné « User » au lieu de « Page »Changez le menu déroulant en « Page »
Oublié de s'abonner à « leadgen »Trouvez « leadgen » dans la liste et abonnez-vous
Utilisation de HTTP au lieu de HTTPSInstallez un certificat SSL sur votre serveur
Faute de frappe dans l'URL de callbackCopiez-collez directement depuis les paramètres du module
« Callback URL couldn't be validated »Consultez le Dépannage

Webhook configuré ? Connectez vos pages