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

# Błędy dostarczania webhooków

> Co zrobić, gdy webhooki Zippendo nie docierają do Twojego systemu, pokazują błędy w dzienniku dostarczeń albo przychodzą więcej niż raz.

Webhook sprawia, że Zippendo informuje inny system o zdarzeniu, takim jak **Wysłano przesyłkę** lub **Zaktualizowano status śledzenia**. Webhooki konfigurujesz w **Ustawienia** → **Webhooki** (otwórz menu organizacji i kliknij **Zarządzaj**). Dla każdego zdarzenia Zippendo wysyła wiadomość na **Docelowy adres URL**, który wpisałeś.

To nie są webhooki śledzenia przewoźników. O nich przeczytasz w [Webhooki śledzenia przewoźników](/docs/pl/how-to/tracking-webhooks).

## Co widzisz

* Twój system niczego nie otrzymuje.
* **Dziennik dostarczeń** webhooka pokazuje czerwone kody statusu lub tekst w kolumnie **Błąd**.
* Twój system otrzymuje to samo zdarzenie więcej niż raz.

## Najpierw sprawdź dziennik dostarczeń

W **Webhooki** kliknij **Dziennik dostarczeń** przy webhooku. Każdy wiersz to jedna próba, z kolumnami **Zdarzenie**, **Status** (odpowiedź Twojego systemu), **Czas trwania** i ewentualnym **Błąd**.

* **Brak dostarczeń**: Zippendo nie próbowało jeszcze niczego wysłać. Zobacz „Nic nie jest wysyłane” poniżej.
* Zielony status: Twój system odebrał wiadomość. Szukaj problemu we własnym systemie.
* Czerwony status albo **b.d.** z błędem: Twój system nie przyjął wiadomości. Zobacz „Dostarczenia kończą się niepowodzeniem” poniżej.

## Nic nie jest wysyłane

| Prawdopodobna przyczyna | Co zrobić |
| - | - |
| Webhook jest **Nieaktywny** | Kliknij **Edytuj** przy webhooku i włącz **Aktywna**. Nieaktywny webhook niczego nie wysyła i niczego nie zapisuje w dzienniku. **Wyślij test** też niczego nie wysyła, mimo że pokazuje **Wysłano zdarzenie testowe** |
| Zdarzenie nie jest zaznaczone | Kliknij **Edytuj** i sprawdź, czy zdarzenie jest zaznaczone w sekcji **Zdarzenia** |
| Zdarzenie nie nastąpiło | Na przykład **Wysłano przesyłkę** jest wysyłane tylko wtedy, gdy przesyłka faktycznie zostanie wysłana do przewoźnika |

## Dostarczenia kończą się niepowodzeniem

Zippendo uznaje dostarczenie za udane tylko wtedy, gdy Twój system odpowie statusem sukcesu (200-299) w ciągu 10 sekund. W przeciwnym razie próbuje jeszcze kilka razy w ciągu około minuty, łącznie 5 prób. Potem zdarzenie nie jest już wysyłane.

| Co pokazuje dziennik dostarczeń | Prawdopodobna przyczyna | Co zrobić |
| - | - | - |
| 404 | **Docelowy adres URL** jest błędny albo adres zmienił się po Twojej stronie | Popraw **Docelowy adres URL** w **Edytuj** |
| 401 lub 403 | Twój system wymaga hasła lub tokenu albo blokuje nieznanych nadawców | Przepuszczaj wiadomości od Zippendo i sprawdzaj je za pomocą podpisu (zobacz niżej) |
| 500-599 | Twój system uległ awarii podczas obsługi wiadomości | Sprawdź dziennik błędów swojego systemu |
| **b.d.** z błędem przekroczenia czasu | Twój system odpowiadał dłużej niż 10 sekund | Odpowiadaj od razu, a powolną pracę wykonuj potem |
| **b.d.** z błędem połączenia | Adres jest niedostępny z internetu albo jego certyfikat jest nieprawidłowy | Użyj publicznego adresu `https://` z ważnym certyfikatem |

Gdy usuniesz przyczynę, kliknij **Wyślij test** przy webhooku. Zobaczysz **Wysłano zdarzenie testowe**, a w **Dziennik dostarczeń** pojawi się nowy wiersz.

<Note>
  Zippendo nie wysyła ponownie nieudanych zdarzeń później. Jeśli Twój system przez jakiś czas nie działał, wyszukaj pominięte przesyłki lub zamówienia w aplikacji Zippendo albo pobierz je przez API.
</Note>

## Twój system odrzuca podpis

Każda wiadomość ma nagłówek `X-Webhook-Signature`, dzięki któremu Twój system może sprawdzić, że naprawdę pochodzi od Zippendo. To HMAC-SHA256 surowej treści wiadomości, utworzony za pomocą sekretu webhooka. Typowe błędy:

* Podpis jest liczony z wiadomości po jej sparsowaniu i przepisaniu, zamiast z surowej treści dokładnie w takiej postaci, w jakiej została odebrana.
* Używany jest sekret innego webhooka. Każdy webhook ma własny sekret.

Szczegóły i przykłady kodu: [Szybki start z webhookami](/docs/pl/quickstarts/webhooks).

## To samo zdarzenie przychodzi dwa razy

Jeśli Twój system odpowiedział zbyt wolno lub z błędem, Zippendo próbuje ponownie, nawet jeśli Twój system obsłużył pierwszą próbę. Użyj nagłówka `X-Webhook-Id`, aby rozpoznać wiadomość, którą już obsłużyłeś.

Powiązane: [Webhooki](/docs/pl/how-to/webhooks), [Ustawienia webhooków](/docs/pl/settings/webhooks).


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