# 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](api-access.md) 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](../get-started/list-and-contact-management.md). --- ## 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) :** ```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. ::: warning **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) :** ```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](#finding-your-list-id) 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](../get-started/list-and-contact-management.md) 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 ```json POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY { "firstName": "Jane", "lastName": "Smith", "phone": "+15551234567", "email": "jane@example.com" } ``` ### Créer un contact - Réponse ```json { "success": true, "data": { "message": "Successfully created new contact", "contactId": "abc123xyz", "listsAdded": [] } } ``` ### Ajouter un contact à une liste - Requête ```json POST https://api.youraiconnector.com/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 - [Passer des Campagnes aux Diffusions & Agents](../moving-from-campaigns.md) — configurez un système pour envoyer automatiquement des messages aux nouveaux prospects. - [Accès API](api-access.md) — documentation complète de l'API pour les intégrations avancées. - [Webhooks](webhooks.md) — soyez averti lorsque des contacts sont créés ou étiquetés.