Your AI Connector Docs

Formulare de clienți potențiali Facebook

Rulezi reclame pe Facebook pentru a colecta lead-uri? Această integrare trimite automat acele lead-uri în Your AI Connector, astfel încât să poți lua legătura cu ele prin WhatsApp, SMS sau orice alt canal conectat — fără să ridici un deget.

Funcționează prin conectarea Facebook Lead Ads la Your AI Connector printr-o platformă de automatizare (cum ar fi Pabbly, Zapier sau Make). Aceste platforme acționează ca o punte între Facebook și Your AI Connector, transmițând informațiile despre lead-uri de la una la alta folosind API-ul (o metodă prin care diferite programe software fac schimb de date în mod automat).

Cerințe preliminare

Înainte de a începe, asigură-te că ai:

  • Facebook Ads Manager cu permisiunea de a crea Lead Ads.
  • Un cont cu o cheie API activă (generează una din Setări → Integrări → Cheie API — consultă Acces API pentru pașii exacți).
  • Un cont pe o platformă de automatizare — Pabbly Connect, Zapier sau Make (Integromat). Acest ghid folosește Pabbly ca exemplu, dar pașii sunt similari pe orice platformă.
  • O listă de contacte în Your AI Connector unde vor fi adăugate noile lead-uri — consultă Organizarea listelor și a contactelor.

Prezentare generală

Integrarea funcționează în trei etape:

  1. Un potențial client completează formularul tău Facebook Lead Form.
  2. Platforma ta de automatizare detectează noul lead și trimite informațiile către Your AI Connector în mod automat (folosind două apeluri API).
  3. Your AI Connector creează contactul și îl adaugă în lista specificată de tine.

De acolo, o difuzare, o campanie sau un Agent AI pe care l-ai alocat se ocupă de restul — fie că este vorba despre un mesaj de bun venit bazat pe AI, o secvență de mesaje programate sau o urmărire manuală.

Pasul 1: Creează-ți formularul Facebook Lead Form

  1. Deschide Facebook Ads Manager.
  2. Creează o campanie nouă cu obiectivul Lead-uri.
  3. La nivelul anunțului, alege Formular instantaneu ca metodă de colectare a clienților potențiali.
  4. Construiește formularul cu câmpurile de care ai nevoie. Ca minim, include:
    • Prenume
    • Număr de telefon (cu prefixul țării)
    • Opțional: Nume de familie, e-mail
  5. Publică anunțul sau salvează formularul ca schiță pentru testare.

Pasul 2: Testează formularul pentru clienți potențiali

Înainte de a conecta automatizarea, trimite un client potențial de test:

  1. În Ads Manager, mergi la formularul tău pentru clienți potențiali.
  2. Dă clic pe Previzualizare și completează formularul cu date de test.
  3. Confirmă că respectivul client potențial de test apare în Facebook Lead Center (sub Instrumente de publicare pe pagina ta de Facebook sau în Ads Manager sub “Lead-uri”).

Această intrare de test va fi utilizată pentru a configura maparea câmpurilor în platforma ta de automatizare.

Pasul 3: Configurează automatizarea

Conectați Facebook Lead Ads ca declanșator (Trigger)

  1. Conectați-vă la platforma dvs. de automatizare (Pabbly, Zapier sau Make).
  2. Creați un flux de lucru / scenariu / zap nou.
  3. Setați declanșatorul (trigger) pe “Facebook Lead Ads - New Lead.”
  4. Conectați-vă contul de Facebook și selectați Pagina și Formularul de Lead-uri.
  5. Preluați un lead de test pentru a confirma că conexiunea funcționează și pentru a mapa câmpurile.

Configurați apelul API 1: Creare contact

Adaugă un pas de acțiune cu o cerere HTTP / Webhook / API:

  • Metodă: POST
  • URL: https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
  • Antete (Headers):
    Content-Type: application/json
  • Corp (JSON):
    {
  "firstName": "{{first_name}}",
  "lastName": "{{last_name}}",
  "phone": "{{phone_number}}",
  "email": "{{email}}"
}

Înlocuiți {{placeholders}} cu mapările de câmpuri reale din pasul declanșator.

Important: Numărul de telefon trebuie să includă prefixul de țară (de exemplu, +1 pentru SUA sau +31 pentru Țările de Jos). Dacă formularul tău de lead-uri colectează numărul de telefon fără prefixul de țară, adaugă un pas de formatare în automatizarea ta pentru a-l adăuga la început.

Răspunsul API returnează ID-ul noului contact la data.contactId. Salvează acea valoare — vei avea nevoie de ea pentru pasul următor.

Poți sări peste al doilea apel. POST /v1/contacts acceptă, de asemenea, listId (o listă) sau listIds (mai multe) în corpul cererii de creare, ceea ce adaugă noul contact în acele liste în cadrul aceleiași solicitări. Folosește varianta în doi pași de mai jos doar dacă platforma ta de automatizare necesită ca respectivul contact să existe înainte de a decide ce listă să folosească.

Configurați apelul API 2: Adăugare contact în listă

Adăugați un al doilea pas de acțiune:

  • Metodă: POST
  • URL: https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
  • Antete:
    Content-Type: application/json
  • Corp (JSON):
    {
  "contactId": "{{contact_id_from_previous_step}}",
  "listId": "YOUR_LIST_ID"
}

Înlocuiește YOUR_LIST_ID cu ID-ul real al listei tale de contacte (vezi Găsirea ID-ului listei tale mai jos) și mapează contactId la data.contactId returnat de primul apel API.

Găsirea ID-ului listei dvs.

  1. În Your AI Connector, dă clic pe Contacte, apoi pe fila Liste.
  2. Deschide meniul rândului (“⋯”) de lângă lista dorită și dă clic pe Copiază ID-ul listei.

Consultă Organizarea listelor și a contactelor pentru prezentarea completă a paginii Liste.

Pasul 4: Testați fluxul de lucru complet

  1. Trimite un alt lead de test prin formularul tău de Facebook (sau reia lead-ul de test existent în platforma ta de automatizare).
  2. Verifică Your AI Connector pentru a confirma:
    • Contactul a fost creat cu numele, numărul de telefon și adresa de e-mail corecte.
    • Contactul a fost adăugat în lista corectă.
  3. Dacă ai o difuzare, o campanie sau un Agent AI setat să trimită mesaje automat acelei liste, confirmă că se declanșează conform așteptărilor.

Referință date

Mai jos sunt exemple de date trimise și primite în timpul integrării.

Creare contact - Cerere 

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

Creare contact - Răspuns 

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

Adăugare contact în listă - Cerere 

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

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

Sfaturi

  • Gestionarea duplicatelor: dacă un contact cu același număr de telefon există deja, apelul de creare returnează {"success": false, "error_code": 409} și nu returnează contactul existent. Ramifică pe error_code (codul de stare HTTP este 200) și caută contactul cu GET /v1/contacts?phoneNumber=... înainte de apelul de adăugare în listă.
  • Formulare multiple: creează fluxuri de lucru de automatizare separate pentru diferite formulare de lead-uri, fiecare vizând o listă diferită și o difuzare, campanie sau Agent AI diferit.
  • Notificări de eroare: configurează platforma ta de automatizare să te notifice dacă un apel API eșuează, astfel încât să nu pierzi lead-uri.

Pașii următori