Your AI Connector Docs

Facebook-kundeemneformularer

Kører du Facebook-annoncer for at indsamle leads? Denne integration sender automatisk disse leads til Your AI Connector, så du kan følge op på dem via WhatsApp, SMS eller enhver anden forbundet kanal — uden at du behøver at løfte en finger.

Det fungerer ved at forbinde Facebook Lead Ads til Your AI Connector via en automatiseringsplatform (såsom Pabbly, Zapier eller Make). Disse platforme fungerer som en bro mellem Facebook og Your AI Connector, og sender lead-oplysninger fra den ene til den anden ved hjælp af API’et (en måde for forskellig software at udveksle data automatisk på).

Forudsætninger

Før du starter, skal du sikre dig, at du har:

  • Facebook Ads Manager-adgang med tilladelse til at oprette Lead Ads.
  • En konto med en aktiv API-nøgle (generér en under Indstillinger → Integrationer → API-nøgle — se API-adgang for de præcise trin).
  • En konto på en automatiseringsplatform — Pabbly Connect, Zapier eller Make (Integromat). Denne vejledning bruger Pabbly som eksempel, men trinnene er ens på alle platforme.
  • En kontaktliste i Your AI Connector, hvor nye leads vil blive tilføjet — se Organisering af lister og kontakter.

Oversigt

Integrationen fungerer i tre trin:

  1. En potentiel kunde udfylder din Facebook Lead-formular.
  2. Din automatiseringsplatform registrerer det nye lead og sender automatisk oplysningerne til Your AI Connector (ved hjælp af to API-kald).
  3. Your AI Connector opretter kontakten og tilføjer vedkommende til den liste, du har angivet.

Herfra tager en udsendelse, en kampagne eller en AI-agent, som du har tildelt, sig af resten — uanset om det er en AI-drevet velkomstbesked, en drip-sekvens eller en manuel opfølgning.

Trin 1: Opret din Facebook-kundeemneformular

  1. Åbn Facebook Ads Manager.
  2. Opret en ny kampagne med målsætningen Kundeemner.
  3. På annonce-niveau skal du vælge Instant Form som metode til indsamling af kundeemner.
  4. Byg din formular med de felter, du har brug for. Inkluder som minimum:
    • Fornavn
    • Telefonnummer (med landekode)
    • Valgfrit: Efternavn, e-mail
  5. Publicer annoncen eller gem formularen som kladde til test.

Trin 2: Test kundeemneformularen

Før du forbinder automatiseringen, skal du indsende et test-kundeemne:

  1. Gå til din kundeemneformular i Ads Manager.
  2. Klik på Eksempel og udfyld formularen med testdata.
  3. Bekræft, at test-kundeemnet vises i dit Facebook Lead Center (under Publiceringsværktøjer på din Facebook-side eller i Ads Manager under “Kundeemner”).

Denne testregistrering vil blive brugt til at opsætte feltmapping i din automatiseringsplatform.

Trin 3: Opsæt automatiseringen

Forbind Facebook Lead Ads som udløser

  1. Log ind på din automatiseringsplatform (Pabbly, Zapier eller Make).
  2. Opret et nyt workflow / scenarie / zap.
  3. Indstil udløseren (trigger) til “Facebook Lead Ads - New Lead.”
  4. Forbind din Facebook-konto og vælg siden og formularen (Lead Form).
  5. Hent test-leadet for at bekræfte, at forbindelsen virker, og for at mappe felterne.

Konfigurer API-kald 1: Opret kontakt

Tilføj et handlingstrin med en HTTP / Webhook / API-anmodning:

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

Erstat {{placeholders}} med de faktiske feltmappinger fra dit udløsertrin.

Vigtigt: Telefonnummeret skal indeholde landekoden (for eksempel +1 for USA eller +31 for Holland). Hvis din kundeemneformular indsamler telefonnummeret uden en landekode, skal du tilføje et formateringstrin i din automatisering for at tilføje den foran.

API-svaret returnerer den nye kontakts ID på data.contactId. Gem denne værdi — du skal bruge den til næste trin.

Du kan springe det andet kald over. POST /v1/contacts accepterer også listId (én liste) eller listIds (flere) i oprettelses-bodyen, hvilket tilføjer den nye kontakt til disse lister i samme anmodning. Brug kun to-trins-versionen nedenfor, hvis din automatiseringsplatform kræver, at kontakten eksisterer, før den beslutter, hvilken liste der skal bruges.

Konfigurer API-kald 2: Tilføj kontakt til liste

Tilføj et andet handlingstrin:

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

Erstat YOUR_LIST_ID med det faktiske ID for din kontaktliste (se Find dit liste-ID nedenfor), og map contactId til det data.contactId, der returneres af det første API-kald.

Find dit liste-ID

  1. I Your AI Connector skal du klikke på Kontakter og derefter på fanen Lister.
  2. Åbn rækkemenuen (“⋯”) ud for den liste, du ønsker, og klik på Kopiér liste-ID.

Se Organisering af lister og kontakter for en komplet gennemgang af siden Lister.

Trin 4: Test hele arbejdsgangen

  1. Indsend endnu et test-lead via din Facebook-formular (eller afspil det eksisterende test-lead igen i din automatiseringsplatform).
  2. Tjek Your AI Connector for at bekræfte:
    • Kontakten blev oprettet med det korrekte navn, telefonnummer og e-mail.
    • Kontakten blev tilføjet til den korrekte liste.
  3. Hvis du har en udsendelse, kampagne eller AI-agent, der er indstillet til automatisk at sende besked til den liste, skal du bekræfte, at den udløses som forventet.

Datareference

Nedenfor er eksempler på de data, der sendes og modtages under integrationen.

Opret kontakt - Anmodning 

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

Opret kontakt - Svar 

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

Tilføj kontakt til liste - Anmodning 

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

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

Tips

  • Håndtering af dubletter: Hvis en kontakt med det samme telefonnummer allerede eksisterer, returnerer oprettelseskaldet {"success": false, "error_code": 409} og returnerer ikke den eksisterende kontakt. Forgren på error_code (HTTP-status er 200) og find kontakten med GET /v1/contacts?phoneNumber=... før kaldet til tilføjelse til listen.
  • Flere formularer: Opret separate automatiserings-workflows for forskellige lead-formularer, der hver især målretter en forskellig liste og en forskellig udsendelse, kampagne eller AI-agent.
  • Fejlmeddelelser: Konfigurer din automatiseringsplatform til at give dig besked, hvis et API-kald fejler, så du ikke mister leads.

Næste skridt