Your AI Connector Docs

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).
  • 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.

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):
    {
  "firstName": "{{first_name}}",
  "lastName": "{{last_name}}",
  "phone": "{{phone_number}}",
  "email": "{{email}}"
}

Korvaa {{placeholders}} liipaisinvaiheestasi saaduilla todellisilla kenttämäärityksillä.

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):
    {
  "contactId": "{{contact_id_from_previous_step}}",
  "listId": "YOUR_LIST_ID"
}

Korvaa YOUR_LIST_ID yhteystietolistasi todellisella tunnisteella (katso Listatunnisteen etsiminen 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 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ö 

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

Luo yhteystieto - Vastaus 

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

Lisää yhteystieto listaan - Pyyntö 

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/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