> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brosbots.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Szablony Make i Zapier dla leadów z reklam

> Gotowe scenariusze, które przekazują leady z Facebooka, Instagrama, LinkedIna, TikToka albo arkusza Google do agenta BrosBots.

## Co to robi

Make i Zapier mają własne, zatwierdzone połączenia z platformami reklamowymi.
Wystarczy, że zalogujesz się tam do konta reklamowego, a każde nowe
zgłoszenie z formularza trafi na adres agenta i agent zadzwoni do tej osoby
w kilka sekund. Nie potrzebujesz do tego żadnej integracji po stronie
BrosBots poza samym adresem.

Każdy scenariusz kończy się tym samym krokiem: zapytaniem `POST` z JSON-em
na adres agenta. Jak ten adres działa, opisuje
[Oddzwanianie do leadów](/pl/integrations/leads/lead-webhook).

| Źródło | Make | Zapier |
| - | - | - |
| Facebook i Instagram (Lead Ads) | gotowy szablon do importu | instrukcja krok po kroku |
| LinkedIn Lead Gen Forms | instrukcja krok po kroku | instrukcja krok po kroku |
| TikTok Lead Generation | instrukcja krok po kroku | instrukcja krok po kroku |
| Arkusz Google (nowy wiersz) | gotowy szablon do importu | instrukcja krok po kroku |

Zapier nie pozwala importować scenariuszy z pliku, dlatego dla Zapiera są
same instrukcje. Konfiguracja zajmuje kilka minut.

## Skąd wziąć adres agenta

Edytor agenta → **Integracje** → sekcja **Źródła leadów**. Skopiuj adres
formularza. Wygląda tak:

```
https://app.brosbots.com/api/v1/public/lead/<id>?t=<token>
```

<Warning>
  Adres zawiera token i działa jak klucz. Wklejaj go tylko w konfiguracji Make
  albo Zapiera, nigdy w kodzie strony ani w publicznym dokumencie.
</Warning>

## Gotowe szablony Make

| Szablon | Plik |
| - | - |
| Facebook Lead Ads (Facebook i Instagram) | [facebook-lead-ads-do-brosbots.json](https://app.brosbots.com/templates/make/facebook-lead-ads-do-brosbots.json) |
| Nowy wiersz w arkuszu Google | [google-sheets-do-brosbots.json](https://app.brosbots.com/templates/make/google-sheets-do-brosbots.json) |

Kliknij plik prawym przyciskiem i wybierz **Zapisz link jako**, żeby pobrać
go na dysk.

### Import szablonu

1. W Make otwórz **Scenarios** → **Create a new scenario**.
2. Na dole edytora kliknij menu **…** (więcej) → **Import Blueprint**.
3. Wybierz pobrany plik `.json` i kliknij **Save**.
4. Kliknij pierwszy moduł i połącz swoje konto (Facebook albo Google).
5. Kliknij moduł **HTTP** (BrosBots) i w polu **URL** zastąp
   `https://app.brosbots.com/api/v1/public/lead/WKLEJ-ADRES-AGENTA` całym
   adresem skopiowanym z edytora agenta, razem z `?t=...`.
6. Zapisz scenariusz i włącz go przełącznikiem w lewym dolnym rogu.

### Facebook Lead Ads (Facebook i Instagram)

Szablon zaczyna się od modułu **Facebook Lead Ads → New Lead**. To wyzwalacz
natychmiastowy: Meta powiadamia Make o każdym zgłoszeniu, więc lead trafia do
agenta od razu. Formularze błyskawiczne na Instagramie działają tak samo,
bo należą do tej samej strony na Facebooku.

1. W module **New Lead** kliknij **Create a webhook**, połącz konto
   Facebooka i wybierz stronę oraz formularz. Formularz musi mieć co
   najmniej jedno zgłoszenie, inaczej Make go nie pokaże (wyślij lead
   testowy, opis niżej).
2. Ustaw harmonogram scenariusza na **Immediately** (od razu po przyjściu
   danych). Przy tym wyzwalaczu to ustawienie domyślne.
3. Moduł HTTP wysyła do agenta takie pola:

```json theme={null}
{
  "phone_number": "{{1.data.phone_number}}",
  "full_name": "{{1.data.full_name}}",
  "email": "{{1.data.email}}",
  "campaign_name": "{{1.campaignName}}",
  "adset_name": "{{1.adsetName}}",
  "ad_name": "{{1.adName}}",
  "form_id": "{{1.formId}}",
  "platform": "{{1.platform}}",
  "source": "facebook_lead_ads"
}
```

Pytania własne z formularza są w module jako `{{1.data.<nazwa_pytania>}}`.
Dopisz je do treści, jeśli agent ma je znać w rozmowie. Każde pole trafia do
rozmowy jako zmienna o tej samej nazwie, na przykład `{{campaign_name}}`.
Meta nie podaje w leadzie nazwy formularza, tylko jego identyfikator
(`form_id`).

<Note>
  Meta musi zezwolić Make na dostęp do leadów strony. Jeśli moduł nie widzi
  formularzy, w Meta Business Suite otwórz **Ustawienia** → **Integracje** →
  **Dostęp do leadów** i upewnij się, że Make (albo Zapier) ma dostęp.
</Note>

### Nowy wiersz w arkuszu Google

Uniwersalny szablon na każde źródło, które potrafi dopisać wiersz do arkusza
(Typeform, Tally, formularze Google, eksport z CRM, ręczne wpisy). Moduł
**Google Sheets → Watch Rows** sprawdza arkusz według harmonogramu, więc nie
jest natychmiastowy.

1. W module **Watch Rows** wybierz arkusz i zakładkę. Pierwszy wiersz to
   nagłówki.
2. Szablon zakłada kolumny: **A** imię i nazwisko, **B** telefon, **C**
   e-mail. Jeśli Twój arkusz ma inny układ, zmień mapowanie w module HTTP.
3. Ustaw harmonogram scenariusza na **Every 1 minute** (lub najkrótszy
   interwał w Twoim planie Make). Przy pierwszym uruchomieniu wybierz, od
   którego wiersza zacząć, żeby agent nie dzwonił do starych wpisów.

<Note>
  Jeśli narzędzie ma własne webhooki (Typeform, Tally, Elementor, Webflow),
  Make nie jest potrzebny: wklej adres agenta prosto w ustawieniach webhooka.
  Lista miejsc jest w [Oddzwanianie do leadów](/pl/integrations/leads/lead-webhook).
</Note>

## LinkedIn Lead Gen Forms w Make

Make ma aplikację **LinkedIn Lead Forms** z wyzwalaczem **Watch Form
Responses**. Gotowego szablonu nie udostępniamy, bo nazwy pól zależą od
formularza.

1. Nowy scenariusz → moduł **LinkedIn Lead Forms → Watch Form Responses**.
   Połącz konto LinkedIn z dostępem do Campaign Manager i wybierz konto
   reklamowe oraz formularz.
2. Dodaj moduł **HTTP → Make a request**: metoda `POST`, URL to adres agenta,
   **Body type** `Raw`, **Content type** `JSON (application/json)`.
3. W **Request content** zmapuj odpowiedź z formularza, na przykład
   `{"phone": "...", "name": "...", "email": "...", "source": "linkedin"}`,
   wstawiając w miejsce kropek pola z modułu LinkedIn (numer telefonu, imię,
   nazwisko, e-mail, nazwę kampanii, jeśli jest dostępna).
4. Wyślij testowe zgłoszenie (opis niżej), uruchom scenariusz raz przyciskiem
   **Run once**, żeby Make poznał pola, i dokończ mapowanie.
5. Zapisz i włącz scenariusz. Przy wyzwalaczu natychmiastowym harmonogram to
   **Immediately**.

<Warning>
  Numer telefonu w formularzu LinkedIn jest polem opcjonalnym. Dodaj go do
  formularza, inaczej agent nie będzie miał do kogo dzwonić.
</Warning>

## TikTok Lead Generation w Make

Make ma aplikację **TikTok Lead Forms** z jednym wyzwalaczem: **Watch Leads**
(natychmiastowy, przez webhook).

1. Nowy scenariusz → moduł **TikTok Lead Forms → Watch Leads**. Połącz konto
   TikTok for Business, wybierz Advertiser ID i formularz błyskawiczny
   (Instant Form) z TikTok Ads Manager.
2. Dodaj moduł **HTTP → Make a request** skonfigurowany tak jak dla
   LinkedIna, z `"source": "tiktok"` w treści.
3. Zmapuj numer telefonu, imię i e-mail z modułu TikTok. Pola zobaczysz po
   pierwszym leadzie testowym.
4. Zapisz i włącz scenariusz.

## Zapier

Każdy Zap ma dwa kroki: wyzwalacz z platformy reklamowej i akcję
**Webhooks by Zapier → POST**.

| Źródło | Aplikacja i wyzwalacz w Zapierze |
| - | - |
| Facebook i Instagram | **Facebook Lead Ads** → **New Lead** |
| LinkedIn | **LinkedIn Lead Gen Forms** → **New Lead Gen Form Response** |
| TikTok | **TikTok Lead Generation** → **New Lead** |
| Arkusz Google | **Google Sheets** → **New Spreadsheet Row** |
| Typeform | **Typeform** → **New Entry** |

1. **Create** → **Zaps**. W kroku **Trigger** wybierz aplikację i wyzwalacz
   z tabeli, połącz konto i wskaż stronę, konto reklamowe albo formularz.
2. Kliknij **Test trigger**. Zapier pobierze ostatnie zgłoszenie, więc wcześniej
   wyślij lead testowy.
3. W kroku **Action** wybierz **Webhooks by Zapier** → zdarzenie **POST**.
4. **URL**: adres agenta. **Payload Type**: `json`.
5. W **Data** dodaj pary klucz i wartość, na przykład `phone_number` →
   numer telefonu z wyzwalacza, `full_name` → imię i nazwisko, `email` →
   e-mail, `campaign_name` → nazwa kampanii, `source` → `facebook_lead_ads`.
6. Kliknij **Test step**. Agent zadzwoni na numer z testowego leada, więc
   użyj własnego numeru.
7. **Publish**.

<Note>
  Webhooks by Zapier jest aplikacją premium i działa w płatnych planach
  Zapiera. W Make moduł HTTP jest dostępny także w planie darmowym.
</Note>

## Lead testowy

* **Facebook i Instagram**: Meta udostępnia narzędzie
  [Lead Ads Testing Tool](https://developers.facebook.com/tools/lead-ads-testing).
  Wybierz stronę i formularz, kliknij **Create lead**. Wpisz w formularzu
  własny numer telefonu.
* **LinkedIn**: w Campaign Manager otwórz podgląd reklamy z formularzem i wyślij
  go ze swojego konta.
* **TikTok**: w TikTok Ads Manager otwórz podgląd formularza błyskawicznego
  i wyślij zgłoszenie.
* **Arkusz Google**: dopisz wiersz ze swoim numerem.

Agent zadzwoni naprawdę, więc testuj na własnym numerze i w godzinach
dzwonienia ustawionych w agencie. Poza nimi połączenie zostanie zaplanowane
na najbliższe otwarcie okna.

## Rozwiązywanie problemów

Odpowiedź agenta widać w historii scenariusza Make (dymek nad modułem HTTP)
albo w historii Zapa (**Zap runs**).

| Kod | Co znaczy | Co zrobić |
| - | - | - |
| `200 {"status":"calling"}` | agent dzwoni | nic, działa |
| `200 {"status":"scheduled"}` | poza godzinami, brak wolnego kanału albo brak środków | połączenie zostanie wykonane później (bez środków czeka godzinę na doładowanie) |
| `200 {"status":"duplicate"}` | ten numer był przyjęty przed chwilą | normalne przy ponownym teście z tym samym numerem |
| `200 {"status":"do_not_call"}` | numer jest na liście Nie dzwonić | nic; usuń go z listy, jeśli trafił tam przez pomyłkę |
| `400` | brak numeru telefonu w treści | sprawdź mapowanie pola z telefonem i czy formularz o niego pyta |
| `401` | zły token | wklej ponownie cały adres z edytora agenta, razem z `?t=...` |
| `403` | źródło leadów wyłączone | włącz je w **Integracje** → **Źródła leadów** |
| `429` | przekroczone [limity leadów](/pl/integrations/leads/lead-webhook#limity) | pozwól Make/Zapierowi ponowić po `Retry-After`; napisz do nas, jeśli masz większy ruch |

Inne częste przyczyny:

* **Scenariusz nie rusza**: sprawdź, czy jest włączony i czy ma harmonogram
  **Immediately** (Facebook, LinkedIn, TikTok).
* **`400` mimo numeru w formularzu**: wartość w treści jest pusta, bo pole
  zmapowano z innego modułu albo formularz używa pytania własnego zamiast
  standardowego numeru telefonu. Nazwę takiego pola możesz wpisać w
  **Nazwa pola z telefonem** w ustawieniach agenta.
* **Błąd JSON w module HTTP**: wartość z cudzysłowem (`"`) psuje treść.
  Usuń cudzysłowy z pytań własnych albo pomiń takie pole.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.