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

# Webhooki

> Wysyłaj zdarzenia przesyłek, zamówień i śledzenia z Zippendo do własnego systemu - nazwa, docelowy adres URL, zdarzenia, dziennik dostarczeń, wiadomość testowa, edycja, usuwanie i sprawdzanie podpisu.

**Webhooki** informują Twój system w chwili, gdy w Zippendo coś się dzieje: przesyłka zostaje utworzona lub wysłana, zamówienie się zmienia albo paczka dostaje nowe zdarzenie śledzenia. Zippendo wysyła wiadomość na adres (URL) na Twoim serwerze. Konfigurujesz je w sekcji **Webhooki** w ustawieniach, a stronę odbierającą zwykle buduje programista.

To nie są inne rodzaje webhooków, które możesz spotkać w Zippendo:

| Rodzaj | Gdzie | Kierunek |
| - | - | - |
| **Webhooki** (ta strona) | Ustawienia → **Webhooki** | Zippendo → Twój serwer |
| Webhooki śledzenia przewoźników | Przy przewoźniku | Przewoźnik → Zippendo. Zobacz [Webhooki śledzenia przewoźników](/docs/pl/how-to/tracking-webhooks). |
| Webhooki zamówień Shopify | Przy kanale sprzedaży Shopify | Shopify → Zippendo. Konfiguruje je Zippendo. Zobacz [Ustawienia Shopify](/docs/pl/how-to/shopify-settings). |
| Webhooki zamówień WooCommerce | Przy kanale sprzedaży WooCommerce | WooCommerce → Zippendo. Zobacz [Połącz WooCommerce](/docs/pl/how-to/connect-woocommerce). |
| Zamówienia z własnego kanału | Przy własnym kanale sprzedaży | Twój system → Zippendo. Zobacz [API własnego kanału](/docs/pl/how-to/custom-channel-api). |

Aby wysyłać zdarzenia do Slack, Klaviyo i podobnych aplikacji bez budowania czegokolwiek, użyj zamiast tego [Połącz Slack, Klaviyo i inne aplikacje](/docs/pl/how-to/connect-an-integration).

Przegląd ustawień: [Ustawienia, zespół i marki](/docs/pl/tutorials/settings-team-brands). Co zawiera każda wiadomość: [Szybki start z webhookami](/docs/pl/quickstarts/webhooks). Wiadomości, które nie docierają: [Błędy dostarczania webhooków](/docs/pl/knowledge-base/webhook-delivery-failures).

<Info>
  Webhooki są wliczone w każdy plan: Free do 5 webhooków, Standard do 10, Growth do 25, Pro do 100, Enterprise bez limitu.
</Info>

## Gdzie to znaleźć

Otwórz menu organizacji na dole menu bocznego, kliknij **Zarządzaj**, a potem kartę **Webhooki**. Przycisk do utworzenia webhooka to **Dodaj webhook** w prawym górnym rogu.

<Frame caption="Lista Webhooki: nazwa, adres URL, zdarzenia, status i akcje">
  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/01-webhooks-list-light.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=2568e58fcdde2e94cae89028d6fa5001" alt="Karta Webhooki w ustawieniach z jednym webhookiem na liście i przyciskiem Dodaj webhook w nagłówku" className="block dark:hidden" width="2880" height="1800" data-path="images/pl/how-to/webhooks/01-webhooks-list-light.png" />

  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/01-webhooks-list-dark.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=e612035ef5797f02f52de1a5a733bad9" alt="Karta Webhooki w ustawieniach z jednym webhookiem na liście i przyciskiem Dodaj webhook w nagłówku" className="hidden dark:block" width="2880" height="1800" data-path="images/pl/how-to/webhooks/01-webhooks-list-dark.png" />
</Frame>

## Lista Webhooki

| Kolumna | Co pokazuje |
| - | - |
| **Nazwa** | Wpisaną przez Ciebie nazwę. |
| **Marka** | Markę webhooka albo puste, jeśli obejmuje całą organizację. Widoczne tylko wtedy, gdy Twoja organizacja ma marki. |
| **Adres URL** | Adres, na który Zippendo wysyła wiadomości. |
| **Zdarzenia** | Pierwsze dwa wysyłane zdarzenia, na przykład **Utworzono przesyłkę**; pozostałe są zwinięte. |
| **Status** | **Aktywna** lub **Nieaktywny**. |
| **Utworzono** | Kiedy został utworzony. |

Każdy wiersz ma **Dziennik dostarczeń**, **Wyślij test**, **Edytuj** i **Usuń**. Kliknięcie wiersza otwiera **Edytuj webhook**.

Aby znaleźć webhook, kliknij **Filtry** nad listą. Możesz szukać po nazwie, wybrać **Aktywna** (**Tak** lub **Nie**) i, jeśli masz marki, **Marka**. Kliknij **Dodaj filtry**, aby je zastosować. Więcej o listach: [Wyszukiwanie i filtry](/docs/pl/how-to/search-and-filters).

Gdy nie ma jeszcze żadnych webhooków, lista pokazuje **Brak webhooków** i przycisk **Utwórz pierwszy webhook**.

## Utwórz webhook

<Steps>
  <Step title="Otwórz okno">
    Kliknij **Dodaj webhook** albo **Utwórz pierwszy webhook**, gdy lista jest pusta. Otworzy się okno **Utwórz webhook**.
  </Step>

  <Step title="Nazwa i adres">
    Wypełnij **Nazwa \*** i **Docelowy adres URL \***. Użyj adresu zaczynającego się od `https://`.
  </Step>

  <Step title="Wybierz zdarzenia">
    Zaznacz zdarzenia, które chcesz, albo kliknij **Zaznacz wszystkie**. Zaznacz **Zaktualizowano status śledzenia**, jeśli Twój system potrzebuje każdego skanu śledzenia.
  </Step>

  <Step title="Utwórz">
    Kliknij **Utwórz webhook**. Zobaczysz **Utworzono webhook**.
  </Step>
</Steps>

<Frame caption="Utwórz webhook: Nazwa, Docelowy adres URL i zdarzenia">
  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/02-create-webhook-light.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=04285f94ec585be9866edded85bdd4e8" alt="Okno Utwórz webhook z polami Nazwa, Docelowy adres URL, Zaznacz wszystkie i polami wyboru zdarzeń przesyłek" className="block dark:hidden" width="2880" height="2800" data-path="images/pl/how-to/webhooks/02-create-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/02-create-webhook-dark.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=b95040ebc4e673f62e554fe61c67b18f" alt="Okno Utwórz webhook z polami Nazwa, Docelowy adres URL, Zaznacz wszystkie i polami wyboru zdarzeń przesyłek" className="hidden dark:block" width="2880" height="2800" data-path="images/pl/how-to/webhooks/02-create-webhook-dark.png" />
</Frame>

| Pole | Wymagane | Co wpisać |
| - | - | - |
| **Nazwa \*** | Tak | Nazwa, którą rozpoznasz, na przykład „Powiadomienia o zamówieniach”. Do 100 znaków. |
| **Docelowy adres URL \*** | Tak | Pełny adres na Twoim serwerze, na przykład `https://example.com/webhooks`. |
| **Marka** | Nie | Widoczne tylko wtedy, gdy Twoja organizacja ma marki. Wybierz markę, a **Ten webhook otrzymuje tylko zdarzenia tej marki.** Wartość domyślna, **Brak marki (cała organizacja)**, otrzymuje zdarzenia każdej marki. |
| **Zdarzenia \*** | Tak, co najmniej jedno | Zdarzenia do wysyłania. Zobacz listę poniżej. |

**Utwórz webhook** jest wyszarzony, dopóki nie wpiszesz nazwy, adresu i nie wybierzesz co najmniej jednego zdarzenia. Jeśli tworzenie się nie uda i zobaczysz **Osiągnięto limit Twojego planu. Zmień plan albo usuń coś, czego już nie używasz.**, usuń webhook, którego już nie używasz, albo zmień plan.

### Zdarzenia

Jest dziewięć zdarzeń w trzech grupach. Nazwa techniczna w drugiej kolumnie to to, co otrzymuje Twój system.

<Frame caption="Zaznacz wszystkie zaznacza każde zdarzenie, w tym Zaktualizowano status śledzenia">
  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/03-events-tracking-light.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=ff4688f242b0c2066370bb8f7bfbe8d5" alt="Okno Utwórz webhook ze wszystkimi dziewięcioma zaznaczonymi zdarzeniami, w tym Zaktualizowano status śledzenia" className="block dark:hidden" width="2880" height="2800" data-path="images/pl/how-to/webhooks/03-events-tracking-light.png" />

  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/03-events-tracking-dark.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=fc962f2e4c658463706122a30842324f" alt="Okno Utwórz webhook ze wszystkimi dziewięcioma zaznaczonymi zdarzeniami, w tym Zaktualizowano status śledzenia" className="hidden dark:block" width="2880" height="2800" data-path="images/pl/how-to/webhooks/03-events-tracking-dark.png" />
</Frame>

| Zdarzenie | Nazwa, którą otrzymuje Twój system | Wysyłane, gdy |
| - | - | - |
| **Utworzono przesyłkę** | `shipment.created` | Przesyłka zostanie utworzona. |
| **Zaktualizowano przesyłkę** | `shipment.updated` | Przesyłka zostanie zmieniona. |
| **Wysłano przesyłkę** | `shipment.dispatched` | Przesyłka zostanie wysłana i ma etykietę. |
| **Anulowano przesyłkę** | `shipment.cancelled` | Przesyłka zostanie usunięta. |
| **Błąd przesyłki** | `shipment.error` | Wysyłanie przesyłki do przewoźnika się nie powiedzie. |
| **Utworzono zamówienie** | `order.created` | Zamówienie zostanie utworzone przez API. |
| **Zaktualizowano zamówienie** | `order.updated` | Zamówienie zostanie zmienione w Zippendo lub przez API. |
| **Anulowano zamówienie** | `order.cancelled` | Zamówienie zostanie usunięte w Zippendo lub przez API. |
| **Zaktualizowano status śledzenia** | `tracking.updated` | Paczka dostanie nowe zdarzenie śledzenia. |

Zamówienia, które napływają z połączonego sklepu internetowego, i zmiany, które sklep przysyła później, nie wysyłają zdarzeń zamówień. Twój system nadal dowie się o nich przez zdarzenia przesyłek: Zippendo tworzy przesyłkę dla każdego importowanego zamówienia.

**Wyślij test** wysyła wiadomość testową o nazwie `webhook.test`. Nie możesz zaznaczyć jej jako zdarzenia.

## Edytuj lub wstrzymaj webhook

Kliknij wiersz albo **Edytuj**, aby otworzyć **Edytuj webhook**. Ma te same pola co **Utwórz webhook**, plus **Aktywna**. Gdy skończysz, kliknij **Zapisz zmiany**.

<Frame caption="Edytuj webhook: te same pola, plus Aktywna">
  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/04-edit-webhook-light.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=d78918cef05f1e2c091ccd1889c5a4ff" alt="Okno Edytuj webhook z polami Nazwa, Docelowy adres URL, polem wyboru Aktywna i zdarzeniami" className="block dark:hidden" width="2880" height="1800" data-path="images/pl/how-to/webhooks/04-edit-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/04-edit-webhook-dark.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=0d93fd9cbb5b4b2c59010acbb396bdf2" alt="Okno Edytuj webhook z polami Nazwa, Docelowy adres URL, polem wyboru Aktywna i zdarzeniami" className="hidden dark:block" width="2880" height="1800" data-path="images/pl/how-to/webhooks/04-edit-webhook-dark.png" />
</Frame>

Odznacz **Aktywna**, aby przestać wysyłać bez usuwania webhooka ani jego **Dziennik dostarczeń**. Kolumna **Status** pokazuje wtedy **Nieaktywny**. Zaznacz ją ponownie, aby zacząć wysyłać.

## Dziennik dostarczeń

**Dziennik dostarczeń** w wierszu pokazuje ostatnie próby dostarczenia na ten adres.

<Frame caption="Dziennik dostarczeń: zdarzenie, status, czas trwania, próba, błąd i czas">
  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/05-delivery-log-light.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=b43c082b59a5b8ba4fb4e81d314eca24" alt="Dziennik dostarczeń z nazwami zdarzeń, statusem odpowiedzi, czasem trwania, próbą i czasem" className="block dark:hidden" width="2880" height="1800" data-path="images/pl/how-to/webhooks/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/05-delivery-log-dark.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=fa87722004763e96f5d2307a7663e502" alt="Dziennik dostarczeń z nazwami zdarzeń, statusem odpowiedzi, czasem trwania, próbą i czasem" className="hidden dark:block" width="2880" height="1800" data-path="images/pl/how-to/webhooks/05-delivery-log-dark.png" />
</Frame>

| Kolumna | Co pokazuje |
| - | - |
| **Zdarzenie** | Wysłane zdarzenie, takie jak `shipment.created` lub `webhook.test`. |
| **Status** | Kod statusu, którym odpowiedział Twój serwer, zielony przy sukcesie i czerwony przy niepowodzeniu, albo **b.d.**, jeśli nie było odpowiedzi. |
| **Czas trwania** | Jak długo Twój serwer odpowiadał. |
| **Próba** | Która to była próba. |
| **Błąd** | Co poszło nie tak, jeśli cokolwiek. |
| **Czas** | Kiedy podjęto próbę. |

Zippendo czeka do 10 sekund na odpowiedź Twojego serwera. Jeśli nie odpowie albo odpowie błędem, Zippendo próbuje ponownie, łącznie do 5 razy, za każdym razem czekając trochę dłużej. Każda próba to wiersz w dzienniku.

## Wyślij wiadomość testową

Kliknij **Wyślij test** w wierszu. Zobaczysz **Wysłano zdarzenie testowe**. Wiadomość testowa wygląda tak:

```json theme={null}
{
  "event": "webhook.test",
  "timestamp": "2026-06-22T09:30:00.000Z",
  "data": {
    "webhookId": "cm9x2k4lq0001",
    "message": "This is a test event from Zippendo"
  }
}
```

Otwórz **Dziennik dostarczeń**, aby zobaczyć, czy Twój serwer ją odebrał.

## Usuń webhook

Kliknij **Usuń** w wierszu. **Usunąć webhook?** prosi o wpisanie nazwy webhooka wielkimi literami, a potem kliknij **Usuń**. Webhook i jego **Dziennik dostarczeń** zostają usunięte, a Ty zobaczysz **Usunięto webhook**.

<Frame caption="Usunąć webhook?: wpisz nazwę wielkimi literami, aby potwierdzić">
  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/06-delete-webhook-light.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=0a7165e8437dce708e889589ef6981d1" alt="Okno Usunąć webhook? z polem do wpisania nazwy w celu potwierdzenia" className="block dark:hidden" width="2880" height="1800" data-path="images/pl/how-to/webhooks/06-delete-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/LEwaKXvNHWw-jIs2/images/pl/how-to/webhooks/06-delete-webhook-dark.png?fit=max&auto=format&n=LEwaKXvNHWw-jIs2&q=85&s=2c4a3f3736e84b644974a632c5c9cd0d" alt="Okno Usunąć webhook? z polem do wpisania nazwy w celu potwierdzenia" className="hidden dark:block" width="2880" height="1800" data-path="images/pl/how-to/webhooks/06-delete-webhook-dark.png" />
</Frame>

## Dla programistów: format wiadomości i podpis

Każda wiadomość to `POST` z treścią JSON `{ "event", "timestamp", "brandId", "data" }` i tymi nagłówkami:

| Nagłówek | Wartość |
| - | - |
| `Content-Type` | `application/json` |
| `X-Webhook-Signature` | HMAC-SHA256 surowej treści, szesnastkowo, z kluczem w postaci sekretu webhooka |
| `X-Webhook-Event` | Nazwa zdarzenia |
| `X-Webhook-Id` | Jeden ID na dostarczenie. Każda ponowna próba tego samego dostarczenia wysyła ten sam ID, więc możesz go użyć do pomijania duplikatów. |

Zippendo tworzy sekret podczas tworzenia webhooka. Aplikacja go nie pokazuje: odczytaj go żądaniem Get webhook w [dokumentacji API](/docs/api-reference/overview) (żądanie listy go pomija). Sprawdź podpis, zanim odczytasz treść. Przykład znajdziesz w [Szybki start z webhookami](/docs/pl/quickstarts/webhooks). Zamówienia wysyłane do własnego kanału sprzedaży są podpisywane tak samo, nagłówkiem `X-Zippendo-Signature`: [API własnego kanału](/docs/pl/how-to/custom-channel-api).

<Tip>
  Odpowiadaj szybko statusem 2xx, a pracę wykonuj potem. Używaj adresów `https://`. Webhooki, które nie są **Aktywna**, niczego nie otrzymują.
</Tip>

## Powiązane

* [Utwórz token API](/docs/pl/how-to/create-an-api-token): Twój system pyta Zippendo, zamiast Zippendo informować Twój system.
* [Webhooki śledzenia przewoźników](/docs/pl/how-to/tracking-webhooks): przewoźnicy wysyłający śledzenie do Zippendo.
* [Połącz Slack, Klaviyo i inne aplikacje](/docs/pl/how-to/connect-an-integration): nie potrzebujesz własnego serwera.
* [Ustawienia Shopify](/docs/pl/how-to/shopify-settings) / [Połącz WooCommerce](/docs/pl/how-to/connect-woocommerce): webhooki sklepów, które Zippendo konfiguruje za Ciebie.


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