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

# Jak działa Paperjoy

> Co dzieje się od Twojego zlecenia do pocztówki w skrzynce odbiorcy i który sposób wysyłki wybrać.

Paperjoy zamienia zlecenie w prawdziwą pocztówkę. Robot pisze Twoją wiadomość prawdziwym długopisem na kartce A6, tym samym pismem adresuje kopertę C6, a my nadajemy ją Pocztą Polską. Znaczek jest w cenie.

![Odręcznie zapisana pocztówka: Droga Anno, dziękujemy za pierwsze zamówienie! Mamy nadzieję, że kwiaty sprawiły Ci dużo radości. Do zobaczenia wiosną! Podpis: Marta z Kwiaciarni Pod Lipą.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/postcards/card-font-1-pl.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=9398ab490b5b8cd6a86847287899a189)

Kartka zapisana krojem font-1

![Odręcznie zaadresowana koperta z adresem nadawcy w lewym górnym rogu i adresem odbiorcy na środku.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/postcards/envelope.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=b730436957fe28abed5549ed6b1eaee3)

Koperta z Twoim adresem zwrotnym

## Wybierz sposób wysyłki

Wszystkie cztery sposoby tworzą taką samą pocztówkę i korzystają z tych samych kredytów. Wybierz ten, który pasuje do tego, kto lub co zleca wysyłkę.

| Sposób | Najlepszy, gdy | Kod | Tryb testowy |
| - | - | - | - |
| [Edytor](https://docs.paperjoy.co/integrations/editor.md) | Piszesz pojedyncze kartki w panelu Paperjoy. | Nie | Tak |
| [Zapier](https://docs.paperjoy.co/integrations/zapier.md) | Kartkę ma wysłać formularz, CRM, sklep lub kalendarz. | Nie | Tak |
| [MCP](https://docs.paperjoy.co/integrations/mcp.md) | Chcesz, by asystent AI, np. Claude, pisał i wysyłał kartki. | Nie | Nie, zawsze live |
| [API](https://docs.paperjoy.co/getting-started/quickstart.md) | Kartki wysyła Twoja aplikacja i potrzebujesz pełnej kontroli. | Tak | Tak |

> [!TIP]
>
> Nie wiesz, od czego zacząć? Napisz jedną kartkę w [edytorze](https://docs.paperjoy.co/integrations/editor.md). Zobaczysz dokładnie, jak wygląda Twoja wiadomość, zanim cokolwiek zautomatyzujesz.

## Co przekazujesz Ty

* **Odbiorcę i adres.** Osobę lub firmę z polskim adresem pocztowym.
* **Wiadomość.** Do 300 znaków. Podziały linii są zachowywane. Zobacz [Treść i wygląd kartki](https://docs.paperjoy.co/postcards/write.md).
* **Pismo.** Jeden z dwóch krojów i opcjonalnie naturalną pomyłkę.
* **Podpis.** Wpisany tekst albo Twój [własny podpis](https://docs.paperjoy.co/postcards/custom-signatures.md) w planach Pro i Business.

Resztą zajmuje się Paperjoy: pisaniem, zaadresowaniem koperty z adresem zwrotnym Twojej organizacji, naklejeniem znaczka i nadaniem.

## Co dzieje się po wysłaniu

```mermaid theme={null}
flowchart LR
  A[new] -->|weryfikacja treści| B[queued]
  A -->|treść odrzucona| R[rejected]
  B --> C[w realizacji]
  C --> D[sent]
```

1. **`new`** — Paperjoy przyjmuje zamówienie. Pocztówka live zużywa jeden kredyt.
2. **`queued`** — Wiadomość przeszła automatyczną weryfikację i czeka na wolnego robota.
3. **W realizacji** — Robot adresuje kopertę i pisze kartkę w jednym przebiegu.
4. **`sent`** — Pocztówka jest w drodze.

Jeśli weryfikacja zakwestionuje treść, pocztówka trafia do statusu **`rejected`**, a kredyt wraca automatycznie na Twoje saldo. Wszystkie etapy opisuje strona [Statusy pocztówek](https://docs.paperjoy.co/postcards/statuses.md).

## Zanim zaczniesz

**1. Załóż konto**

[Zarejestruj się](https://paperjoy.co/register) i dodaj swoją organizację. Paperjoy pobierze dane firmy z rejestru na podstawie NIP i użyje tego adresu jako domyślnego adresu zwrotnego.

**2. Wypróbuj tryb testowy**

[Tryb testowy](https://docs.paperjoy.co/getting-started/test-mode.md) jest darmowy. Pocztówki testowe nigdy nie są pisane ani wysyłane.

**3. Kup kredyty i przejdź na live**

Kredyty kupisz w [Rozliczeniach](https://paperjoy.co/billing). Jedna pocztówka live kosztuje jeden kredyt.

> [!NOTE]
>
> Paperjoy dostarcza obecnie pocztówki wyłącznie na adresy w Polsce.


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