Aller au contenu principal

Sources de Leads — Guide de Configuration

LeadHub peut recevoir des leads depuis 19 sources différentes. La plupart des sources fonctionnent via un webhook — vous collez une URL générée par LeadHub dans la plateforme externe, et les leads arrivent automatiquement.

Comment Fonctionne Chaque Source Basée sur Webhook​

  1. Allez dans Intégrations → Sources de Leads et créez une nouvelle connexion.
  2. Sélectionnez le type de source et configurez le mappage des champs.
  3. Copiez l'URL Webhook Entrant générée.
  4. Collez l'URL dans la plateforme externe (instructions par source ci-dessous).
  5. Testez en soumettant un lead de test — il apparaît dans votre espace de travail en quelques secondes.

Facebook Lead Ads (Meta)​

Les Facebook Lead Ads permettent aux utilisateurs de soumettre un formulaire dans Facebook/Instagram sans quitter l'application.

Meta a supprimé l'option CRM « Autre »

Meta ne propose plus l'option Autre sous Intégration CRM sur les formulaires de leads, il n'est donc plus possible de coller une URL webhook au niveau du formulaire. Connectez-vous plutôt via OAuth et un webhook au niveau de l'application, comme décrit ci-dessous.

Étape 1 — Configurez votre Application Meta​

Créez (ou ouvrez) une application de type Business sur developers.facebook.com :

  1. Ajoutez le produit Facebook Login.

  2. App Settings → Basic → App Domains : ajoutez votre domaine LeadHub (ex. : crm.example.com).

  3. Facebook Login → Settings → Valid OAuth Redirect URIs : ajoutez

    https://YOUR-DOMAIN/oauth/meta/callback

    Cette URL doit correspondre exactement à l'APP_URL de votre installation, y compris https.

astuce

L'ajout du domaine et de l'URI de redirection corrige également l'erreur "Can't load URL. The domain of this URL isn't included in the app's domains."

Étape 2 — Connectez-vous dans LeadHub​

  1. Allez dans Connexions de Sources de Leads et ajoutez une connexion Meta.
  2. Entrez votre App ID et votre App Secret.
  3. Cliquez sur Connecter via OAuth, approuvez les permissions demandées, puis sélectionnez votre Page.
  4. LeadHub enregistre automatiquement votre token d'accès de Page sur la connexion.

Étape 3 — Configurez le Webhook Leadgen (au Niveau de l'Application Meta)​

Cette étape remplace l'option « Autre » supprimée au niveau du formulaire :

  1. Dans le Tableau de bord de l'application → Webhooks, choisissez l'objet Page.
  2. Abonnez-vous au champ leadgen.
  3. URL de Callback et Token de Vérification : copiez les deux depuis l'écran de connexion Meta dans LeadHub.
  4. Abonnez votre Page.

Les nouveaux leads arrivent désormais automatiquement — Meta envoie chaque lead au webhook, et LeadHub récupère les détails complets du lead depuis la Graph API à l'aide de votre token d'accès de Page.

Permissions & App Review​

La connexion OAuth demande les scopes suivants : leads_retrieval, pages_show_list, pages_read_engagement, pages_manage_ads.

Ces permissions nécessitent la Meta App Review + Business Verification avant de fonctionner pour les comptes autres que les Admins, Développeurs ou Testeurs de l'application elle-même.

Pour tester avant l'approbation, vous pouvez soit :

  • Vous ajouter comme Admin / Développeur / Testeur sur l'application Meta, soit
  • Coller un Page Access Token (généré dans le Graph API Explorer de Meta avec leads_retrieval) dans le champ Page Access Token de la connexion — LeadHub lit les leads directement avec ce token.

Exemple de Mappage de Champs​

Champ FacebookChamp LeadHub
full_namefirst_name
emailemail
phone_numberphone

Vous pouvez également utiliser Zapier ou n8n comme pont si vous avez besoin de plus de contrôle sur la charge utile.

Leads Instagram​

Les Instagram Lead Ads partagent la même infrastructure Meta Ads que les Facebook Lead Ads. Suivez les mêmes étapes ci-dessus — les publicités Instagram et Facebook livrent toutes deux au même point de terminaison webhook.

Génération de Leads TikTok​

TikTok Lead Gen capture des leads directement dans les publicités TikTok.

Étapes de Configuration​

  1. Créez une connexion de Source de Lead : Type → TikTok Lead Generation.
  2. Copiez l'URL Webhook.
  3. Dans TikTok Ads Manager → Assets → Lead Generation → Webhook :
    • Cliquez sur Créer un Webhook.
    • Collez l'URL Webhook LeadHub.
    • Sélectionnez les champs à livrer.
  4. Soumettez un lead de test pour vérifier la livraison.

Remarques​

  • TikTok envoie un ping de vérification à l'URL — LeadHub répond automatiquement avec le bon token.
  • Les noms de champs dans TikTok peuvent être : name, email, phone_number.

LinkedIn Lead Gen Forms​

Les LinkedIn Lead Gen Forms capturent des leads depuis le Contenu Sponsorisé LinkedIn.

Étapes de Configuration​

  1. Créez une connexion de Source de Lead : Type → LinkedIn Lead Gen Forms.
  2. Copiez l'URL Webhook.
  3. Dans LinkedIn Campaign Manager → Account Assets → Lead Gen Forms → Integrations :
    • Choisissez votre formulaire Lead Gen.
    • Sous Integrations, sélectionnez Autres intégrations → Webhook.
    • Collez l'URL Webhook.
  4. Mappez les champs du formulaire (LinkedIn envoie firstName, lastName, emailAddress, phone).

WhatsApp Business​

Capturez les leads qui envoient des messages à votre compte WhatsApp Business.

Configuration via WhatsApp Business API (Cloud API)​

  1. Créez une connexion de Source de Lead : Type → WhatsApp Business.
  2. Copiez l'URL Webhook.
  3. Dans Meta Business → WhatsApp → Configuration → Webhooks :
    • Définissez l'URL de Callback sur l'URL Webhook LeadHub.
    • Définissez le Token de Vérification (affiché dans les paramètres de connexion LeadHub).
    • Abonnez-vous aux événements messages.
  4. Quand un utilisateur envoie un message à votre numéro WhatsApp, LeadHub crée un lead à partir de son nom et numéro de téléphone.

Configuration via Zapier (Plus Facile pour la Plupart des Utilisateurs)​

  1. Créez un Zap Zapier : Déclencheur → WhatsApp Business (ou utilisez un connecteur WhatsApp tiers).
  2. Action → Webhooks by Zapier → POST vers votre URL Webhook LeadHub.
  3. Mappez les champs de contact.

Telegram​

Capturez les leads qui envoient des messages à votre bot Telegram.

Étapes de Configuration​

  1. Créez un bot Telegram via @BotFather sur Telegram :
    • Envoyez /newbot à BotFather.
    • Choisissez un nom et un nom d'utilisateur.
    • Copiez le Token du Bot.
  2. Dans LeadHub, créez une connexion de Source de Lead : Type → Telegram.
  3. Entrez le Token du Bot dans la configuration de la connexion.
  4. LeadHub enregistre automatiquement un webhook sur l'API Telegram.
  5. Quand un utilisateur envoie /start ou n'importe quel message à votre bot, un lead est créé avec son nom et nom d'utilisateur Telegram.

Ce que LeadHub Capture depuis Telegram​

Champ TelegramChamp LeadHub
first_namePrénom
last_nameNom
usernamestocké dans Notes
message textstocké dans Notes

Viber​

Capturez les leads qui envoient des messages à votre compte Viber Business.

Étapes de Configuration​

  1. Créez un compte Viber Business sur partners.viber.com.
  2. Obtenez votre Token Bot Viber.
  3. Dans LeadHub, créez une connexion de Source de Lead : Type → Viber.
  4. Entrez le Token Bot — LeadHub configure automatiquement le webhook.
  5. Quand un utilisateur envoie un message à votre compte Viber, un lead est créé.

Twitter / X​

Capturez les leads depuis Twitter / X via DMs ou les cartes de génération de leads.

Configuration via Zapier (Recommandé)​

  1. Dans Zapier, créez un Zap : Déclencheur → Twitter → New Direct Message.
  2. Action → Webhooks by Zapier → POST vers votre URL Webhook LeadHub.
  3. Mappez sender_screen_name vers un champ personnalisé et text vers Notes.

L'accès à l'API Twitter nécessite un Compte Développeur. Pour la plupart des utilisateurs, Zapier est le chemin le plus simple.

Snapchat Lead Ads​

Les Snapchat Lead Ads fonctionnent de manière similaire aux Facebook Lead Ads.

Étapes de Configuration​

  1. Créez une connexion de Source de Lead : Type → Snapchat Lead Ads.
  2. Copiez l'URL Webhook.
  3. Dans Snapchat Ads Manager → Business → Snap Pixel & APIs → Lead Webhook :
    • Collez l'URL Webhook.
    • Sélectionnez les formulaires Lead Attachment à connecter.
  4. Snapchat envoie : full_name, email, phone_number.

Pinterest Lead Ads​

Étapes de Configuration​

  1. Créez une connexion de Source de Lead : Type → Pinterest Lead Ads.
  2. Copiez l'URL Webhook.
  3. Dans Pinterest Ads Manager → Lead Ads → Webhook (ou via Zapier) :
    • Collez l'URL Webhook ou configurez un pont Zapier.
  4. Pinterest envoie : email, first_name, last_name.

Les Google Ads Lead Form Extensions permettent aux chercheurs de soumettre leurs informations directement dans les résultats de recherche Google.

Étapes de Configuration​

  1. Créez une connexion de Source de Lead : Type → Google Ads Lead Forms.
  2. Copiez l'URL Webhook.
  3. Dans Google Ads → Lead Form Extension → Modifier → Intégration Webhook :
    • Collez l'URL Webhook.
    • Entrez la Clé Webhook (affichée dans la connexion LeadHub — laissez vide si non requis).
  4. Google Ads envoie : tableau user_column_data avec full_name, email, phone_number, postcode.

Mappage de Champs pour Google Ads​

Google Ads envoie un JSON structuré avec lead_id, user_column_data, column_id, string_value. Configurez le mappage de champs pour extraire string_value du tableau.

YouTube Lead Forms​

Les YouTube Lead Forms (partie de Google Ads) fonctionnent de manière identique aux Google Ads Lead Form Extensions. Suivez les mêmes étapes ci-dessus — les publicités YouTube utilisent la même infrastructure webhook Google Ads.

Microsoft Advertising (Bing Ads)​

Configuration via Zapier​

  1. Dans Zapier, créez un Zap : Déclencheur → Microsoft Advertising → New Lead.
  2. Action → Webhooks by Zapier → POST vers votre URL Webhook LeadHub.
  3. Mappez les champs : first_name, last_name, email, phone.

Typeform​

Étapes de Configuration​

  1. Créez une connexion de Source de Lead : Type → Typeform.
  2. Copiez l'URL Webhook.
  3. Dans Typeform → Votre Formulaire → Connect → Webhooks :
    • Cliquez sur Ajouter un webhook.
    • Collez l'URL Webhook LeadHub.
    • Activez le webhook.
  4. Typeform envoie la réponse complète du formulaire JSON à chaque soumission.

Mappage de Champs​

Typeform envoie les réponses sous forme de tableau. Utilisez la notation pointée pour mapper : answers.0.email → email, answers.1.text → first_name (selon l'ordre des champs et les types de votre formulaire).

JotForm​

Étapes de Configuration​

  1. Créez une connexion de Source de Lead : Type → JotForm.
  2. Copiez l'URL Webhook.
  3. Dans JotForm → Votre Formulaire → Paramètres → Intégrations → Webhooks :
    • Collez l'URL Webhook.
    • Cliquez sur Compléter l'Intégration.
  4. JotForm envoie les champs du formulaire avec leurs noms de champs configurés.

Mappage de Champs​

JotForm envoie des champs avec des clés comme q1_fullName, q2_email, q3_phoneNumber. Mappez-les vers les champs LeadHub. Utilisez le mappage de champs de connexion pour définir : q2_email → email, etc.

Calendly​

Capturez les leads qui réservent une réunion via Calendly.

Étapes de Configuration​

  1. Créez une connexion de Source de Lead : Type → Calendly.
  2. Copiez l'URL Webhook.
  3. Dans Calendly → Intégrations → Webhooks → Créer un Nouveau Webhook :
    • Collez l'URL Webhook.
    • Sélectionnez l'événement invitee.created.
    • Choisissez les Types d'Événements à surveiller.
  4. Quand quelqu'un réserve une réunion, Calendly envoie : first_name, last_name, email, questions_and_answers.

Formulaire Web LeadHub​

Quand quelqu'un soumet un formulaire que vous avez créé avec le Générateur de Formulaires LeadHub, un lead est créé automatiquement — aucune configuration de webhook nécessaire. Voir Générateur de Formulaires.

E-mail (IMAP)​

Capturez les leads depuis les e-mails entrants dans une boîte de réception surveillée.

Étapes de Configuration​

  1. Créez une adresse e-mail dédiée pour la capture de leads (ex. : [email protected]).
  2. Allez dans Intégrations → Sources de Leads et créez une nouvelle connexion : Type → E-mail (IMAP).
  3. Entrez :
    • Hôte IMAP — votre serveur de messagerie (ex. : mail.yourcompany.com)
    • Port IMAP — généralement 993 (SSL) ou 143
    • Nom d'utilisateur — l'adresse e-mail
    • Mot de passe — le mot de passe e-mail
    • Dossier — généralement INBOX
  4. LeadHub interroge la boîte de réception toutes les 5 minutes (via le cron job) et crée un lead depuis chaque nouvel e-mail.

Ce qui est Capturé depuis l'E-mail​

Champ E-mailChamp LeadHub
From: NamePrénom
From: AddressE-mail
Subjectstocké dans Notes
Bodystocké dans Notes

Saisie Manuelle​

Créez des leads directement dans LeadHub sans aucune intégration externe. Allez dans Leads → Tous les Leads → Nouveau Lead et renseignez les détails. Voir Gestion des Leads.

Webhook Générique (N'importe Quelle Plateforme)​

Pour toute plateforme non listée ci-dessus, utilisez le type de connexion Webhook Générique. Vous obtenez une URL qui accepte n'importe quelle charge utile JSON, et vous configurez le mappage de champs pour extraire les données du lead. Compatible avec tout outil capable de POST JSON — y compris les applications personnalisées, Typebot, Botpress, et plus encore.

curl -X POST https://yourdomain.com/inbound/YOURTOKEN \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","first_name":"Test","last_name":"Lead","phone":"+1555000000"}'