{"id":18174,"date":"2026-11-18T11:51:44","date_gmt":"2026-11-18T10:51:44","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=ecdp&#038;p=18174"},"modified":"2026-11-18T11:51:47","modified_gmt":"2026-11-18T10:51:47","slug":"webhooki","status":"publish","type":"ecdp","link":"https:\/\/help.expertsender.com\/pl\/ecdp\/webhooki\/","title":{"rendered":"Webhooki"},"content":{"rendered":"<p>Webhooki wysy\u0142aj\u0105 zdarzenia dotycz\u0105ce Twoich klient\u00f3w z ECDP do Twojego systemu zaraz po tym, jak si\u0119 wydarz\u0105. Dzi\u0119ki nim mo\u017cesz na bie\u017c\u0105co synchronizowa\u0107 zgody z w\u0142asnym CRM lub ERP albo \u015bledzi\u0107 dostarczenia, otwarcia i klikni\u0119cia wiadomo\u015bci, bez cyklicznego odpytywania API.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"zdarzenia-ktore-mozesz-wysylac\">Zdarzenia, kt\u00f3re mo\u017cesz wysy\u0142a\u0107<\/h2>\n\n\n<p>Ka\u017cdy webhook wysy\u0142a jeden typ zdarzenia. Wybierz kategori\u0119, a potem typ zdarzenia z tej kategorii:<\/p>\n\n<ul>\n  <li><strong>Zgody<\/strong> \u2013 Zgoda udzielona, Zgoda oczekuje na potwierdzenie, Zgoda potwierdzona, Zgoda wycofana.<\/li>\n  <li><strong>E-mail<\/strong> \u2013 Wys\u0142anie, Dostarczenie, Odbicie, Skarga, Otwarcie, Klikni\u0119cie.<\/li>\n  <li><strong>SMS<\/strong> \u2013 Wys\u0142anie, Odbicie, Klikni\u0119cie.<\/li>\n  <li><strong>Web push<\/strong> \u2013 Wys\u0142anie, Wy\u015bwietlenie, Klikni\u0119cie.<\/li>\n  <li><strong>Mobile push<\/strong> \u2013 Wys\u0142anie, Wy\u015bwietlenie, Klikni\u0119cie.<\/li>\n<\/ul>\n\n<p>Je\u015bli jedna operacja zmienia kilka zg\u00f3d klienta naraz, ECDP wysy\u0142a osobne \u017c\u0105danie dla ka\u017cdej zmienionej zgody. Co zawiera ka\u017cde \u017c\u0105danie, sprawdzisz w sekcji <a href=\"#payloady-webhookow\">Payloady webhook\u00f3w<\/a>.<\/p>\n\n<p><strong>Kiedy ECDP wysy\u0142a zdarzenia zg\u00f3d.<\/strong> ECDP wysy\u0142a zdarzenie zgody, gdy zgoda klienta zmienia si\u0119, bo:<\/p>\n\n<ul>\n  <li>klient wysy\u0142a formularz na stronie albo powstaje na Twojej stronie dzi\u0119ki skryptowi web tracking. Zgoda single opt-in wysy\u0142a <strong>Zgod\u0119 udzielon\u0105<\/strong>. Zgoda double opt-in wysy\u0142a <strong>Zgod\u0119 oczekuj\u0105c\u0105 na potwierdzenie<\/strong>.<\/li>\n  <li>klient klika link potwierdzaj\u0105cy w e-mailu double opt-in. ECDP wysy\u0142a <strong>Zgod\u0119 potwierdzon\u0105<\/strong>.<\/li>\n  <li>dodajesz, aktualizujesz lub usuwasz klienta przez API, w panelu ECDP albo w centrum preferencji. ECDP wysy\u0142a <strong>Zgod\u0119 udzielon\u0105<\/strong>, <strong>Zgod\u0119 oczekuj\u0105c\u0105 na potwierdzenie<\/strong> lub <strong>Zgod\u0119 wycofan\u0105<\/strong> dla ka\u017cdej zmienionej zgody.<\/li>\n  <li>klient wypisuje si\u0119 linkiem w e-mailu lub SMS-ie albo z wiadomo\u015bci web push, albo jego zgody wycofuje skarga na spam. ECDP wysy\u0142a <strong>Zgod\u0119 wycofan\u0105<\/strong>.<\/li>\n  <li>klient subskrybuje web push albo rejestrowane jest urz\u0105dzenie mobilne. ECDP wysy\u0142a <strong>Zgod\u0119 udzielon\u0105<\/strong>.<\/li>\n<\/ul>\n\n<p>ECDP nie wysy\u0142a zdarze\u0144 zg\u00f3d przy imporcie klient\u00f3w, akcjach masowych w panelu ani akcjach scenariusza ustawiaj\u0105cych dane klienta.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"tworzenie-webhooka\">Tworzenie webhooka<\/h2>\n\n\n<ol>\n  <li>Przejd\u017a do <strong>Ustawienia<\/strong> > <strong>Webhooki<\/strong>.<\/li>\n  <li>Na zak\u0142adce <strong>Webhooki<\/strong> kliknij <strong>Stw\u00f3rz webhook<\/strong>.<\/li>\n  <li>Wpisz <strong>Nazw\u0119<\/strong>.<\/li>\n  <li>Wybierz <strong>Kategori\u0119<\/strong> i <strong>Typ zdarzenia<\/strong>.<\/li>\n  <li>Je\u015bli wybierzesz kategori\u0119 <strong>Zgody<\/strong>, w polu <strong>Ogranicz do wybranych zg\u00f3d<\/strong> mo\u017cesz wskaza\u0107 jedn\u0105 lub kilka zg\u00f3d. Je\u015bli zostawisz je puste, webhook uruchamia si\u0119 dla wszystkich zg\u00f3d w jednostce biznesowej.<\/li>\n  <li>W polu <strong>Adres docelowy<\/strong> wpisz adres, na kt\u00f3ry maj\u0105 trafia\u0107 zdarzenia. Musi zaczyna\u0107 si\u0119 od <strong>https:\/\/<\/strong>.<\/li>\n  <li>Je\u015bli Tw\u00f3j system wymaga uwierzytelniania, wype\u0142nij dwa ostatnie pola: nazw\u0119 nag\u0142\u00f3wka uwierzytelniaj\u0105cego i jego warto\u015b\u0107. Nazwa jest domy\u015blnie wype\u0142niona jako <strong>ApiKey<\/strong>. Mo\u017cesz j\u0105 zmieni\u0107, \u017ceby pasowa\u0142a do Twojego systemu, np. na <strong>Authorization<\/strong> albo <strong>X-API-KEY<\/strong>. ECDP do\u0142\u0105cza ten nag\u0142\u00f3wek do ka\u017cdego \u017c\u0105dania, tak\u017ce testowego.<\/li>\n  <li>Kliknij <strong>Sprawd\u017a po\u0142\u0105czenie<\/strong>. ECDP wy\u015ble na Tw\u00f3j adres \u017c\u0105danie testowe. Wynik pojawi si\u0119 obok przycisku.<\/li>\n  <li>Gdy test si\u0119 powiedzie, kliknij <strong>Aktywuj<\/strong>. Webhook zaczyna dzia\u0142a\u0107 od razu.<\/li>\n<\/ol>\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img decoding=\"async\" src=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2026\/11\/webhook-form.pl_.png\" alt=\"Formularz Stw\u00f3rz webhook z wybran\u0105 kategori\u0105 Zgody: pola Nazwa, Kategoria, Typ zdarzenia, Ogranicz do wybranych zg\u00f3d, Adres docelowy i nag\u0142\u00f3wek uwierzytelniaj\u0105cy oraz przyciski Sprawd\u017a po\u0142\u0105czenie i Aktywuj.\" style=\"width:520px\"\/><\/figure>\n\n\n<p><strong>Wskaz\u00f3wka:<\/strong> Nie zapiszesz webhooka, dop\u00f3ki test po\u0142\u0105czenia si\u0119 nie powiedzie. Do tego czasu podpowied\u017a pod przyciskami m\u00f3wi, co zrobi\u0107.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"jak-dziala-test-polaczenia\">Jak dzia\u0142a test po\u0142\u0105czenia<\/h2>\n\n\n<ul>\n  <li>\u017b\u0105danie testowe zawiera pola wybranego zdarzenia wype\u0142nione przyk\u0142adowymi danymi, np. ID klienta 123 i adres z example.com. Nigdy nie zawiera danych prawdziwych klient\u00f3w. Niekt\u00f3re pola mog\u0105 si\u0119 nieznacznie r\u00f3\u017cni\u0107 od prawdziwego \u017c\u0105dania, wi\u0119c jako wzorca u\u017cywaj sekcji <a href=\"#payloady-webhookow\">Payloady webhook\u00f3w<\/a>.<\/li>\n  <li>Test ko\u0144czy si\u0119 sukcesem, gdy Tw\u00f3j system odpowie kodem <strong>2xx<\/strong> lub <strong>4xx<\/strong>, bo adres jest osi\u0105galny. Przy <strong>4xx<\/strong> wynik pokazuje kod i odpowied\u017a, wi\u0119c widzisz, \u017ce Tw\u00f3j system odrzuci\u0142 dane testowe.<\/li>\n  <li>Test ko\u0144czy si\u0119 niepowodzeniem, gdy Tw\u00f3j system odpowie kodem <strong>3xx<\/strong> lub <strong>5xx<\/strong>, nie odpowie w wyznaczonym czasie albo nie uda si\u0119 po\u0142\u0105czy\u0107.<\/li>\n  <li>Test nie jest dostarczeniem. Nie pojawia si\u0119 w logach i nie zmienia wyniku ani daty ostatniego \u017c\u0105dania na li\u015bcie webhook\u00f3w.<\/li>\n<\/ul>\n\n\n<h2 class=\"wp-block-heading\" id=\"zarzadzanie-webhookami\">Zarz\u0105dzanie webhookami<\/h2>\n\n\n<p>Zak\u0142adka <strong>Webhooki<\/strong> pokazuje list\u0119 Twoich webhook\u00f3w: nazw\u0119, status, typ zdarzenia, wynik i dat\u0119 ostatniego \u017c\u0105dania oraz dat\u0119 ostatniej edycji. Wynik i data pokazuj\u0105 ostatnie zako\u0144czone dostarczenie, po wszystkich ponowieniach. Zanim webhook wy\u015ble pierwsze \u017c\u0105danie, w kolumnie wyniku widzisz my\u015blnik.<\/p>\n\n<ul>\n  <li><strong>Aktywny<\/strong> \u2013 webhook dostarcza zdarzenia. Mo\u017cesz go dezaktywowa\u0107, edytowa\u0107 albo otworzy\u0107 jego logi.<\/li>\n  <li><strong>Nieaktywny<\/strong> \u2013 webhook nie dostarcza zdarze\u0144. Mo\u017cesz go aktywowa\u0107, edytowa\u0107, usun\u0105\u0107 albo otworzy\u0107 jego logi.<\/li>\n  <li><strong>Usuni\u0119ty<\/strong> \u2013 domy\u015blnie ukryty. Zaznacz <strong>Poka\u017c usuni\u0119te webhooki<\/strong> nad tabel\u0105, \u017ceby go zobaczy\u0107. Mo\u017cesz go przywr\u00f3ci\u0107 albo otworzy\u0107 jego logi.<\/li>\n<\/ul>\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img decoding=\"async\" src=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2026\/11\/webhook-list.pl_-scaled.png\" alt=\"Lista webhook\u00f3w z zaznaczon\u0105 opcj\u0105 Poka\u017c usuni\u0119te webhooki: webhook usuni\u0119ty, nieaktywny i aktywny wraz ze statusem, typem zdarzenia, wynikiem i dat\u0105 ostatniego \u017c\u0105dania, dat\u0105 ostatniej edycji i akcjami w wierszu.\" style=\"width:720px\"\/><\/figure>\n\n\n<p>Najed\u017a na ikon\u0119 w wierszu, \u017ceby zobaczy\u0107 jej nazw\u0119, np. <strong>Dezaktywuj<\/strong>, <strong>Edytuj<\/strong> albo <strong>Zobacz logi<\/strong>. \u017beby usun\u0105\u0107 webhook, kliknij ikon\u0119 usuwania i potwierd\u017a w oknie, kt\u00f3re si\u0119 otworzy.<\/p>\n\n<p><strong>Edycja:<\/strong> webhook mo\u017cesz edytowa\u0107 w ka\u017cdym statusie. \u017beby zapisa\u0107 zmiany, sprawd\u017a po\u0142\u0105czenie ponownie i kliknij <strong>Zaktualizuj<\/strong>. Webhook dzia\u0142a bez przerwy w trakcie edycji, a jego status si\u0119 nie zmienia.<\/p>\n\n<p><strong>Limit aktywnych webhook\u00f3w:<\/strong> mo\u017cesz mie\u0107 kilka webhook\u00f3w dla tego samego zdarzenia, np. \u017ceby wys\u0142a\u0107 je do kilku system\u00f3w. Domy\u015blnie mo\u017cesz mie\u0107 do 4 aktywnych webhook\u00f3w dla tego samego typu zdarzenia. Je\u015bli utworzenie lub aktywacja webhooka przekroczy\u0142aby limit, ECDP poka\u017ce komunikat o osi\u0105gni\u0119ciu limitu i nie zapisze ani nie aktywuje webhooka. Limit obowi\u0105zuje te\u017c wtedy, gdy zmieniasz typ zdarzenia aktywnego webhooka. Przywr\u00f3cony webhook jest nieaktywny, wi\u0119c ECDP sprawdza limit dopiero przy jego aktywacji. Dezaktywuj albo usu\u0144 webhook, kt\u00f3rego nie potrzebujesz, i spr\u00f3buj ponownie.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"jak-dziala-dostarczanie\">Jak dzia\u0142a dostarczanie<\/h2>\n\n\n<ul>\n  <li>ECDP wysy\u0142a ka\u017cde zdarzenie jako \u017c\u0105danie na Tw\u00f3j adres docelowy kr\u00f3tko po tym, jak si\u0119 wydarzy. Nie gwarantuje natychmiastowego dostarczenia. Przy du\u017cej liczbie zdarze\u0144, np. podczas du\u017cej kampanii, webhooki mog\u0105 dociera\u0107 z op\u00f3\u017anieniem.<\/li>\n  <li>Jedno zdarzenie tworzy jedno dostarczenie dla ka\u017cdego aktywnego webhooka skonfigurowanego dla tego zdarzenia, bez duplikat\u00f3w. Je\u015bli w jednostce biznesowej nie ma aktywnego webhooka dla danego typu zdarzenia, ECDP niczego nie wysy\u0142a.<\/li>\n  <li>Dostarczenie udaje si\u0119 tylko wtedy, gdy Tw\u00f3j system odpowie kodem <strong>2xx<\/strong>.<\/li>\n  <li>Je\u015bli Tw\u00f3j system odpowie kodem <strong>3xx<\/strong>, pr\u00f3ba ko\u0144czy si\u0119 niepowodzeniem, a ECDP nie pod\u0105\u017ca za przekierowaniem i nie ponawia pr\u00f3by.<\/li>\n  <li>Je\u015bli Tw\u00f3j system odpowie kodem <strong>4xx<\/strong> innym ni\u017c 408 i 429, odrzuci\u0142 dane. Pr\u00f3ba ko\u0144czy si\u0119 niepowodzeniem, a ECDP nie ponawia jej.<\/li>\n  <li>Je\u015bli Tw\u00f3j system odpowie kodem <strong>5xx<\/strong>, <strong>408<\/strong> lub <strong>429<\/strong>, nie odpowie w wyznaczonym czasie albo nie uda si\u0119 po\u0142\u0105czy\u0107, ECDP ponawia pr\u00f3b\u0119 od razu, bez przerwy mi\u0119dzy pr\u00f3bami, do limitu ponowie\u0144 ustawionego dla Twojej jednostki biznesowej. Limit ponowie\u0144 liczy powt\u00f3rzenia po pierwszym \u017c\u0105daniu, wi\u0119c limit 2 oznacza maksymalnie 3 \u017c\u0105dania \u0142\u0105cznie.<\/li>\n  <li>Po ostatniej pr\u00f3bie zdarzenie jest oznaczone w logach jako nieudane. ECDP nie ponawia go ju\u017c p\u00f3\u017aniej.<\/li>\n  <li>ECDP nigdy sam nie dezaktywuje webhooka, nawet gdy dostarczenia stale si\u0119 nie udaj\u0105. Sprawdzaj wynik ostatniego \u017c\u0105dania na li\u015bcie i logi.<\/li>\n  <li>ECDP wysy\u0142a \u017c\u0105dania tylko na publiczne adresy <strong>https:\/\/<\/strong>. Nie dotrze do adres\u00f3w w sieci prywatnej.<\/li>\n  <li>Wszystkie daty w \u017c\u0105daniach s\u0105 w strefie czasowej Twojej jednostki biznesowej, w formacie ISO 8601 z przesuni\u0119ciem wzgl\u0119dem UTC.<\/li>\n<\/ul>\n\n\n<h2 class=\"wp-block-heading\" id=\"ustawienia-webhookow-dla-jednostki-biznesowej\">Ustawienia webhook\u00f3w dla jednostki biznesowej<\/h2>\n\n\n<p>Na zak\u0142adce <strong>Ustawienia<\/strong> w <strong>Ustawienia<\/strong> > <strong>Webhooki<\/strong> ustawiasz warto\u015bci obowi\u0105zuj\u0105ce wszystkie webhooki w jednostce biznesowej:<\/p>\n\n<ul>\n  <li><strong>Limit czasu odpowiedzi (ms)<\/strong> \u2013 jak d\u0142ugo ECDP czeka na odpowied\u017a na ka\u017cde \u017c\u0105danie. Je\u015bli Tw\u00f3j system nie odpowie w tym czasie, pr\u00f3ba jest liczona jako nieudana. Mo\u017cesz wpisa\u0107 warto\u015b\u0107 od 100 do 10 000. Domy\u015blnie to 3 000.<\/li>\n  <li><strong>Limit ponowie\u0144<\/strong> \u2013 ile razy ECDP powtarza nieudane dostarczenie po pierwszym \u017c\u0105daniu. Mo\u017cesz wpisa\u0107 warto\u015b\u0107 od 0 do 5. Przy 0 ECDP nie ponawia. Domy\u015blnie to 2, czyli maksymalnie 3 \u017c\u0105dania \u0142\u0105cznie.<\/li>\n  <li><strong>Przechowywanie log\u00f3w (dni)<\/strong> \u2013 jak d\u0142ugo przechowywane s\u0105 wpisy w logu webhook\u00f3w. Mo\u017cesz wpisa\u0107 warto\u015b\u0107 od 1 do 90. Domy\u015blnie to 30.<\/li>\n<\/ul>\n\n<p>Gdy sko\u0144czysz, kliknij <strong>Zapisz<\/strong>.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"sprawdzanie-dostarczen-w-logach\">Sprawdzanie dostarcze\u0144 w logach<\/h2>\n\n\n<p>Przejd\u017a do <strong>Ustawienia<\/strong> > <strong>Logi<\/strong> i otw\u00f3rz zak\u0142adk\u0119 <strong>Webhooki<\/strong>. Mo\u017cesz te\u017c klikn\u0105\u0107 <strong>Zobacz logi<\/strong> w wierszu webhooka. ECDP otworzy t\u0119 zak\u0142adk\u0119 z kolumn\u0105 <strong>Webhook<\/strong> ju\u017c przefiltrowan\u0105 do tego webhooka.<\/p>\n\n<p>Tabela pokazuje <strong>Wynik<\/strong> (<strong>Udane<\/strong> albo <strong>Nieudane<\/strong>), <strong>ID<\/strong>, <strong>Webhook<\/strong>, dat\u0119 i godzin\u0119 utworzenia wpisu (<strong>Utworzono<\/strong>) i <strong>Liczb\u0119 pr\u00f3b<\/strong>. Jedno dostarczenie to jeden wpis, niezale\u017cnie od tego, ile razy ECDP musia\u0142 je ponawia\u0107. <strong>Liczba pr\u00f3b<\/strong> pokazuje, ile \u017c\u0105da\u0144 by\u0142o potrzebnych, a wpis pokazuje wynik ostatniej pr\u00f3by. Zdarzenie dostarczone za trzecim razem to jeden wpis z 3 pr\u00f3bami. W logach s\u0105 tylko dostarczenia zdarze\u0144, bez test\u00f3w po\u0142\u0105czenia. Najnowsze wpisy s\u0105 na g\u00f3rze, a filtrowa\u0107 mo\u017cesz po ka\u017cdej kolumnie.<\/p>\n\n\n<p>Kliknij ikon\u0119 oka na ko\u0144cu wiersza, \u017ceby otworzy\u0107 panel <strong>Szczeg\u00f3\u0142y logu webhooka<\/strong>:<\/p>\n\n<ul>\n  <li><strong>Szczeg\u00f3\u0142y<\/strong> \u2013 webhook, data utworzenia, adres docelowy, metoda, status odpowiedzi, wynik, liczba pr\u00f3b, komunikat b\u0142\u0119du, token i czas przetwarzania. Komunikat b\u0142\u0119du to odpowied\u017a Twojego systemu albo kr\u00f3tki opis problemu. Token jest zawsze zamaskowany albo pusty, je\u015bli webhook nie ma nag\u0142\u00f3wka uwierzytelniaj\u0105cego.<\/li>\n  <li><strong>Tre\u015b\u0107 \u017c\u0105dania<\/strong> \u2013 tre\u015b\u0107 \u017c\u0105dania w formacie JSON, sformatowana dla czytelno\u015bci. Kliknij ikon\u0119 kopiowania w polu, \u017ceby go skopiowa\u0107.<\/li>\n<\/ul>\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img decoding=\"async\" src=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2026\/11\/webhook-log-details.pl_.png\" alt=\"Panel Szczeg\u00f3\u0142y logu webhooka na zak\u0142adce Szczeg\u00f3\u0142y: webhook, data utworzenia, adres docelowy, metoda, status odpowiedzi, wynik, liczba pr\u00f3b, komunikat b\u0142\u0119du, token, adres IP i czas przetwarzania.\" style=\"width:520px\"\/><\/figure>\n\n\n<p><strong>Wskaz\u00f3wka:<\/strong> Wpisy starsze ni\u017c ustawiony okres przechowywania znikaj\u0105 z logu i z wynik\u00f3w wyszukiwania. Je\u015bli diagnozujesz powtarzaj\u0105ce si\u0119 b\u0142\u0119dy, przejrzyj je, zanim wygasn\u0105.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"payloady-webhookow\">Payloady webhook\u00f3w<\/h2>\n\n\n<p>Ta sekcja opisuje \u017c\u0105dania, kt\u00f3re ECDP wysy\u0142a na Tw\u00f3j adres docelowy po uruchomieniu webhooka.<\/p>\n\n\n<h3 class=\"wp-block-heading\" id=\"format-zadania\">Format \u017c\u0105dania<\/h3>\n\n\n<ul>\n  <li>ECDP wysy\u0142a ka\u017cde zdarzenie jako \u017c\u0105danie <strong>POST<\/strong>. Tre\u015b\u0107 to jeden obiekt JSON (UTF-8), a nag\u0142\u00f3wek <strong>Content-Type<\/strong> ma warto\u015b\u0107 <strong>application\/json<\/strong>.<\/li>\n  <li>Je\u015bli w webhooku ustawisz nag\u0142\u00f3wek uwierzytelniaj\u0105cy, ECDP do\u0142\u0105cza go do ka\u017cdego \u017c\u0105dania pod wpisan\u0105 przez Ciebie nazw\u0105 i z wpisan\u0105 warto\u015bci\u0105.<\/li>\n  <li>Ka\u017cde zdarzenie tworzy osobne \u017c\u0105danie. Na przyk\u0142ad, je\u015bli jedno wywo\u0142anie API zmienia trzy zgody klienta, dostajesz trzy \u017c\u0105dania.<\/li>\n  <li>\u017b\u0105danie testowe zawiera przyk\u0142adowe dane i mo\u017ce si\u0119 nieznacznie r\u00f3\u017cni\u0107 od prawdziwego \u017c\u0105dania. Jako wzorca u\u017cywaj tej sekcji.<\/li>\n  <li>W tek\u015bcie JSON znaki takie jak <strong>+<\/strong> i <strong>&amp;<\/strong> mog\u0105 by\u0107 zapisane jako <strong>\\u002B<\/strong> i <strong>\\u0026<\/strong>. Ka\u017cdy parser JSON odczyta je poprawnie, wi\u0119c nie trzeba ich osobno obs\u0142ugiwa\u0107.<\/li>\n  <li>Nazwy p\u00f3l s\u0105 zapisane w camelCase. <strong>eventType<\/strong> to nazwa zdarzenia, np. <strong>Send<\/strong>. Ta sama nazwa wyst\u0119puje w kilku kana\u0142ach, np. <strong>Send<\/strong> i <strong>Click<\/strong>, wi\u0119c kana\u0142 rozpoznasz po pozosta\u0142ych polach.<\/li>\n  <li>ECDP pomija pola, kt\u00f3re nie maj\u0105 warto\u015bci. Nie wysy\u0142a ich z warto\u015bci\u0105 <strong>null<\/strong>. Pomija te\u017c puste pola <strong>crmId<\/strong>, <strong>email<\/strong>, <strong>phone<\/strong>, <strong>channel<\/strong> i <strong>version<\/strong>.<\/li>\n  <li>\u017b\u0105danie nie zawiera Twojego klucza API, adresu docelowego ani nazwy webhooka.<\/li>\n<\/ul>\n\n\n<h4 class=\"wp-block-heading\" id=\"pola-w-kazdym-zdarzeniu\">Pola w ka\u017cdym zdarzeniu<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Pole<\/strong><\/td><td><strong>Typ<\/strong><\/td><td><strong>Opis<\/strong><\/td><\/tr><\/thead><tbody><tr><td>eventId<\/td><td>string (UUID)<\/td><td>Unikalne ID zdarzenia. Je\u015bli ECDP ponowi dostarczenie, ponowione \u017c\u0105danie ma to samo <strong>eventId<\/strong>, wi\u0119c po Twojej stronie mo\u017cesz je wykorzysta\u0107 do wykrywania duplikat\u00f3w. Je\u015bli kilka webhook\u00f3w reaguje na to samo zdarzenie, ka\u017cdy z nich dostaje to samo <strong>eventId<\/strong>.<\/td><\/tr><tr><td>eventType<\/td><td>string<\/td><td>Typ zdarzenia, np. <strong>ConsentGiven<\/strong>, <strong>Send<\/strong> albo <strong>Click<\/strong>.<\/td><\/tr><tr><td>category<\/td><td>string<\/td><td>Kategoria zdarzenia: <strong>Consents<\/strong>, <strong>Email<\/strong>, <strong>Sms<\/strong>, <strong>WebPush<\/strong> albo <strong>MobilePush<\/strong>.<\/td><\/tr><tr><td>eventDate<\/td><td>string (ISO 8601)<\/td><td>Kiedy ECDP opublikowa\u0142 zdarzenie. To nie jest czas pierwotnej wysy\u0142ki, klikni\u0119cia ani wywo\u0142ania zwrotnego. Data jest w strefie czasowej Twojej jednostki biznesowej, z pe\u0142nymi sekundami i przesuni\u0119ciem wzgl\u0119dem UTC, np. <strong>2026-08-26T12:05:33+02:00<\/strong>.<\/td><\/tr><tr><td>customerId<\/td><td>number<\/td><td>ID klienta w ECDP.<\/td><\/tr><tr><td>crmId<\/td><td>string<\/td><td>CRM ID klienta. Wysy\u0142ane tylko wtedy, gdy jest dost\u0119pne.<\/td><\/tr><tr><td>email<\/td><td>string<\/td><td>Aktualny adres e-mail klienta. Wysy\u0142any tylko wtedy, gdy jest dost\u0119pny.<\/td><\/tr><tr><td>phone<\/td><td>string<\/td><td>Aktualny numer telefonu klienta w formacie mi\u0119dzynarodowym, z prefiksem kraju i bez spacji. Wysy\u0142any tylko wtedy, gdy jest dost\u0119pny.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n<p>ECDP bierze dane kontaktowe z danych klienta w chwili budowania \u017c\u0105dania. Nie musz\u0105 to by\u0107 ten sam adres e-mail ani numer telefonu, kt\u00f3re zosta\u0142y u\u017cyte przy pierwotnej wysy\u0142ce. Identyfikatory klienta nie s\u0105 ograniczone do kana\u0142u zdarzenia: zdarzenie SMS mo\u017ce zawiera\u0107 tak\u017ce <strong>email<\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"zdarzenia-zgod\">Zdarzenia zg\u00f3d<\/h3>\n\n\n<p>Typy zdarze\u0144: <strong>ConsentGiven<\/strong>, <strong>ConsentAwaitingConfirmation<\/strong>, <strong>ConsentConfirmed<\/strong>, <strong>ConsentRevoked<\/strong>. Opr\u00f3cz wsp\u00f3lnych p\u00f3l te zdarzenia zawieraj\u0105:<\/p>\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Pole<\/strong><\/td><td><strong>Typ<\/strong><\/td><td><strong>Opis<\/strong><\/td><\/tr><\/thead><tbody><tr><td>consentId<\/td><td>number<\/td><td>ID zgody.<\/td><\/tr><tr><td>consentName<\/td><td>string<\/td><td>Nazwa zgody.<\/td><\/tr><tr><td>channel<\/td><td>string<\/td><td>Kana\u0142 zgody: <strong>Email<\/strong>, <strong>Sms<\/strong>, <strong>WebPush<\/strong> albo <strong>MobileApplication<\/strong>. Dla zgody og\u00f3lnej ECDP go pomija.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n<p><strong>Przyk\u0142ad: ConsentGiven<\/strong><\/p>\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"eventId\": \"11111111-1111-4111-8111-000000000001\",\n  \"eventType\": \"ConsentGiven\",\n  \"category\": \"Consents\",\n  \"eventDate\": \"2026-08-26T12:05:33+02:00\",\n  \"customerId\": 12345,\n  \"crmId\": \"CRM-DEMO-12345\",\n  \"email\": \"customer@example.com\",\n  \"consentId\": 10,\n  \"consentName\": \"Email communication consent\",\n  \"channel\": \"Email\"\n}<\/code><\/pre>\n\n\n<p><strong>Przyk\u0142ad: ConsentRevoked<\/strong> dla zgody og\u00f3lnej. Nie ma pola <strong>channel<\/strong>.<\/p>\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"eventId\": \"11111111-1111-4111-8111-000000000004\",\n  \"eventType\": \"ConsentRevoked\",\n  \"category\": \"Consents\",\n  \"eventDate\": \"2026-08-26T12:08:33+02:00\",\n  \"customerId\": 12345,\n  \"crmId\": \"CRM-DEMO-12345\",\n  \"consentId\": 11,\n  \"consentName\": \"General consent\"\n}<\/code><\/pre>\n\n\n<p>Gdy klient potwierdza zgod\u0119 double opt-in, dostajesz tylko zdarzenie <strong>ConsentConfirmed<\/strong>, bez dodatkowego <strong>ConsentGiven<\/strong>.<\/p>\n\n\n<h3 class=\"wp-block-heading\" id=\"zdarzenia-e-mail\">Zdarzenia e-mail<\/h3>\n\n\n<p>Typy zdarze\u0144: <strong>Send<\/strong>, <strong>Delivery<\/strong>, <strong>Bounce<\/strong>, <strong>Complaint<\/strong>, <strong>Open<\/strong>, <strong>Click<\/strong>. <strong>Send<\/strong> oznacza, \u017ce e-mail zosta\u0142 wys\u0142any, a nie \u017ce dotar\u0142 do odbiorcy. Opr\u00f3cz wsp\u00f3lnych p\u00f3l te zdarzenia zawieraj\u0105:<\/p>\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Pole<\/strong><\/td><td><strong>Zdarzenia<\/strong><\/td><td><strong>Opis<\/strong><\/td><\/tr><\/thead><tbody><tr><td>messageId<\/td><td>Wszystkie<\/td><td>ID wiadomo\u015bci (number).<\/td><\/tr><tr><td>messageType<\/td><td>Wszystkie<\/td><td>Typ wiadomo\u015bci: <strong>Newsletter<\/strong>, <strong>Scenario<\/strong> albo <strong>Confirmation<\/strong>.<\/td><\/tr><tr><td>messageSubjectOrName<\/td><td>Wszystkie<\/td><td>Temat wiadomo\u015bci. Je\u015bli wiadomo\u015b\u0107 nie ma tematu, to pusty ci\u0105g znak\u00f3w.<\/td><\/tr><tr><td>version<\/td><td>Wszystkie<\/td><td>Wariant, kt\u00f3ry klient dosta\u0142 w te\u015bcie A\/B: <strong>A<\/strong>, <strong>B<\/strong>, <strong>C<\/strong> itd. albo <strong>Winner<\/strong> dla kopii zwyci\u0119skiej wersji. Wysy\u0142ane tylko dla wiadomo\u015bci z testem A\/B.<\/td><\/tr><tr><td>bounceReason<\/td><td>Bounce<\/td><td>Pow\u00f3d odbicia: <strong>UserUnknown<\/strong>, <strong>MailboxFull<\/strong>, <strong>Blocked<\/strong>, <strong>Unknown<\/strong> albo <strong>Other<\/strong>.<\/td><\/tr><tr><td>bounceType<\/td><td>Bounce<\/td><td>Typ odbicia: <strong>Hard<\/strong>, <strong>Soft<\/strong>, <strong>Transparent<\/strong>, <strong>Block<\/strong> albo <strong>Other<\/strong>.<\/td><\/tr><tr><td>targetUrl<\/td><td>Click<\/td><td>Docelowy adres linku, w kt\u00f3ry klikn\u0105\u0142 klient, a nie adres przekierowania \u015bledz\u0105cego. Zawiera wszystkie parametry, tak\u017ce te, kt\u00f3re ECDP dodaje do linku, np. UTM.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n<p><strong>Przyk\u0142ad: Send<\/strong><\/p>\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"eventId\": \"11111111-1111-4111-8111-000000000005\",\n  \"eventType\": \"Send\",\n  \"category\": \"Email\",\n  \"eventDate\": \"2026-08-26T12:09:33+02:00\",\n  \"customerId\": 12345,\n  \"email\": \"customer@example.com\",\n  \"messageId\": 2001,\n  \"messageType\": \"Newsletter\",\n  \"messageSubjectOrName\": \"Sample message\",\n  \"version\": \"A\"\n}<\/code><\/pre>\n\n\n<p><strong>Przyk\u0142ad: Bounce<\/strong><\/p>\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"eventId\": \"11111111-1111-4111-8111-000000000007\",\n  \"eventType\": \"Bounce\",\n  \"category\": \"Email\",\n  \"eventDate\": \"2026-08-26T12:11:33+02:00\",\n  \"customerId\": 12345,\n  \"email\": \"customer@example.com\",\n  \"messageId\": 2001,\n  \"messageType\": \"Newsletter\",\n  \"messageSubjectOrName\": \"Sample message\",\n  \"bounceReason\": \"UserUnknown\",\n  \"bounceType\": \"Hard\"\n}<\/code><\/pre>\n\n\n<p><strong>Przyk\u0142ad: Click<\/strong><\/p>\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"eventId\": \"11111111-1111-4111-8111-000000000010\",\n  \"eventType\": \"Click\",\n  \"category\": \"Email\",\n  \"eventDate\": \"2026-08-26T12:14:33+02:00\",\n  \"customerId\": 12345,\n  \"email\": \"customer@example.com\",\n  \"messageId\": 2001,\n  \"messageType\": \"Newsletter\",\n  \"messageSubjectOrName\": \"Sample message\",\n  \"targetUrl\": \"https:\/\/shop.example.com\/products\/demo\"\n}<\/code><\/pre>\n\n\n<p>Zdarzenia <strong>Delivery<\/strong>, <strong>Complaint<\/strong> i <strong>Open<\/strong> maj\u0105 te same pola co <strong>Send<\/strong>. <strong>Complaint<\/strong> nie ma pola opisuj\u0105cego skarg\u0119.<\/p>\n\n\n<h3 class=\"wp-block-heading\" id=\"zdarzenia-sms\">Zdarzenia SMS<\/h3>\n\n\n<p>Typy zdarze\u0144: <strong>Send<\/strong>, <strong>Bounce<\/strong>, <strong>Click<\/strong>. <strong>Send<\/strong> oznacza, \u017ce SMS zosta\u0142 wys\u0142any, a nie \u017ce dotar\u0142 na telefon. Opr\u00f3cz wsp\u00f3lnych p\u00f3l te zdarzenia zawieraj\u0105:<\/p>\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Pole<\/strong><\/td><td><strong>Zdarzenia<\/strong><\/td><td><strong>Opis<\/strong><\/td><\/tr><\/thead><tbody><tr><td>messageId<\/td><td>Wszystkie<\/td><td>ID wiadomo\u015bci (number).<\/td><\/tr><tr><td>messageType<\/td><td>Wszystkie<\/td><td>Typ wiadomo\u015bci: <strong>Newsletter<\/strong> albo <strong>Scenario<\/strong>.<\/td><\/tr><tr><td>failureReason<\/td><td>Bounce<\/td><td>Status zg\u0142oszony przez bramk\u0119 SMS, gdy wiadomo\u015b\u0107 nie zosta\u0142a dostarczona, np. kod statusu z jego nazw\u0105. ECDP przekazuje go bez zmian, wi\u0119c nie jest to zamkni\u0119ta lista warto\u015bci i zale\u017cy od bramki.<\/td><\/tr><tr><td>targetUrl<\/td><td>Click<\/td><td>Docelowy adres linku, w kt\u00f3ry klikn\u0105\u0142 klient. Zawiera wszystkie parametry, tak\u017ce te, kt\u00f3re ECDP dodaje do linku, np. UTM.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n<p><strong>Przyk\u0142ad: Bounce<\/strong><\/p>\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"eventId\": \"11111111-1111-4111-8111-000000000012\",\n  \"eventType\": \"Bounce\",\n  \"category\": \"Sms\",\n  \"eventDate\": \"2026-08-26T12:16:33+02:00\",\n  \"customerId\": 12345,\n  \"phone\": \"+12025550123\",\n  \"messageId\": 3001,\n  \"messageType\": \"Newsletter\",\n  \"failureReason\": \"DEMO_UNDELIVERABLE\"\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"zdarzenia-web-push\">Zdarzenia web push<\/h3>\n\n\n<p>Typy zdarze\u0144: <strong>Send<\/strong>, <strong>View<\/strong>, <strong>Click<\/strong>. <strong>Send<\/strong> oznacza, \u017ce powiadomienie zosta\u0142o przekazane do dostawcy push, a nie \u017ce zosta\u0142o wy\u015bwietlone. Opr\u00f3cz wsp\u00f3lnych p\u00f3l te zdarzenia zawieraj\u0105:<\/p>\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Pole<\/strong><\/td><td><strong>Zdarzenia<\/strong><\/td><td><strong>Opis<\/strong><\/td><\/tr><\/thead><tbody><tr><td>messageId<\/td><td>Wszystkie<\/td><td>ID powiadomienia (number).<\/td><\/tr><tr><td>messageType<\/td><td>Wszystkie<\/td><td>Typ powiadomienia: <strong>Newsletter<\/strong> albo <strong>Scenario<\/strong>.<\/td><\/tr><tr><td>websiteId<\/td><td>Wszystkie<\/td><td>ID strony (number).<\/td><\/tr><tr><td>targetUrl<\/td><td>Click<\/td><td>Docelowy adres linku, w kt\u00f3ry klikn\u0105\u0142 klient. Zawiera wszystkie parametry, tak\u017ce te, kt\u00f3re ECDP dodaje do linku, np. UTM.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n<p><strong>Przyk\u0142ad: Click<\/strong><\/p>\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"eventId\": \"11111111-1111-4111-8111-000000000016\",\n  \"eventType\": \"Click\",\n  \"category\": \"WebPush\",\n  \"eventDate\": \"2026-08-26T12:20:33+02:00\",\n  \"customerId\": 12345,\n  \"messageId\": 4001,\n  \"messageType\": \"Newsletter\",\n  \"websiteId\": 100,\n  \"targetUrl\": \"https:\/\/shop.example.com\/news\/demo\"\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"zdarzenia-mobile-push\">Zdarzenia mobile push<\/h3>\n\n\n<p>Typy zdarze\u0144: <strong>Send<\/strong>, <strong>View<\/strong>, <strong>Click<\/strong>. <strong>Send<\/strong> oznacza, \u017ce powiadomienie zosta\u0142o przekazane do dostawcy push, a nie \u017ce zosta\u0142o wy\u015bwietlone. Opr\u00f3cz wsp\u00f3lnych p\u00f3l te zdarzenia zawieraj\u0105:<\/p>\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Pole<\/strong><\/td><td><strong>Opis<\/strong><\/td><\/tr><\/thead><tbody><tr><td>messageId<\/td><td>ID powiadomienia (number).<\/td><\/tr><tr><td>messageType<\/td><td>Typ powiadomienia: <strong>Newsletter<\/strong> albo <strong>Scenario<\/strong>.<\/td><\/tr><tr><td>mobileApplicationId<\/td><td>ID aplikacji mobilnej (number).<\/td><\/tr><tr><td>deviceId<\/td><td>Publiczne ID urz\u0105dzenia klienta (string).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n<p><strong>Przyk\u0142ad: Send<\/strong><\/p>\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"eventId\": \"11111111-1111-4111-8111-000000000017\",\n  \"eventType\": \"Send\",\n  \"category\": \"MobilePush\",\n  \"eventDate\": \"2026-08-26T12:21:33+02:00\",\n  \"customerId\": 12345,\n  \"crmId\": \"CRM-DEMO-12345\",\n  \"messageId\": 5001,\n  \"messageType\": \"Scenario\",\n  \"mobileApplicationId\": 200,\n  \"deviceId\": \"demo-device-001\"\n}<\/code><\/pre>\n\n\n<p>Zdarzenia <strong>View<\/strong> i <strong>Click<\/strong> maj\u0105 te same pola. Zdarzenia mobile push nie zawieraj\u0105 linku.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"czy-webhooki-wysylaja-zmiany-zgod-z-importu\">Czy webhooki wysy\u0142aj\u0105 zmiany zg\u00f3d z importu?<\/h2>\n\n\n<p>Nie. Zmiany zg\u00f3d wprowadzone przez import danych klient\u00f3w nie uruchamiaj\u0105 webhook\u00f3w. Dotyczy to te\u017c akcji masowych i akcji scenariusza ustawiaj\u0105cych dane klienta. Operacje, kt\u00f3re wysy\u0142aj\u0105 zdarzenia zg\u00f3d, znajdziesz w sekcji <a href=\"#zdarzenia-ktore-mozesz-wysylac\">Zdarzenia, kt\u00f3re mo\u017cesz wysy\u0142a\u0107<\/a>.<\/p>\n","protected":false},"author":8,"featured_media":0,"parent":0,"menu_order":0,"template":"","ecdp-category":[101],"class_list":["post-18174","ecdp","type-ecdp","status-publish","hentry","ecdp-category-ustawienia"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp\/18174","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp"}],"about":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/types\/ecdp"}],"author":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/users\/8"}],"version-history":[{"count":1,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp\/18174\/revisions"}],"predecessor-version":[{"id":18177,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp\/18174\/revisions\/18177"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=18174"}],"wp:term":[{"taxonomy":"ecdp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp-category?post=18174"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}