# Facebook-leadformulär

Kör du Facebook-annonser för att samla in leads? Denna integration skickar automatiskt dessa leads till <span data-t="appName">Your AI Connector</span> 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 <span data-t="appName">Your AI Connector</span> via en automatiseringsplattform (som Pabbly, Zapier eller Make). Dessa plattformar fungerar som en brygga mellan Facebook och <span data-t="appName">Your AI Connector</span> 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](api-access.md) 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 <span data-t="appName">Your AI Connector</span> där nya leads kommer att läggas till — se [Organisera listor och kontakter](../get-started/list-and-contact-management.md).

---

## Ö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 <span data-t="appName">Your AI Connector</span> automatiskt (med hjälp av två API-anrop).
3. <span data-t="appName">Your AI Connector</span> 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):**
  ```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.

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

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

### Skapa kontakt - Svar

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

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

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

- [Flytta från kampanjer till utskick & agenter](../moving-from-campaigns.md) — ställ in något för att automatiskt skicka meddelanden till nya leads.
- [API-åtkomst](api-access.md) — fullständig API-dokumentation för avancerade integrationer.
- [Webhooks](webhooks.md) — få meddelanden när kontakter skapas eller taggas.