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

# Integracja Paperjoy z Zapier

> Wysyłaj odręczną pocztówkę automatycznie, gdy coś wydarzy się w formularzu, CRM lub sklepie.

Dzięki Zapierowi nowy klient, wygrana szansa sprzedaży albo urodziny w kalendarzu mogą wysłać prawdziwą pocztówkę. Bez pisania kodu.

> [!NOTE]
>
> Aplikację Paperjoy w Zapierze instalujesz przez link z zaproszeniem. Nie ma jej jeszcze w publicznym katalogu Zapiera.

## Instalacja i połączenie

**1. Przyjmij zaproszenie**

Otwórz [zaproszenie Paperjoy](https://zapier.com/developer/public-invite/243427/bb628a44df0a0263531ba127cef5e6cd/) i dodaj Paperjoy do swojego konta Zapier. Link znajdziesz też w panelu Paperjoy w **Ustawienia → Integracje**.

**2. Utwórz testowy klucz API**

W Paperjoy włącz [tryb testowy](https://docs.paperjoy.co/getting-started/test-mode.md) i utwórz klucz, np. `zapier-test`, w [**Ustawienia → Klucze API**](https://paperjoy.co/settings/api-tokens). Zaczyna się od `pj_test_`.

**3. Połącz Paperjoy w Zapierze**

Gdy Zapier poprosi o połączenie z Paperjoy, wklej klucz. Nazwij połączenie tak, by łatwo je odróżnić, np. **Paperjoy (test)**.

## Zbuduj Zapa

**1. Wybierz wyzwalacz**

Wybierz aplikację i zdarzenie, które ma wysłać kartkę, np. **New Order** w sklepie albo **Deal Won** w CRM.

**2. Odfiltruj niepełne rekordy**

Dodaj krok **Filter**, aby Zap szedł dalej tylko wtedy, gdy są ulica, kod pocztowy, miasto oraz imię lub firma. Dzięki temu niepełne rekordy nie utworzą zamówień.

**3. Dodaj akcję Paperjoy**

Wybierz Paperjoy jako aplikację akcji i zmapuj pola według tabeli poniżej.

**4. Przetestuj akcję**

Zapier utworzy darmową pocztówkę testową. Sprawdź ją na stronie **Panel** w Paperjoy przy włączonym trybie testowym.

**5. Przełącz na live i opublikuj**

Utwórz klucz `pj_live_`, dodaj go jako drugie połączenie o nazwie **Paperjoy (live)**, wybierz je w akcji i włącz Zapa. Każde uruchomienie składa teraz prawdziwe zamówienie i zużywa jeden kredyt.

## Mapowanie pól

| Pole Paperjoy | Co zmapować | Uwagi |
| - | - | - |
| Odbiorca | Imię, nazwisko, zwrot grzecznościowy, firma | Wymagane imię lub firma. |
| Adres | Ulica, lokal, kod pocztowy, miasto | Kod w formacie `00-001`. Kraj to `PL`. |
| Treść | Twój tekst z polami dynamicznymi | Do 300 znaków i musi zmieścić się na kartce. Zobacz [Treść i wygląd kartki](https://docs.paperjoy.co/postcards/write.md). |
| Podpis | Podpis tekstowy | Do 50 znaków, zapisany w jednej linii. |
| Krój pisma | `font-1` lub `font-2` | Zobacz [Pismo](https://docs.paperjoy.co/postcards/write.md#pismo). |
| Pomyłka | Tak lub nie | Przekreśla jedno słowo i pisze je ponownie dla naturalniejszego wyglądu. |

## Wskazówki dla niezawodnych Zapów

* **Pisz krótko.** Pola dynamiczne, np. długie nazwy firm, mogą przekroczyć limit. Kartka, która się nie mieści, zostaje odrzucona, a nie skrócona.
* **Używaj Formattera.** Usuń zbędne spacje i popraw wielkość liter w imionach, zanim trafią do Paperjoy.
* **Rozdziel połączenia testowe i live.** Nazwij je czytelnie, aby nigdy nie opublikować Zapa wskazującego na zły tryb.
* **Pilnuj salda.** Bez kredytów uruchomienie Zapa się nie powiedzie. Doładuj konto w [Rozliczeniach](https://paperjoy.co/billing) i uruchom Zapa ponownie.


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