# Formularze kontaktowe Facebook Prowadzisz reklamy na Facebooku, aby pozyskiwać leady? Ta integracja automatycznie przesyła te leady do Your AI Connector, dzięki czemu możesz kontaktować się z nimi przez WhatsApp, SMS lub dowolny inny podłączony kanał — bez kiwnięcia palcem. Działa to poprzez połączenie Facebook Lead Ads z Your AI Connector za pośrednictwem platformy automatyzacji (takiej jak Pabbly, Zapier lub Make). Platformy te pełnią rolę pomostu między Facebookiem a Your AI Connector, przekazując informacje o leadach z jednego systemu do drugiego przy użyciu API (sposobu, w jaki różne programy automatycznie wymieniają dane). --- ## Wymagania wstępne Zanim zaczniesz, upewnij się, że masz: - **Dostęp do Menedżera reklam Facebooka** z uprawnieniami do tworzenia reklam typu Lead Ads. - **Konto** z aktywnym kluczem API (wygeneruj go w **Ustawienia → Integracje → Klucz API** — zobacz [Dostęp do API](api-access.md), aby poznać dokładne kroki). - **Konto na platformie automatyzacji** — Pabbly Connect, Zapier lub Make (Integromat). W tym przewodniku jako przykładu użyto Pabbly, ale kroki są podobne na każdej platformie. - **Lista kontaktów** w Your AI Connector, do której będą dodawane nowe leady — zobacz [Organizowanie list i kontaktów](../get-started/list-and-contact-management.md). --- ## Omówienie Integracja działa w trzech etapach: 1. Potencjalny klient wypełnia Twój formularz kontaktowy na Facebooku. 2. Twoja platforma automatyzacji wykrywa nowy lead i automatycznie wysyła informacje do Your AI Connector (przy użyciu dwóch wywołań API). 3. Your AI Connector tworzy kontakt i dodaje go do wskazanej przez Ciebie listy. Stamtąd transmisja, kampania lub przypisany przez Ciebie agent AI zajmie się resztą — niezależnie od tego, czy będzie to wiadomość powitalna oparta na sztucznej inteligencji, sekwencja drip, czy ręczne sprawdzenie. --- ## Krok 1: Utwórz formularz kontaktowy na Facebooku 1. Otwórz **Menedżera reklam Facebook**. 2. Utwórz nową kampanię z celem **Leady**. 3. Na poziomie reklamy wybierz **Formularz błyskawiczny** jako metodę pozyskiwania leadów. 4. Zbuduj formularz z potrzebnymi polami. Wymagane minimum to: - **Imię** - **Numer telefonu** (z kodem kraju) - Opcjonalnie: Nazwisko, adres e-mail 5. Opublikuj reklamę lub zapisz formularz jako wersję roboczą do testów. --- ## Krok 2: Przetestuj formularz kontaktowy Zanim połączysz automatyzację, prześlij testowy lead: 1. W Menedżerze reklam przejdź do swojego formularza kontaktowego. 2. Kliknij **Podgląd** i wypełnij formularz danymi testowymi. 3. Potwierdź, że testowy lead pojawia się w Twoim **Centrum leadów na Facebooku** (w Narzędziach do publikowania na Twojej stronie na Facebooku lub w Menedżerze reklam w sekcji "Leady"). Ten wpis testowy zostanie użyty do skonfigurowania mapowania pól w Twojej platformie automatyzacji. --- ## Krok 3: Skonfiguruj automatyzację ### Połącz Facebook Lead Ads jako wyzwalacz 1. Zaloguj się do swojej platformy automatyzacji (Pabbly, Zapier lub Make). 2. Utwórz nowy przepływ pracy / scenariusz / zap. 3. Ustaw **wyzwalacz** (trigger) na "Facebook Lead Ads - New Lead". 4. Połącz swoje konto na Facebooku i wybierz stronę oraz formularz kontaktowy (Lead Form). 5. Pobierz testowy lead, aby potwierdzić działanie połączenia i zmapować pola. ### Skonfiguruj wywołanie API 1: Utwórz kontakt Dodaj krok akcji za pomocą żądania HTTP / Webhook / API: - **Metoda:** `POST` - **URL:** `https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY` - **Nagłówki:** ``` Content-Type: application/json ``` - **Treść (JSON):** ```json { "firstName": "{{first_name}}", "lastName": "{{last_name}}", "phone": "{{phone_number}}", "email": "{{email}}" } ``` Zastąp `{{placeholders}}` rzeczywistymi mapowaniami pól z kroku wyzwalacza. ::: warning **Ważne:** Numer telefonu musi zawierać kod kraju (na przykład `+1` dla USA lub `+31` dla Holandii). Jeśli Twój formularz kontaktowy zbiera numer telefonu bez kodu kraju, dodaj krok formatowania w swojej automatyzacji, aby go dodać na początku. ::: Odpowiedź API zwraca identyfikator nowego kontaktu w `data.contactId`. Zapisz tę wartość — będzie potrzebna w następnym kroku. > **Możesz pominąć drugie wywołanie.** `POST /v1/contacts` akceptuje również `listId` (jedna lista) lub `listIds` (kilka) w treści tworzenia, co dodaje nowy kontakt do tych list w tym samym żądaniu. Użyj poniższej wersji dwuetapowej tylko wtedy, gdy Twoja platforma automatyzacji wymaga, aby kontakt istniał, zanim zdecyduje, której listy użyć. ### Skonfiguruj wywołanie API 2: Dodaj kontakt do listy Dodaj drugi krok akcji: - **Metoda:** `POST` - **URL:** `https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY` - **Nagłówki:** ``` Content-Type: application/json ``` - **Treść (JSON):** ```json { "contactId": "{{contact_id_from_previous_step}}", "listId": "YOUR_LIST_ID" } ``` Zastąp `YOUR_LIST_ID` rzeczywistym identyfikatorem swojej listy kontaktów (zobacz [Znajdowanie identyfikatora listy](#finding-your-list-id) poniżej) i przypisz `contactId` do `data.contactId` zwróconego przez pierwsze wywołanie API. --- ## Znajdowanie ID listy 1. W Your AI Connector kliknij **Kontakty**, a następnie kartę **Listy**. 2. Otwórz menu wiersza („⋯”) obok wybranej listy i kliknij **Kopiuj ID listy**. Zobacz [Organizowanie list i kontaktów](../get-started/list-and-contact-management.md), aby zapoznać się z pełnym przewodnikiem po stronie Listy. --- ## Krok 4: Przetestuj pełny przepływ pracy 1. Prześlij kolejny testowy lead przez swój formularz na Facebooku (lub odtwórz istniejący testowy lead w swojej platformie automatyzacji). 2. Sprawdź w Your AI Connector, czy: - **Kontakt** został utworzony z poprawnym imieniem, numerem telefonu i adresem e-mail. - Kontakt został **dodany do właściwej listy**. 3. Jeśli masz ustawioną transmisję, kampanię lub agenta AI, który ma automatycznie wysyłać wiadomości do tej listy, sprawdź, czy uruchamia się zgodnie z oczekiwaniami. --- ## Referencje danych Poniżej znajdują się przykłady danych wysyłanych i odbieranych podczas integracji. ### Utwórz kontakt - Żądanie ```json POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY { "firstName": "Jane", "lastName": "Smith", "phone": "+15551234567", "email": "jane@example.com" } ``` ### Utwórz kontakt - Odpowiedź ```json { "success": true, "data": { "message": "Successfully created new contact", "contactId": "abc123xyz", "listsAdded": [] } } ``` ### Dodaj kontakt do listy - Żądanie ```json POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY { "contactId": "abc123xyz", "listId": "LIST_ID" } ``` --- ## Wskazówki - **Obsługa duplikatów:** jeśli kontakt o tym samym numerze telefonu już istnieje, wywołanie tworzenia zwraca `{"success": false, "error_code": 409}` i nie zwraca istniejącego kontaktu. Rozgałęź na `error_code` (kod stanu HTTP to 200) i wyszukaj kontakt za pomocą `GET /v1/contacts?phoneNumber=...` przed wywołaniem dodawania do listy. - **Wiele formularzy:** utwórz oddzielne przepływy pracy automatyzacji dla różnych formularzy leadów, z których każdy jest kierowany na inną listę oraz inną transmisję, kampanię lub agenta AI. - **Powiadomienia o błędach:** skonfiguruj swoją platformę automatyzacji tak, aby powiadamiała Cię o niepowodzeniu wywołania API, dzięki czemu nie stracisz leadów. --- ## Następne kroki - [Przejście z Kampanii na Transmisje i Agenty](../moving-from-campaigns.md) — skonfiguruj automatyczne wysyłanie wiadomości do nowych leadów. - [Dostęp do API](api-access.md) — pełna dokumentacja API dla zaawansowanych integracji. - [Webhooki](webhooks.md) — otrzymuj powiadomienia, gdy kontakty są tworzone lub oznaczane tagami.