betool betool

Documentation

Meta Lead Ads

Réception immédiate des leads Facebook / Instagram dans un pipeline betool.

Meta Lead Ads

Le canal Meta Lead Ads branche vos Pages Facebook à betool, pour traiter en temps réel les leads remplis depuis vos formulaires Lead Ads (Facebook, Instagram).

Pourquoi ce canal

Les leads Meta sont traditionnellement traités par lots, exportés en CSV, importés dans un CRM, puis qualifiés à la main. Conséquence : 30 minutes à plusieurs heures de délai entre la soumission du formulaire et le premier contact.

En branchant Meta Lead Ads directement à un pipeline betool, vous ramenez ce délai à quelques secondes — et le premier contact (email, WhatsApp, appel) peut être automatisé.

Deux modes de branchement

  • Mode géré (recommandé) — vous connectez votre Page Facebook via l'app Meta de betool, déjà configurée côté plateforme. betool conserve le token de la Page et l'abonne automatiquement aux leads (leadgen) : rien d'autre à configurer.
  • Mode app personnelle (avancé) — vous utilisez votre propre application Meta : vous renseignez dans le récepteur votre verify_token, votre app_secret (vérification de la signature X-Hub-Signature-256) et un page_access_token longue durée, puis vous déclarez l'URL de callback fournie par betool dans le Webhooks de votre app Meta (objet page, champ leadgen).

Mise en place (mode géré)

  1. Paramètres → Services → Facebook, onglet Comptes — cliquez sur Connecter une Page Facebook, autorisez l'app dans la fenêtre Facebook, puis choisissez la Page dont vous voulez recevoir les leads.
  2. Dans l'éditeur du modèle, configurez le nœud Start avec un récepteur Facebook Lead Ads et sélectionnez la Page connectée.
  3. Chaque lead soumis sur un formulaire de cette Page déclenche le pipeline.

Ce que le pipeline reçoit

Pour chaque lead soumis, betool récupère le lead complet via l'API Graph, puis crée un exchange avec :

  • lead.fields — champs standards normalisés : full_name, first_name, last_name, email, phone, company, job_title, city, country, state, zip_code
  • lead.custom — les autres questions du formulaire, avec leurs réponses
  • lead.metadata — leadgen_id, form_id, page_id, created_time (horodatage Meta)
  • lead.raw — la réponse brute de l'API Graph

Meta reçoit son accusé de réception immédiatement ; le pipeline est exécuté ensuite depuis une file durable (avec réessais), ce qui évite de dépasser le délai de réponse imposé par Meta.

Cas d'usage typique

[Start · Facebook Lead Ads]──▶[agent: qualifier]──▶[filter: lead chaud ?]
                                                 ├─▶[connecteur CRM: créer la fiche]
                                                 └─▶[envoi: relance immédiate]

L'agent qualifie le lead à partir de lead.fields et lead.custom ; des filtres déterministes routent ensuite les leads qualifiés vers le CRM et les leads chauds vers une relance email / WhatsApp immédiate.

Limites

  • Quota Meta — l'API Graph a un rate limit. Pour les volumes importants, prévoyez un buffer.
  • Permissions (mode app personnelle) — votre app doit disposer de la permission leads_retrieval, que Meta peut retirer si l'app n'est pas validée. Suivez la procédure d'App Review Meta.
  • Pas de retro-fetch — betool ne récupère pas les leads soumis avant la mise en place du webhook. Pour ça, exportez et chargez via un script ponctuel.