# Facebook-kundeemneformularer

Kører du Facebook-annoncer for at indsamle leads? Denne integration sender automatisk disse leads til <span data-t="appName">Your AI Connector</span>, 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 <span data-t="appName">Your AI Connector</span> via en automatiseringsplatform (såsom Pabbly, Zapier eller Make). Disse platforme fungerer som en bro mellem Facebook og <span data-t="appName">Your AI Connector</span>, 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](api-access.md) 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 <span data-t="appName">Your AI Connector</span>, hvor nye leads vil blive tilføjet — se [Organisering af lister og kontakter](../get-started/list-and-contact-management.md).

---

## 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 <span data-t="appName">Your AI Connector</span> (ved hjælp af to API-kald).
3. <span data-t="appName">Your AI Connector</span> 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):**
  ```json
  {
    "firstName": "{{first_name}}",
    "lastName": "{{last_name}}",
    "phone": "{{phone_number}}",
    "email": "{{email}}"
  }
  ```

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

::: warning
**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):**
  ```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](#finding-your-list-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](../get-started/list-and-contact-management.md) 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

```json
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

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

### Tilføj kontakt til liste - Anmodning

```json
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

- [Skift fra Kampagner til Udsendelser & Agenter](../moving-from-campaigns.md) — opsæt noget til automatisk at sende beskeder til nye kundeemner.
- [API-adgang](api-access.md) — fuld API-dokumentation til avancerede integrationer.
- [Webhooks](webhooks.md) — få besked, når kontakter oprettes eller tagges.