# Facebook-liidilomakkeet Pyöritätkö Facebook-mainoksia liidien hankkimiseksi? Tämä integraatio lähettää liidit automaattisesti kohteeseen Your AI Connector, jotta voit ottaa heihin yhteyttä WhatsAppin, tekstiviestien tai minkä tahansa muun yhdistetyn kanavan kautta – ilman, että sinun tarvitsee tehdä mitään. Se toimii yhdistämällä Facebook Lead Ads -mainokset kohteeseen Your AI Connector automaatioalustan (kuten Pabbly, Zapier tai Make) kautta. Nämä alustat toimivat siltana Facebookin ja kohteen Your AI Connector välillä ja välittävät liidien tiedot sovelluksesta toiseen API-rajapinnan avulla (tapa, jolla eri ohjelmistot vaihtavat tietoja automaattisesti). --- ## Esivaatimukset Ennen kuin aloitat, varmista, että sinulla on: - **Facebook Ads Manager** -käyttöoikeus, jolla on lupa luoda liidimainoksia (Lead Ads). - **Tili**, jolla on aktiivinen API-avain (luo sellainen kohdassa **Settings → Integrations → API Key** — katso tarkat ohjeet kohdasta [API Access](api-access.md)). - **Automaatioalustan** tili — Pabbly Connect, Zapier tai Make (Integromat). Tässä oppaassa käytetään esimerkkinä Pabblyä, mutta vaiheet ovat samankaltaisia kaikilla alustoilla. - **Yhteystietolista** kohteessa Your AI Connector, johon uudet liidit lisätään — katso [Organizing Lists & Contacts](../get-started/list-and-contact-management.md). --- ## Yleiskatsaus Integraatio toimii kolmessa vaiheessa: 1. Potentiaalinen asiakas täyttää Facebook-liidilomakkeesi. 2. Automaatioalustasi tunnistaa uuden liidin ja lähettää tiedot automaattisesti kohteeseen Your AI Connector (käyttäen kahta API-kutsua). 3. Your AI Connector luo yhteystiedon ja lisää sen määrittämällesi listalle. Tämän jälkeen lähetys, kampanja tai määrittämäsi tekoälyagentti hoitaa loput – olipa kyseessä tekoälypohjainen tervetuloviesti, sarjaviestintä tai manuaalinen yhteydenotto. --- ## Vaihe 1: Luo Facebook-liidilomake 1. Avaa **Facebook Ads Manager**. 2. Luo uusi kampanja, jonka tavoitteena on **Liidit**. 3. Valitse mainostasolla liidien keruutavaksi **Pikalomake** (Instant Form). 4. Rakenna lomake tarvitsemillasi kentillä. Sisällytä vähintään: - **Etunimi** - **Puhelinnumero** (maakoodilla) - Valinnainen: Sukunimi, sähköposti 5. Julkaise mainos tai tallenna lomake luonnoksena testausta varten. --- ## Vaihe 2: Testaa liidilomaketta Ennen automaation yhdistämistä lähetä testiliidi: 1. Siirry Ads Managerissa liidilomakkeeseesi. 2. Napsauta **Esikatselu** ja täytä lomake testitiedoilla. 3. Varmista, että testiliidi näkyy **Facebook Lead Centerissäsi** (Facebook-sivusi julkaisutyökalujen alla tai Ads Managerissa kohdassa "Liidit"). Tätä testimerkintää käytetään kenttien yhdistämisen määrittämiseen automaatioalustallasi. --- ## Vaihe 3: Määritä automaatio ### Yhdistä Facebook Lead Ads liipaisimeksi 1. Kirjaudu automaatioalustallesi (Pabbly, Zapier tai Make). 2. Luo uusi työnkulku / skenaario / zap. 3. Aseta **liipaisimeksi** "Facebook Lead Ads - New Lead". 4. Yhdistä Facebook-tilisi ja valitse sivu sekä liidilomake. 5. Hae testiliidi varmistaaksesi yhteyden toimivuuden ja yhdistääksesi kentät. ### Määritä API-kutsu 1: Luo yhteystieto Lisää toimintavaihe HTTP / Webhook / API-pyynnöllä: - **Metodi:** `POST` - **URL:** `https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY` - **Otsikot:** ``` Content-Type: application/json ``` - **Runko (JSON):** ```json { "firstName": "{{first_name}}", "lastName": "{{last_name}}", "phone": "{{phone_number}}", "email": "{{email}}" } ``` Korvaa `{{placeholders}}` liipaisinvaiheestasi saaduilla todellisilla kenttämäärityksillä. ::: warning **Tärkeää:** Puhelinnumeron on sisällettävä maakoodi (esimerkiksi `+1` Yhdysvalloille tai `+31` Alankomaille). Jos liidilomakkeesi kerää puhelinnumeron ilman maakoodia, lisää automaatioosi muotoiluvaihe, joka lisää sen numeron alkuun. ::: API-vastaus palauttaa uuden yhteystiedon tunnisteen kohdassa `data.contactId`. Tallenna tämä arvo – tarvitset sitä seuraavassa vaiheessa. > **Voit ohittaa toisen kutsun.** `POST /v1/contacts` hyväksyy myös `listId` (yksi lista) tai `listIds` (useita) luontirungossa, mikä lisää uuden yhteystiedon kyseisiin listoihin samassa pyynnössä. Käytä alla olevaa kaksivaiheista versiota vain, jos automaatioalustasi vaatii, että yhteystieto on olemassa ennen kuin se päättää, mitä listaa käytetään. ### Määritä API-kutsu 2: Lisää yhteystieto listaan Lisää toinen toimintavaihe: - **Metodi:** `POST` - **URL:** `https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY` - **Otsikot:** ``` Content-Type: application/json ``` - **Runko (JSON):** ```json { "contactId": "{{contact_id_from_previous_step}}", "listId": "YOUR_LIST_ID" } ``` Korvaa `YOUR_LIST_ID` yhteystietolistasi todellisella tunnisteella (katso [Listatunnisteen etsiminen](#finding-your-list-id) alta) ja yhdistä `contactId` ensimmäisen API-kutsun palauttamaan `data.contactId`-arvoon. --- ## Listatunnisteen (List ID) etsiminen 1. Napsauta kohteessa Your AI Connector kohtaa **Yhteystiedot** ja sitten **Listat**-välilehteä. 2. Avaa haluamasi listan kohdalla oleva rivivalikko ("⋯") ja napsauta **Kopioi listan ID**. Katso [Luetteloiden ja yhteystietojen järjestäminen](../get-started/list-and-contact-management.md) saadaksesi täydellisen läpikäynnin Luettelot-sivusta. --- ## Vaihe 4: Testaa koko työnkulku 1. Lähetä toinen testiliidi Facebook-lomakkeesi kautta (tai toista olemassa oleva testiliidi automaatioalustallasi). 2. Tarkista kohteesta Your AI Connector, että: - **Yhteystieto** luotiin oikealla nimellä, puhelinnumerolla ja sähköpostiosoitteella. - Yhteystieto **lisättiin oikealle listalle**. 3. Jos sinulla on lähetys, kampanja tai tekoälyagentti, joka on asetettu viestimään kyseiselle listalle automaattisesti, varmista, että se käynnistyy odotetusti. --- ## Tietoviite Alla on esimerkkejä tiedoista, joita lähetetään ja vastaanotetaan integraation aikana. ### Luo yhteystieto - Pyyntö ```json POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY { "firstName": "Jane", "lastName": "Smith", "phone": "+15551234567", "email": "jane@example.com" } ``` ### Luo yhteystieto - Vastaus ```json { "success": true, "data": { "message": "Successfully created new contact", "contactId": "abc123xyz", "listsAdded": [] } } ``` ### Lisää yhteystieto listaan - Pyyntö ```json POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY { "contactId": "abc123xyz", "listId": "LIST_ID" } ``` --- ## Vinkkejä - **Kaksoiskappaleiden käsittely:** jos samalla puhelinnumerolla varustettu yhteystieto on jo olemassa, luontikutsu palauttaa `{"success": false, "error_code": 409}` eikä palauta olemassa olevaa yhteystietoa. Haarauta `error_code`-kohdan perusteella (HTTP-tila on 200) ja etsi yhteystieto `GET /v1/contacts?phoneNumber=...`-kutsulla ennen listaan lisäämistä. - **Useita lomakkeita:** luo erilliset automaatiotyönkulut eri liidilomakkeille, joista jokainen kohdistuu eri listaan ja eri lähetykseen, kampanjaan tai tekoälyagenttiin. - **Virheilmoitukset:** määritä automaatioalustasi ilmoittamaan, jos API-kutsu epäonnistuu, jotta et menetä liidejä. --- ## Seuraavat vaiheet - [Siirtyminen kampanjoista lähetyksiin ja agentteihin](../moving-from-campaigns.md) — määritä automaattinen viestintä uusille liideille. - [API-käyttöoikeus](api-access.md) — täydellinen API-dokumentaatio edistyneitä integraatioita varten. - [Webhookit](webhooks.md) — vastaanota ilmoituksia, kun yhteystietoja luodaan tai merkitään tunnisteilla.