Webhooki

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.
Webhooki zamówień Shopify	Przy kanale sprzedaży Shopify	Shopify → Zippendo. Konfiguruje je Zippendo. Zobacz Ustawienia Shopify.
Webhooki zamówień WooCommerce	Przy kanale sprzedaży WooCommerce	WooCommerce → Zippendo. Zobacz Połącz WooCommerce.
Zamówienia z własnego kanału	Przy własnym kanale sprzedaży	Twój system → Zippendo. Zobacz API własnego kanału.

Aby wysyłać zdarzenia do Slack, Klaviyo i podobnych aplikacji bez budowania czegokolwiek, użyj zamiast tego Połącz Slack, Klaviyo i inne aplikacje. Przegląd ustawień: Ustawienia, zespół i marki. Co zawiera każda wiadomość: Szybki start z webhookami. Wiadomości, które nie docierają: Błędy dostarczania webhooków.

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

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.

Karta Webhooki w ustawieniach z jednym webhookiem na liście i przyciskiem Dodaj webhook w nagłówku — Lista Webhooki: nazwa, adres URL, zdarzenia, status i akcje

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. Gdy nie ma jeszcze żadnych webhooków, lista pokazuje Brak webhooków i przycisk Utwórz pierwszy webhook.

Utwórz webhook

Otwórz okno

Kliknij Dodaj webhook albo Utwórz pierwszy webhook, gdy lista jest pusta. Otworzy się okno Utwórz webhook.

Nazwa i adres

Wypełnij Nazwa * i Docelowy adres URL *. Użyj adresu zaczynającego się od https://.

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.

Utwórz

Kliknij Utwórz webhook. Zobaczysz Utworzono webhook.

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.

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.

Okno Edytuj webhook z polami Nazwa, Docelowy adres URL, polem wyboru Aktywna i zdarzeniami — Edytuj webhook: te same pola, plus Aktywna

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.

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:

{
  "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.

Okno Usunąć webhook? z polem do wpisania nazwy w celu potwierdzenia — Usunąć webhook?: wpisz nazwę wielkimi literami, aby potwierdzić

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 (żądanie listy go pomija). Sprawdź podpis, zanim odczytasz treść. Przykład znajdziesz w Szybki start z webhookami. 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.

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

Powiązane

Utwórz token API: Twój system pyta Zippendo, zamiast Zippendo informować Twój system.
Webhooki śledzenia przewoźników: przewoźnicy wysyłający śledzenie do Zippendo.
Połącz Slack, Klaviyo i inne aplikacje: nie potrzebujesz własnego serwera.
Ustawienia Shopify / Połącz WooCommerce: webhooki sklepów, które Zippendo konfiguruje za Ciebie.

Przegląd

Przesyłki

Zamówienia i kanały

Przewoźnicy

Połącz przewoźnika

Połącz integrację

Drukowanie

Automatyzacja

Konto

Wyszukiwanie i panel

API i zdarzenia

Gdzie to znaleźć

Lista Webhooki

Utwórz webhook

Zdarzenia

Edytuj lub wstrzymaj webhook

Dziennik dostarczeń

Wyślij wiadomość testową

Usuń webhook

Dla programistów: format wiadomości i podpis

Powiązane

​Gdzie to znaleźć

​Lista Webhooki

​Utwórz webhook

​Zdarzenia

​Edytuj lub wstrzymaj webhook

​Dziennik dostarczeń

​Wyślij wiadomość testową

​Usuń webhook

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

​Powiązane

Gdzie to znaleźć

Lista Webhooki

Utwórz webhook

Zdarzenia

Edytuj lub wstrzymaj webhook

Dziennik dostarczeń

Wyślij wiadomość testową

Usuń webhook

Dla programistów: format wiadomości i podpis

Powiązane