Your AI Connector Docs

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, 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.

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

Zastąp {{placeholders}} rzeczywistymi mapowaniami pól z kroku wyzwalacza.

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):
    {
  "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 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, 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 

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

Utwórz kontakt - Odpowiedź 

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

Dodaj kontakt do listy - Żądanie 

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