Your AI Connector Docs

Formulaires de prospects Facebook

Vous diffusez des publicités Facebook pour capturer des prospects ? Cette intégration envoie automatiquement ces prospects vers Your AI Connector afin que vous puissiez les relancer via WhatsApp, SMS ou tout autre canal connecté — sans lever le petit doigt.

Cela fonctionne en connectant les Facebook Lead Ads à Your AI Connector via une plateforme d’automatisation (telle que Pabbly, Zapier ou Make). Ces plateformes servent de pont entre Facebook et Your AI Connector, en transmettant les informations des prospects de l’un à l’autre via l’API (un moyen pour différents logiciels d’échanger des données automatiquement).

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

  • Accès au Gestionnaire de publicités Facebook avec l’autorisation de créer des formulaires de prospects (Lead Ads).
  • Un compte avec une clé API active (générez-en une dans Paramètres → Intégrations → Clé API — consultez Accès API pour les étapes exactes).
  • Un compte sur une plateforme d’automatisation — Pabbly Connect, Zapier ou Make (Integromat). Ce guide utilise Pabbly comme exemple, mais les étapes sont similaires sur n’importe quelle plateforme.
  • Une liste de contacts dans Your AI Connector où les nouveaux prospects seront ajoutés — consultez Organiser les listes et les contacts.

Aperçu

L’intégration fonctionne en trois étapes :

  1. Un prospect remplit votre formulaire Facebook Lead.
  2. Votre plateforme d’automatisation détecte le nouveau prospect et envoie automatiquement les informations à Your AI Connector (en utilisant deux appels API).
  3. Your AI Connector crée le contact et l’ajoute à la liste que vous avez spécifiée.

À partir de là, une diffusion, une campagne ou un agent IA que vous avez assigné s’occupe du reste — qu’il s’agisse d’un message de bienvenue alimenté par l’IA, d’une séquence de messages ou d’un suivi manuel.

Étape 1 : Créez votre formulaire de prospects Facebook

  1. Ouvrez Facebook Ads Manager.
  2. Créez une nouvelle campagne avec l’objectif Prospects.
  3. Au niveau de la publicité, choisissez Formulaire instantané comme méthode de capture de prospects.
  4. Créez votre formulaire avec les champs dont vous avez besoin. Incluez au minimum :
    • Prénom
    • Numéro de téléphone (avec l’indicatif pays)
    • Optionnel : Nom de famille, e-mail
  5. Publiez la publicité ou enregistrez le formulaire en tant que brouillon pour effectuer des tests.

Étape 2 : Testez le formulaire de prospects

Avant de connecter l’automatisation, soumettez un prospect de test :

  1. Dans Ads Manager, accédez à votre formulaire de prospects.
  2. Cliquez sur Prévisualiser et remplissez le formulaire avec des données de test.
  3. Confirmez que le prospect de test apparaît dans votre Centre de prospects Facebook (sous Outils de publication sur votre page Facebook, ou dans Ads Manager sous “Prospects”).

Cette entrée de test sera utilisée pour configurer le mappage des champs dans votre plateforme d’automatisation.

Étape 3 : Configurez l’automatisation

Connecter Facebook Lead Ads comme déclencheur

  1. Connectez-vous à votre plateforme d’automatisation (Pabbly, Zapier ou Make).
  2. Créez un nouveau workflow / scénario / zap.
  3. Définissez le déclencheur sur “Facebook Lead Ads - New Lead”.
  4. Connectez votre compte Facebook et sélectionnez la Page et le formulaire de prospects.
  5. Récupérez le prospect de test pour confirmer que la connexion fonctionne et pour mapper les champs.

Configurer l’appel API 1 : Créer un contact

Ajoutez une étape d’action avec une requête HTTP / Webhook / API :

  • Méthode : POST
  • URL : https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
  • En-têtes :
    Content-Type: application/json
  • Corps (JSON) :
    {
  "firstName": "{{first_name}}",
  "lastName": "{{last_name}}",
  "phone": "{{phone_number}}",
  "email": "{{email}}"
}

Remplacez {{placeholders}} par les mappages de champs réels provenant de votre étape de déclenchement.

Important : Le numéro de téléphone doit inclure l’indicatif pays (par exemple, +1 pour les États-Unis ou +31 pour les Pays-Bas). Si votre formulaire de prospects recueille le numéro de téléphone sans indicatif pays, ajoutez une étape de formatage dans votre automatisation pour l’ajouter au début.

La réponse de l’API renvoie l’ID du nouveau contact à data.contactId. Enregistrez cette valeur — vous en aurez besoin pour l’étape suivante.

Vous pouvez ignorer le second appel. POST /v1/contacts accepte également listId (une liste) ou listIds (plusieurs) dans le corps de la création, ce qui ajoute le nouveau contact à ces listes dans la même requête. Utilisez la version en deux étapes ci-dessous uniquement si votre plateforme d’automatisation nécessite que le contact existe avant de décider quelle liste utiliser.

Configurer l’appel API 2 : Ajouter le contact à une liste

Ajoutez une deuxième étape d’action :

  • Méthode : POST
  • URL : https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
  • En-têtes :
    Content-Type: application/json
  • Corps (JSON) :
    {
  "contactId": "{{contact_id_from_previous_step}}",
  "listId": "YOUR_LIST_ID"
}

Remplacez YOUR_LIST_ID par l’ID réel de votre liste de contacts (voir Trouver l’ID de votre liste ci-dessous), et mappez contactId sur le data.contactId renvoyé par le premier appel API.

Trouver votre ID de liste

  1. Dans Your AI Connector, cliquez sur Contacts, puis sur l’onglet Listes.
  2. Ouvrez le menu de la ligne (“⋯”) à côté de la liste souhaitée et cliquez sur Copier l’ID de la liste.

Consultez Organisation des listes et contacts pour une présentation complète de la page Listes.

Étape 4 : Tester le flux de travail complet

  1. Soumettez un autre prospect de test via votre formulaire Facebook (ou rejouez le prospect de test existant dans votre plateforme d’automatisation).
  2. Vérifiez dans Your AI Connector que :
    • Le contact a bien été créé avec le nom, le numéro de téléphone et l’e-mail corrects.
    • Le contact a bien été ajouté à la bonne liste.
  3. Si vous avez une diffusion, une campagne ou un agent IA configuré pour envoyer des messages automatiquement à cette liste, confirmez que cela se déclenche comme prévu.

Référence des données

Vous trouverez ci-dessous des exemples de données envoyées et reçues lors de l’intégration.

Créer un contact - Requête 

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts?apiKey=YOUR_API_KEY

{
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "+15551234567",
  "email": "jane@example.com"
}

Créer un contact - Réponse 

{
  "success": true,
  "data": {
    "message": "Successfully created new contact",
    "contactId": "abc123xyz",
    "listsAdded": []
  }
}

Ajouter un contact à une liste - Requête 

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts/lists?apiKey=YOUR_API_KEY

{
  "contactId": "abc123xyz",
  "listId": "LIST_ID"
}

Conseils

  • Gestion des doublons : si un contact avec le même numéro de téléphone existe déjà, l’appel de création renvoie {"success": false, "error_code": 409} et ne renvoie pas le contact existant. Créez une branche sur error_code (le code d’état HTTP est 200) et recherchez le contact avec GET /v1/contacts?phoneNumber=... avant l’appel d’ajout à la liste.
  • Formulaires multiples : créez des flux d’automatisation distincts pour différents formulaires de prospects, chacun ciblant une liste différente et une diffusion, une campagne ou un agent IA différent.
  • Notifications d’erreur : configurez votre plateforme d’automatisation pour vous avertir en cas d’échec d’un appel API, afin de ne pas perdre de prospects.

Étapes suivantes