Your AI Connector Docs

Facebook-leadformulär

Kör du Facebook-annonser för att samla in leads? Denna integration skickar automatiskt dessa leads till Your AI Connector så att du kan följa upp dem via WhatsApp, SMS eller någon annan ansluten kanal — utan att du behöver lyfta ett finger.

Det fungerar genom att ansluta Facebook Lead Ads till Your AI Connector via en automatiseringsplattform (som Pabbly, Zapier eller Make). Dessa plattformar fungerar som en brygga mellan Facebook och Your AI Connector och skickar lead-information från den ena till den andra med hjälp av API:et (ett sätt för olika programvaror att utbyta data automatiskt).

Förutsättningar

Innan du börjar, se till att du har:

  • Facebook Ads Manager-åtkomst med behörighet att skapa Lead Ads.
  • Ett konto med en aktiv API-nyckel (skapa en under Inställningar → Integrationer → API-nyckel — se API-åtkomst för exakta steg).
  • Ett konto på en automatiseringsplattform — Pabbly Connect, Zapier eller Make (Integromat). Den här guiden använder Pabbly som exempel, men stegen är liknande på alla plattformar.
  • En kontaktlista i Your AI Connector där nya leads kommer att läggas till — se Organisera listor och kontakter.

Översikt

Integrationen fungerar i tre steg:

  1. En potentiell kund fyller i ditt Facebook Lead-formulär.
  2. Din automatiseringsplattform upptäcker det nya leadet och skickar informationen till Your AI Connector automatiskt (med hjälp av två API-anrop).
  3. Your AI Connector skapar kontakten och lägger till den i den lista du anger.

Därifrån sköter ett utskick, en kampanj eller en AI-agent som du har tilldelat resten — oavsett om det är ett AI-drivet välkomstmeddelande, en dropp-sekvens eller en manuell uppföljning.

Steg 1: Skapa ditt Facebook-leadformulär

  1. Öppna Facebook Ads Manager.
  2. Skapa en ny kampanj med målet Leads.
  3. På annonsnivå, välj Instant Form som metod för leads.
  4. Bygg ditt formulär med de fält du behöver. Inkludera som minst:
    • Förnamn
    • Telefonnummer (med landskod)
    • Valfritt: Efternamn, e-post
  5. Publicera annonsen eller spara formuläret som ett utkast för testning.

Steg 2: Testa leadformuläret

Innan du ansluter automatiseringen, skicka in ett test-lead:

  1. I Ads Manager, gå till ditt leadformulär.
  2. Klicka på Förhandsgranska och fyll i formuläret med testdata.
  3. Bekräfta att test-leadet visas i ditt Facebook Lead Center (under Publiceringsverktyg på din Facebook-sida, eller i Ads Manager under “Leads”).

Denna testpost kommer att användas för att ställa in fältmappningen i din automatiseringsplattform.

Steg 3: Ställ in automatiseringen

Anslut Facebook Lead Ads som utlösare

  1. Logga in på din automatiseringsplattform (Pabbly, Zapier eller Make).
  2. Skapa ett nytt arbetsflöde / scenario / zap.
  3. Ställ in utlösaren (trigger) till “Facebook Lead Ads - New Lead.”
  4. Anslut ditt Facebook-konto och välj sida och formulär för leads.
  5. Hämta test-leaden för att bekräfta att anslutningen fungerar och för att mappa fält.

Konfigurera API-anrop 1: Skapa kontakt

Lägg till ett åtgärdssteg med en HTTP / Webhook / API-förfrågan:

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

Ersätt {{placeholders}} med de faktiska fältmappningarna från ditt utlösarsteg.

Viktigt: Telefonnumret måste innehålla landsnummer (till exempel +1 för USA eller +31 för Nederländerna). Om ditt formulär för leads samlar in telefonnummer utan landsnummer, lägg till ett formateringssteg i din automatisering för att lägga till det i början.

API-svaret returnerar den nya kontaktens ID vid data.contactId. Spara det värdet — du behöver det för nästa steg.

Du kan hoppa över det andra anropet. POST /v1/contacts accepterar även listId (en lista) eller listIds (flera) i skapandekroppen, vilket lägger till den nya kontakten i dessa listor i samma begäran. Använd tvåstegsversionen nedan endast om din automatiseringsplattform kräver att kontakten existerar innan den beslutar vilken lista som ska användas.

Konfigurera API-anrop 2: Lägg till kontakt i lista

Lägg till ett andra åtgärdssteg:

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

Ersätt YOUR_LIST_ID med det faktiska ID:t för din kontaktlista (se Hitta ditt list-ID nedan), och mappa contactId till det data.contactId som returnerades av det första API-anropet.

Hitta ditt list-ID

  1. I Your AI Connector, klicka på Kontakter och sedan på fliken Listor.
  2. Öppna radmenyn (“⋯”) bredvid den lista du vill använda och klicka på Kopiera list-ID.

Se Organisera listor och kontakter för en fullständig genomgång av Listor-sidan.

Steg 4: Testa hela arbetsflödet

  1. Skicka in ett nytt test-lead via ditt Facebook-formulär (eller spela upp det befintliga test-leadet i din automatiseringsplattform).
  2. Kontrollera Your AI Connector för att bekräfta:
    • Kontakten skapades med rätt namn, telefonnummer och e-postadress.
    • Kontakten lades till i rätt lista.
  3. Om du har en sändning, kampanj eller AI-agent inställd på att automatiskt skicka meddelanden till den listan, bekräfta att den utlöses som förväntat.

Datareferens

Nedan följer exempel på data som skickas och tas emot under integrationen.

Skapa kontakt - Förfrågan 

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

Skapa kontakt - Svar 

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

Lägg till kontakt i lista - Förfrågan 

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

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

Tips

  • Hantering av dubbletter: om en kontakt med samma telefonnummer redan finns, returnerar skapandeanropet {"success": false, "error_code": 409} och returnerar inte den befintliga kontakten. Förgrena på error_code (HTTP-statusen är 200) och sök upp kontakten med GET /v1/contacts?phoneNumber=... före anropet för att lägga till i listan.
  • Flera formulär: skapa separata automatiseringsarbetsflöden för olika lead-formulär, där varje riktar sig till en annan lista och en annan sändning, kampanj eller AI-agent.
  • Felmeddelanden: konfigurera din automatiseringsplattform så att den meddelar dig om ett API-anrop misslyckas, så att du inte förlorar leads.

Nästa steg