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 votre app Facebook Business à 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é.

Prérequis

  • Une application Meta (Facebook for Developers) avec la permission leads_retrieval.
  • Une page Facebook approuvée pour Lead Ads.
  • Au moins un formulaire Lead Ad actif.

Mise en place

  1. Administration → Meta → Applications — connectez votre app Meta avec son App ID et son App Secret.
  2. Côté Meta Developers, ajoutez le webhook fourni par betool sur l'objet page avec le champ leadgen.
  3. Sélectionnez la / les pages concernées et autorisez l'app.
  4. Côté betool, mappez chaque formulaire vers un pipeline cible.

Ce que le pipeline reçoit

Pour chaque lead soumis, un exchange est créé avec :

  • lead.full_name, lead.email, lead.phone — champs standards (normalisés)
  • lead.form_fields — toutes les questions du formulaire avec leurs réponses
  • lead.form_id, lead.ad_id, lead.campaign_id — pour l'attribution
  • lead.created_time — horodatage Meta (UTC)

Cas d'usage typique

[facebook_leads]──▶[agent: enrichir]──▶[condition: qualité]
                                        ├─▶[operator: créer CRM]
                                        └─▶[agent: relance immédiate]

L'agent d'enrichissement appelle un tool de vérification email + un opérateur HTTP pour interroger votre base d'historique. La condition route les leads qualifiés vers le CRM, et les leads chauds vers une réponse WhatsApp / email immédiate.

Limites

  • Quota Meta — l'API a un rate limit. Pour les volumes importants, prévoyez un buffer.
  • Permissions — Meta peut retirer la permission leads_retrieval si votre 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.