{"id":10737,"date":"2024-06-10T12:51:24","date_gmt":"2024-06-10T11:51:24","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=es&#038;p=10737"},"modified":"2024-06-11T10:21:16","modified_gmt":"2024-06-11T09:21:16","slug":"dokumentacja-webhookow","status":"publish","type":"es","link":"https:\/\/help.expertsender.com\/pl\/emp\/dokumentacja-webhookow\/","title":{"rendered":"Webhook"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"wprowadzenie\">WPROWADZENIE<a href=\"#wprowadzenie\" class=\"not-prose content-heading-link\">#<\/a><\/h3>\n\n\n\n<p>Webhooki w ExpertSender umo\u017cliwiaj\u0105 automatyczne powiadamianie system\u00f3w zewn\u0119trznych o zdarzeniach zachodz\u0105cych w Twojej aplikacji. Dzi\u0119ki Webhookom, ExpertSender mo\u017ce wysy\u0142a\u0107 informacje o zdarzeniach do innych system\u00f3w w czasie rzeczywistym, co pozwala na szybk\u0105 reakcj\u0119 i integracj\u0119 z r\u00f3\u017cnymi narz\u0119dziami i us\u0142ugami. U\u017cywaj\u0105c Webhook\u00f3w, mo\u017cesz zautomatyzowa\u0107 procesy, monitorowa\u0107 zdarzenia i synchronizowa\u0107 dane bez potrzeby ci\u0105g\u0142ego odpytywania API.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"kreator-oraz-konfiguracja-webhooka\">KREATOR ORAZ KONFIGURACJA WEBHOOKA<a href=\"#kreator-oraz-konfiguracja-webhooka\" class=\"not-prose content-heading-link\">#<\/a><\/h3>\n\n\n\n<h5 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"uruchomienie-kreatora-wizard\">Uruchomienie kreatora (Wizard):<a href=\"#uruchomienie-kreatora-wizard\" class=\"not-prose content-heading-link\">#<\/a><\/h5>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Zaloguj si\u0119 do panelu administracyjnego ExpertSender.<\/li>\n\n\n\n<li>Wejd\u017a w zak\u0142adk\u0119 Automatyzacja.<\/li>\n\n\n\n<li>Przejd\u017a do sekcji Webhooki.<\/li>\n\n\n\n<li>Kliknij przycisk &#8220;Utw\u00f3rz nowy Webhook&#8221;, aby uruchomi\u0107 kreatora.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"513\" src=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/list-2-1024x513.png\" alt=\"\" class=\"wp-image-10741\" style=\"width:646px;height:auto\" srcset=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/list-2-1024x513.png 1024w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/list-2-300x150.png 300w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/list-2-768x384.png 768w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/list-2-1536x769.png 1536w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/list-2.png 2006w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"konfiguracja-webhooka\">Konfiguracja Webhooka:<a href=\"#konfiguracja-webhooka\" class=\"not-prose content-heading-link\">#<\/a><\/h5>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Nazwa<\/strong>: Wprowad\u017a unikaln\u0105 nazw\u0119 dla swojego Webhooka, aby \u0142atwo go rozpozna\u0107.<\/li>\n\n\n\n<li><strong>Zdarzenie<\/strong>: Wybierz typ zdarzenia, kt\u00f3re ma uruchamia\u0107 Webhooka (np. &#8220;Email &#8211; otwarcie&#8221;, &#8220;Email &#8211; dostarczenie&#8221;).<\/li>\n\n\n\n<li><strong>Docelowy URL<\/strong>: Wprowad\u017a adres URL, na kt\u00f3ry maj\u0105 by\u0107 wysy\u0142ane powiadomienia. Upewnij si\u0119, \u017ce URL jest poprawny i dost\u0119pny publicznie oraz jest prawid\u0142owym adresem HTTPS.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"609\" height=\"497\" src=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/wizard-2.png\" alt=\"\" class=\"wp-image-10744\" style=\"width:512px;height:auto\" srcset=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/wizard-2.png 609w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/wizard-2-300x245.png 300w\" sizes=\"auto, (max-width: 609px) 100vw, 609px\" \/><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"przed-aktywacja-webhooka\">Przed aktywacj\u0105 WebHooka:<a href=\"#przed-aktywacja-webhooka\" class=\"not-prose content-heading-link\">#<\/a><\/h5>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Test po\u0142\u0105czenia<\/strong>: System sprawdzi, czy pola z adresem URL i typem zdarzenia zosta\u0142y poprawnie wype\u0142nione oraz czy wpisany adres URL jest prawid\u0142owym adresem HTTPS.Pr\u00f3ba przetestowania po\u0142\u0105czenia sprawdza:\n<ul class=\"wp-block-list\">\n<li>Czy zosta\u0142y wype\u0142nione pola z adresem i typem zdarzenia.<\/li>\n\n\n\n<li>Czy wpisany adres jest prawid\u0142owym adresem HTTPS.<\/li>\n\n\n\n<li>Wysy\u0142a fikcyjne dane pod wskazany adres.<\/li>\n\n\n\n<li>Struktura danych jest zgodna z typem zdarzenia.<\/li>\n\n\n\n<li>B\u0142\u0119dy po\u0142\u0105czenia prezentowane s\u0105 tak samo, jak w logach WebHook.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Sprawdzenie unikalno\u015bci<\/strong>: System sprawdzi, czy nie istnieje ju\u017c inny aktywny WebHook dla wybranego typu zdarzenia.<\/li>\n<\/ol>\n\n\n\n<p>Webhooki s\u0105 aktywowane automatycznie po ich utworzeniu. Edycja Webhooka jest mo\u017cliwa tylko dla nieaktywnych Webhook\u00f3w, dlatego podczas edycji nie jest wymagane ponowne sprawdzanie tych warunk\u00f3w.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"testowanie-i-aktywacja\">Testowanie i aktywacja:<a href=\"#testowanie-i-aktywacja\" class=\"not-prose content-heading-link\">#<\/a><\/h5>\n\n\n\n<p>Po wprowadzeniu wszystkich danych i pomy\u015blnym przej\u015bciu testu po\u0142\u0105czenia, WebHook zostanie automatycznie aktywowany.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"typy-zdarzen\">TYPY ZDARZE\u0143<a href=\"#typy-zdarzen\" class=\"not-prose content-heading-link\">#<\/a><\/h3>\n\n\n\n<p>Posiadamy nast\u0119puj\u0105ce typy zdarze\u0144:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Typ zdarzenia<\/th><th>Opis<\/th><th>Zwracane dane<\/th><th>Przyk\u0142adowy JSON<\/th><\/tr><\/thead><tbody><tr><td>Email &#8211; wysy\u0142ka<\/td><td>Wywo\u0142ywane, gdy email zostaje wys\u0142any.<\/td><td>eventType: Typ zdarzenia (EmailSends) eventDate: Data i czas zdarzenia messageId: ID wiadomo\u015bci subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta<\/td><td><code>{\"eventType\": \"EmailSends\", \"eventDate\": \"2024-05-08T13:41:52.4514466Z\", \"messageId\": 145413, \"subscriberId\": 6552353, \"subscriberEmail\": \"test@test.com\"}<\/code><\/td><\/tr><tr><td>Email &#8211; klikni\u0119cie<\/td><td>Wywo\u0142ywane, gdy subskrybent kliknie w link w emailu.<\/td><td>eventType: Typ zdarzenia (EmailClicks) eventDate: Data i czas zdarzenia messageId: ID wiadomo\u015bci subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta<\/td><td><code>{\"eventType\": \"EmailClicks\", \"eventDate\": \"2024-05-10T09:30:00.8726192Z\", \"messageId\": 148000, \"subscriberId\": 1, \"subscriberEmail\": \"test@test.com\"}<\/code><\/td><\/tr><tr><td>Email &#8211; otwarcie<\/td><td>Wywo\u0142ywane, gdy subskrybent otworzy email.<\/td><td>eventType: Typ zdarzenia (EmailOpens) eventDate: Data i czas zdarzenia messageId: ID wiadomo\u015bci subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta<\/td><td><code>{\"eventType\": \"EmailOpens\", \"eventDate\": \"2024-05-10T13:28:23.2093755Z\", \"messageId\": 149211, \"subscriberId\": 5823952, \"subscriberEmail\": \"test@test.com\"}<\/code><\/td><\/tr><tr><td>Email &#8211; dostarczenie<\/td><td>Wywo\u0142ywane, gdy email zostanie dostarczony do odbiorcy.<\/td><td>eventType: Typ zdarzenia (EmailDeliveries) eventDate: Data i czas zdarzenia messageId: ID wiadomo\u015bci subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta<\/td><td><code>{\"eventType\": \"EmailDeliveries\", \"eventDate\": \"2024-05-09T10:29:36.8300628Z\", \"messageId\": 145413, \"subscriberId\": 6552353, \"subscriberEmail\": \"test@test.com\"}<\/code><\/td><\/tr><tr><td>Email &#8211; zwrotka<\/td><td>Wywo\u0142ywane, gdy email nie mo\u017ce zosta\u0107 dostarczony (b\u0142\u0105d).<\/td><td>eventType: Typ zdarzenia (EmailBounces) eventDate: Data i czas zdarzenia messageId: ID wiadomo\u015bci subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta<\/td><td><code>{\"eventType\": \"EmailBounces\", \"eventDate\": \"2024-05-09T09:33:29.6409191Z\", \"messageId\": 138876, \"subscriberId\": 149448, \"subscriberEmail\": \"test@test.com\"}<\/code><\/td><\/tr><tr><td>Email &#8211; skarga<\/td><td>Wywo\u0142ywane, gdy odbiorca zg\u0142asza email jako spam.<\/td><td>eventType: Typ zdarzenia (EmailComplaints) eventDate: Data i czas zdarzenia messageId: ID wiadomo\u015bci subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta<\/td><td><code>{\"eventType\": \"EmailComplaints\", \"eventDate\": \"2024-05-09T13:17:45.494757Z\", \"messageId\": 149141, \"subscriberId\": 49858, \"subscriberEmail\": \"test@test.com\"}<\/code><\/td><\/tr><tr><td>Subskrypcja<\/td><td>Wywo\u0142ywane, gdy nowy subskrybent zapisuje si\u0119 na list\u0119 mailingow\u0105.<\/td><td>eventType: Typ zdarzenia (Subscriptions) eventDate: Data i czas zdarzenia listId: ID listy mailingowej subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta<\/td><td><code>{\"eventType\": \"Subscriptions\", \"eventDate\": \"2024-05-10T11:52:50.4969976Z\", \"listId\": 7477, \"subscriberId\": 6552356, \"subscriberEmail\": \"test@test.com\"}<\/code><\/td><\/tr><tr><td>Potwierdzenie subskrypcji<\/td><td>Wywo\u0142ywane, gdy subskrybent potwierdza zapisanie si\u0119 na list\u0119 mailingow\u0105.<\/td><td>eventType: Typ zdarzenia (Confirmations) eventDate: Data i czas zdarzenia messageId: ID wiadomo\u015bci subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta listId: ID listy mailingowej<\/td><td><code>{\"eventType\": \"Confirmations\", \"eventDate\": \"2024-05-13T11:21:12.1358311Z\", \"messageId\": 149212, \"subscriberId\": 5823952, \"subscriberEmail\": \"test@test.com\", \"listId\": 7480}<\/code><\/td><\/tr><tr><td>Wypisanie<\/td><td>Wywo\u0142ywane, gdy subskrybent wypisuje si\u0119 z listy mailingowej.<\/td><td>eventType: Typ zdarzenia (Unsubscriptions) eventDate: Data i czas zdarzenia listId: ID listy mailingowej subscriberId: ID subskrybenta subscriberEmail: Adres email subskrybenta<\/td><td><code>{\"eventType\": \"Unsubscriptions\", \"eventDate\": \"2024-05-10T12:58:06.2247049Z\", \"listId\": 7468, \"subscriberId\": 4723542, \"subscriberEmail\": \"test@test.com\"}<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"logi-i-ponowienia\">LOGI I PONOWIENIA<a href=\"#logi-i-ponowienia\" class=\"not-prose content-heading-link\">#<\/a><\/h3>\n\n\n\n<h5 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"logi-webhookow\">Logi Webhook\u00f3w<a href=\"#logi-webhookow\" class=\"not-prose content-heading-link\">#<\/a><\/h5>\n\n\n\n<p>W przypadku nieudanych wysy\u0142ek Webhooka, udost\u0119pniamy szczeg\u00f3\u0142owe logi zawieraj\u0105ce nast\u0119puj\u0105ce informacje, kt\u00f3re s\u0105 dost\u0119pne w panelu ExpertSender w zak\u0142adce Audyt -> Webhook Logi:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parametr<\/th><th>Opis<\/th><\/tr><\/thead><tbody><tr><td>Data wyst\u0105pienia<\/td><td>Data i czas, kiedy nast\u0105pi\u0142a pr\u00f3ba wysy\u0142ki Webhooka.<\/td><\/tr><tr><td>Nazwa Webhooka<\/td><td>Unikalna nazwa przypisana do Webhooka podczas konfiguracji.<\/td><\/tr><tr><td>ID WebHooka<\/td><td>Unikalny identyfikator Webhooka.<\/td><\/tr><tr><td>Status<\/td><td>Status odpowiedzi serwera, np. kod b\u0142\u0119du HTTP.<\/td><\/tr><tr><td>Tre\u015b\u0107 b\u0142\u0119du<\/td><td>Szczeg\u00f3\u0142owe informacje o b\u0142\u0119dzie zwr\u00f3conym przez serwer.<\/td><\/tr><tr><td>\u0141adunek Webhooka<\/td><td>Dane wysy\u0142ane w ramach Webhooka.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Logi te s\u0105 dost\u0119pne w panelu ExpertSender, co umo\u017cliwia \u015bledzenie nieudanych pr\u00f3b wysy\u0142ki i pomaga w diagnozowaniu oraz naprawianiu problem\u00f3w z integracj\u0105 Webhook\u00f3w. Dzi\u0119ki nim mo\u017cliwe jest tak\u017ce monitorowanie skuteczno\u015bci wysy\u0142ki i szybka reakcja na b\u0142\u0119dy.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"269\" src=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/logs-2-1024x269.png\" alt=\"\" class=\"wp-image-10747\" style=\"width:642px;height:auto\" srcset=\"https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/logs-2-1024x269.png 1024w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/logs-2-300x79.png 300w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/logs-2-768x202.png 768w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/logs-2-1536x404.png 1536w, https:\/\/help.expertsender.com\/wp-content\/uploads\/2024\/06\/logs-2.png 1878w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"bezpieczenstwo\">BEZPIECZE\u0143STWO<a href=\"#bezpieczenstwo\" class=\"not-prose content-heading-link\">#<\/a><\/h3>\n\n\n\n<p>Aby zapewni\u0107 bezpiecze\u0144stwo i autentyczno\u015b\u0107 wywo\u0142a\u0144 WebHook\u00f3w, zaleca si\u0119:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>U\u017cycie HTTPS do przesy\u0142ania danych.<\/li>\n\n\n\n<li>Walidacja \u017c\u0105da\u0144 na poziomie serwera odbieraj\u0105cego dane.<\/li>\n\n\n\n<li>U\u017cycie token\u00f3w uwierzytelniaj\u0105cych do weryfikacji \u017ar\u00f3d\u0142a \u017c\u0105dania.<\/li>\n<\/ol>\n\n\n\n<p>Ta dokumentacja ma na celu u\u0142atwienie integracji Webhook\u00f3w z Twoj\u0105 aplikacj\u0105 oraz zapewnienie szybkiego i efektywnego zarz\u0105dzania zdarzeniami w czasie rzeczywistym.<\/p>\n","protected":false},"author":13,"featured_media":0,"parent":0,"menu_order":0,"template":"","format":"standard","emp-category":[],"class_list":["post-10737","es","type-es","status-publish","format-standard","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/10737","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es"}],"about":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/types\/es"}],"author":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/users\/13"}],"version-history":[{"count":4,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/10737\/revisions"}],"predecessor-version":[{"id":10757,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/10737\/revisions\/10757"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=10737"}],"wp:term":[{"taxonomy":"emp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/emp-category?post=10737"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}