Your AI Connector Docs

Facebook Lead-formulieren

Voer je Facebook-advertenties uit om leads te werven? Deze integratie stuurt die leads automatisch door naar Your AI Connector, zodat je ze kunt opvolgen via WhatsApp, sms of elk ander gekoppeld kanaal — zonder dat je er iets voor hoeft te doen.

Het werkt door Facebook Lead Ads te koppelen aan Your AI Connector via een automatiseringsplatform (zoals Pabbly, Zapier of Make). Deze platforms fungeren als een brug tussen Facebook en Your AI Connector en sturen leadinformatie van de een naar de ander via de API (een manier voor verschillende software om automatisch gegevens uit te wisselen).

Vereisten

Zorg voordat je begint dat je beschikt over:

  • Facebook Ads Manager-toegang met toestemming om Lead Ads te maken.
  • Een account met een actieve API-sleutel (genereer er een via Instellingen → Integraties → API-sleutel — zie API-toegang voor de exacte stappen).
  • Een account op een automatiseringsplatform — Pabbly Connect, Zapier of Make (Integromat). Deze handleiding gebruikt Pabbly als voorbeeld, maar de stappen zijn vergelijkbaar op elk platform.
  • Een contactenlijst in Your AI Connector waar nieuwe leads aan worden toegevoegd — zie Lijsten & contacten organiseren.

Overzicht

De integratie werkt in drie fasen:

  1. Een potentiële klant vult je Facebook Lead-formulier in.
  2. Je automatiseringsplatform detecteert de nieuwe lead en stuurt de informatie automatisch naar Your AI Connector (met behulp van twee API-aanroepen).
  3. Your AI Connector maakt het contact aan en voegt deze toe aan de lijst die je opgeeft.

Vanaf daar regelt een broadcast, een campagne of een AI-agent die je hebt toegewezen de rest — of dat nu een door AI aangedreven welkomstbericht, een drip-campagne of een handmatige opvolging is.

Stap 1: Je Facebook Lead-formulier maken

  1. Open Facebook Ads Manager.
  2. Maak een nieuwe campagne met de doelstelling Leads.
  3. Kies op advertentieniveau Instant Form als leadmethode.
  4. Bouw je formulier met de velden die je nodig hebt. Voeg minimaal het volgende toe:
    • Voornaam
    • Telefoonnummer (met landcode)
    • Optioneel: Achternaam, e-mailadres
  5. Publiceer de advertentie of sla het formulier op als concept om te testen.

Stap 2: Het Lead-formulier testen

Voordat je de automatisering koppelt, dien je een test-lead in:

  1. Ga in Ads Manager naar je Lead-formulier.
  2. Klik op Voorbeeld en vul het formulier in met testgegevens.
  3. Controleer of de test-lead verschijnt in je Facebook Lead Center (onder Publicatietools op je Facebook-pagina, of in Ads Manager onder “Leads”).

Deze testinvoer wordt gebruikt om de veldtoewijzing in je automatiseringsplatform in te stellen.

Stap 3: De automatisering instellen

Verbind Facebook Lead Ads als de trigger

  1. Log in op je automatiseringsplatform (Pabbly, Zapier of Make).
  2. Maak een nieuwe workflow / scenario / zap aan.
  3. Stel de trigger in op “Facebook Lead Ads - New Lead.”
  4. Verbind je Facebook-account en selecteer de pagina en het leadformulier.
  5. Haal de test-lead op om te bevestigen dat de verbinding werkt en om velden toe te wijzen.

Configureer API-aanroep 1: Contact aanmaken

Voeg een actiestap toe met een HTTP / Webhook / API-verzoek:

  • Methode: POST
  • URL: https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
  • Headers:
    Content-Type: application/json
  • Body (JSON):
    {
  "firstName": "{{first_name}}",
  "lastName": "{{last_name}}",
  "phone": "{{phone_number}}",
  "email": "{{email}}"
}

Vervang de {{placeholders}} door de daadwerkelijke veldtoewijzingen van je triggerstap.

Belangrijk: Het telefoonnummer moet de landcode bevatten (bijvoorbeeld +1 voor de VS of +31 voor Nederland). Als uw leadformulier het telefoonnummer verzamelt zonder landcode, voeg dan een opmaakstap toe in uw automatisering om deze ervoor te plaatsen.

Het API-antwoord geeft het ID van de nieuwe contactpersoon terug op data.contactId. Sla die waarde op — je hebt deze nodig voor de volgende stap.

Je kunt de tweede aanroep overslaan. POST /v1/contacts accepteert ook listId (één lijst) of listIds (meerdere) in de aanmaak-body, waarmee de nieuwe contactpersoon in hetzelfde verzoek aan die lijsten wordt toegevoegd. Gebruik de onderstaande versie in twee stappen alleen als je automatiseringsplatform vereist dat de contactpersoon al bestaat voordat wordt besloten welke lijst moet worden gebruikt.

Configureer API-aanroep 2: Contact toevoegen aan lijst

Voeg een tweede actiestap toe:

  • Methode: POST
  • URL: https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
  • Headers:
    Content-Type: application/json
  • Body (JSON):
    {
  "contactId": "{{contact_id_from_previous_step}}",
  "listId": "YOUR_LIST_ID"
}

Vervang YOUR_LIST_ID door het werkelijke ID van je contactenlijst (zie Je lijst-ID vinden hieronder), en koppel contactId aan het data.contactId dat door de eerste API-aanroep is geretourneerd.

Je lijst-ID vinden

  1. Klik in Your AI Connector op Contacten en vervolgens op het tabblad Lijsten.
  2. Open het rijmenu (“⋯”) naast de lijst die je wilt en klik op Lijst-ID kopiëren.

Zie Lijsten & contacten organiseren voor de volledige uitleg van de Lijsten-pagina.

Stap 4: Test de volledige workflow

  1. Dien nog een test-lead in via je Facebook-formulier (of speel de bestaande test-lead opnieuw af in je automatiseringsplatform).
  2. Controleer Your AI Connector om te bevestigen:
    • Het contact is aangemaakt met de juiste naam, het juiste telefoonnummer en e-mailadres.
    • Het contact is toegevoegd aan de juiste lijst.
  3. Als je een broadcast, campagne of AI-agent hebt ingesteld om die lijst automatisch een bericht te sturen, controleer dan of deze wordt geactiveerd zoals verwacht.

Gegevensreferentie

Hieronder staan voorbeelden van de gegevens die tijdens de integratie worden verzonden en ontvangen.

Contactpersoon aanmaken - Verzoek 

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"
}

Contactpersoon aanmaken - Antwoord 

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

Contactpersoon toevoegen aan lijst - Verzoek 

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

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

Tips

  • Afhandeling van duplicaten: als er al een contactpersoon met hetzelfde telefoonnummer bestaat, retourneert de aanmaak-aanroep {"success": false, "error_code": 409} en wordt de bestaande contactpersoon niet geretourneerd. Splits op error_code (de HTTP-status is 200) en zoek de contactpersoon op met GET /v1/contacts?phoneNumber=... vóór de aanroep voor toevoegen aan lijst.
  • Meerdere formulieren: maak afzonderlijke automatiseringsworkflows voor verschillende leadformulieren, die elk op een andere lijst en een andere uitzending, campagne of AI-agent zijn gericht.
  • Foutmeldingen: configureer je automatiseringsplatform om je op de hoogte te stellen als een API-aanroep mislukt, zodat je geen leads verliest.

Volgende stappen