# 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](api-access.md) 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](../get-started/list-and-contact-management.md). --- ## 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):** ```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. ::: warning **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):** ```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](#finding-your-list-id) 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](../get-started/list-and-contact-management.md) 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 ```json POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY { "firstName": "Jane", "lastName": "Smith", "phone": "+15551234567", "email": "jane@example.com" } ``` ### Creare contact - Răspuns ```json { "success": true, "data": { "message": "Successfully created new contact", "contactId": "abc123xyz", "listsAdded": [] } } ``` ### Adăugare contact în listă - Cerere ```json POST https://api.youraiconnector.com/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 - [Trecerea de la Campanii la Difuzări și Agenți](../moving-from-campaigns.md) — configurați ceva pentru a trimite automat mesaje noilor clienți potențiali. - [Acces API](api-access.md) — documentație API completă pentru integrări avansate. - [Webhook-uri](webhooks.md) — primiți notificări atunci când contactele sunt create sau etichetate.