Lista zmian

Lista zmian

Najnowsze aktualizacje i ulepszenia.

Teraz dostępne w języku szwedzkim, norweskim, polskim i tureckim

Usługa Workflow Webhooks jest obecnie dostępna w czterech dodatkowych językach: szwedzkim, norweskim, polskim i tureckim. Łącznie daje to 16 języków.

  • Nie trzeba niczego konfigurować. Aplikacja dostosowuje się do języka, w jakim wyświetla się panel administracyjny Shopify.
  • Centrum pomocy oraz lista zmian. Poradniki, niniejsza lista zmian oraz gotowe szablony Shopify Flow są dostępne w tych samych językach.

Uruchomienie przepływu pracy w późniejszym terminie

Nowość

  • Opcja Uruchom o w akcji Wywołaj webhook. Akcja „Wywołaj webhook” w Shopify Flow posiada nowe opcjonalne pole Uruchom o. Jeśli pozostawi Pan/Pani to pole puste, akcja wywoła Pana/Pani webhook natychmiast, tak jak dotychczas. Wypełnienie tego pola spowoduje, że webhook oraz rozpoczynający się od niego przepływ pracy zostaną uruchomione później: w określonej dacie i godzinie, np. 2026-12-24T09:00:00+01:00, w określonej dacie, np. 2026-12-24, lub po upływie określonego czasu, np. 3 days, 12 hours lub 90 minutes. Wartość ta może pochodzić ze zmiennej Shopify Flow, dzięki czemu czas oczekiwania może zależeć od zamówienia, klienta lub metapola, czego nie umożliwia krok „Oczekiwanie” w Shopify Flow. Maksymalnie 365 dni w przyszłość. Data lub godzina bez przesunięcia czasowego jest odczytywana w strefie czasowej Państwa sklepu, a godzina, która już minęła, natychmiast uruchamia webhook.
  • Strona Zaplanowane uruchomienia. Każde oczekujące uruchomienie jest wymienione w sekcji Zaplanowane uruchomienia wraz z webhookiem i czasem, i można je anulować do momentu jego rozpoczęcia. Uruchomienie, które zostało wysłane, zawiera link do swojego wpisu w sekcji „Historia”.
  • Ostrzeżenie przed osiągnięciem limitu pakietu, a nie w momencie jego osiągnięcia. Trzecie powiadomienie, oprócz ostrzeżenia o limicie i wiadomości e-mail o przekroczeniu limitu: gdy Państwa zużycie z ostatnich dni osiągnie limit planu w ciągu wybranej liczby dni (3, 5, 7 lub 14, domyślnie 7), otrzymają Państwo wiadomość e-mail z informacją, ile dni pozostało oraz ile połączeń dziennie mogą Państwo odebrać. Funkcja ta jest domyślnie włączona i można ją wyłączyć w ustawieniach powiadomień. Pulpit nawigacyjny wyświetla tę samą prognozę w formie banera.
  • Powiadomienia dotyczące planu pojawiają się również na czacie. Te trzy powiadomienia dotyczące planu wyświetlają się również jako wiadomości na czacie w aplikacji, dzięki czemu można je znaleźć tam, gdzie Państwo pracują, a nie tylko w skrzynce odbiorczej.

Warto wiedzieć

  • Zaplanowane uruchomienie jest wliczane do limitu planu w momencie jego wykonania, a nie w momencie zaplanowania. Jeśli w tym momencie limit planu zostanie osiągnięty lub webhook zostanie wyłączony, uruchomienie zostanie wyświetlone jako nieudane na stronie „Zaplanowane uruchomienia” wraz z podaną przyczyną.
  • Sklep może mieć tyle oczekujących uruchomień, na ile pozwala jego plan w ciągu 30 dni: 500 w planie Free, 15 000 w planie Grow oraz 100 000 w planie Unlimited.
  • Nie ma to wpływu na istniejące już przepływy pracy: w przypadku braku wartości w polu „Uruchom o” akcja działa tak jak dotychczas.

Webhooki dla zalogowanych klientów w Państwa sklepie internetowym

Nowość

  • Kto może wywołać ten webhook. Działanie webhooka korzystającego z adresu proxy aplikacji w domenie Państwa sklepu można teraz ograniczyć do żądań przesyłanych za pośrednictwem tego adresu, tak aby bezpośredni adres aplikacji zwracał kod błędu 403, lub do klientów zalogowanych w Państwa sklepie, tak aby goście otrzymywali kod błędu 401. Shopify podpisuje każde żądanie przechodzące przez serwer proxy aplikacji, dzięki czemu podmiot wysyłający żądanie nie może podszywać się pod innego klienta ani inny sklep. Opcję tę można znaleźć w sekcji „Ustawienia zaawansowane” > „Ustawienia adresów URL”.
  • Zalogowany klient trafia do Shopify Flow. Wyzwalacz webhooka oraz wyzwalacz webhooka synchronizacji posiadają nowe pole customerId: jest to identyfikator klienta zalogowanego w Państwa sklepie w momencie, gdy żądanie dotarło poprzez adres proxy aplikacji. Proszę wykorzystać je w kroku „Pobierz dane klienta”, aby sprawdzić tagi, lokalizacje firmy lub inne informacje, zanim przepływ pracy zostanie uruchomiony. W przypadku wszystkich pozostałych podmiotów wysyłających żądania pole to pozostaje puste, a istniejące przepływy pracy mogą z niego korzystać od razu.

Zapytaj Sidekick - powiadomienia o awariach są domyślnie włączone

Nowość

  • Skorzystaj z funkcji Zapytaj Sidekick w przewodniku konfiguracji. Każdy etap przewodnika konfiguracji na pulpicie nawigacyjnym zawiera przycisk Zapytaj Sidekick. Po jego naciśnięciu otwiera się asystent Shopify z gotowym pytaniem dotyczącym danego etapu, w języku, w którym wyświetla się Państwa panel administracyjny. Przycisk ten jest widoczny wszędzie tam, gdzie funkcja Sidekick jest dostępna w Państwa panelu administracyjnym.
  • Zapytaj Sidekick, dlaczego wywołanie zakończyło się niepowodzeniem. W przypadku nieudanego wywołania webhooka wyświetli się komunikat Zapytaj Sidekick, dlaczego tak się stało. Sidekick wyszukuje wywołanie na podstawie jego identyfikatora i wyjaśnia, co poszło nie tak oraz jak to naprawić.

Ulepszone

  • Powiadomienia o awariach są domyślnie włączone. Powiadomienie e-mailowe o wysokim wskaźniku awarii jest obecnie aktywne dla wszystkich sklepów - zarówno nowych, jak i istniejących. Jest ono wysyłane, gdy co najmniej 20% z co najmniej 50 wywołań webhooków zakończyło się niepowodzeniem w ciągu 60 minut, maksymalnie raz na 6 godzin. W sekcji „Powiadomienia” można zmienić listę odbiorców lub wyłączyć to powiadomienie.

Szybsze ładowanie stron

Lista webhooków ładuje swoje niezależne dane łącznie. Filtry historii odczytują wyłącznie nazwy i identyfikatory webhooków, co ogranicza zbędny transfer danych, nie zmieniając jednocześnie sposobu przetwarzania webhooków ani przebiegu przepływu pracy.

Aplikacja w Państwa języku oraz siedem gotowych schematów działania

Aplikacja obsługuje Państwa język

Cała aplikacja dostosowuje się teraz do języka używanego w panelu administracyjnym Shopify. Dostępne języki to**: angielski, niemiecki, francuski, hiszpański, włoski, holenderski, duński, portugalski (Brazylia i Portugalia), japoński oraz chiński (uproszczony i tradycyjny)**. Po zmianie języka w panelu administracyjnym aplikacja dostosuje się do niego przy następnym załadowaniu strony.

  • Przetłumaczono każdą stronę, okno dialogowe i komunikat, w tym edytor webhooków, narzędzie do testowania podpisów wraz z diagnostyką krok po kroku, sekcję „Historia” oraz stronę pomocy.
  • Szablony przepływów pracy są wyświetlane w serwisie Shopify Flow wraz z tytułem, opisem i uwagą dotyczącą konfiguracji w Państwa języku.
  • Daty i liczby są wyświetlane zgodnie z zasadami zapisu obowiązującymi w Państwa języku.
  • To centrum pomocy również zostało przetłumaczone. Każdy poradnik jest dostępny w tych samych językach; proszę wybrać odpowiedni język z menu językowego.
  • Nazwy wyzwalaczy i akcji pozostają w języku angielskim. Shopify Flow wyświetla nazwy kroków w języku angielskim, więc aplikacja również je tak wyświetla - nazwa widoczna w aplikacji jest zawsze taka sama jak ta w Shopify Flow. Nazwy pól danych, takie jak fieldOne, również nie ulegają zmianie.

Siedem gotowych schematów działania w usłudze Shopify Flow

Otwórz aplikację Shopify Flow, wybierz opcję Przeglądaj szablony i wyszukaj hasło „webhook”. Każdy szablon stanowi kompletny przepływ pracy oparty na wyzwalaczu webhook; wystarczy jedynie utworzyć webhook i skonfigurować system tak, aby korzystał z niego.

  • Kolejność oznaczania zamówień po otrzymaniu powiadomienia webhook - dostawca usług logistycznych (3PL), system ERP lub narzędzie typu „no-code” oznacza zamówienia jako wysłane, zafakturowane lub sprawdzone.
  • Dodaj notatkę do zamówienia po otrzymaniu powiadomienia webhook - dołącz wiadomość z narzędzia obsługi klienta lub systemu ERP do notatki przy zamówieniu.
  • Proszę oznaczyć zamówienie jako opłacone po otrzymaniu powiadomienia webhook - gdy Państwa bank, system fakturowania lub system płatności potwierdzi dokonanie płatności.
  • Oznaczanie produktu po otrzymaniu powiadomienia webhook - dostawca, system PIM lub ERP zapewnia synchronizację kolekcji i oznaczeń.
  • Utwórz rekord klienta po otrzymaniu powiadomienia webhook - zbieraj dane potencjalnych klientów ze stron docelowych i formularzy.
  • Aktualizacja metapola klienta po otrzymaniu webhooka - system lojalnościowy, CRM lub system punktowy zapisuje określoną wartość w profilu klienta.
  • Zwracanie statusu zamówienia po otrzymaniu powiadomienia webhook - udzielenie odpowiedzi chatbotowi, działowi obsługi klienta lub portalowi klienta na temat statusu płatności i realizacji zamówienia przy użyciu odpowiedzi synchronicznej.

W uwagach dotyczących konfiguracji każdego szablonu podano, które pola należy przypisać. Zobacz Szablony procesów roboczych.

Nowy wygląd panelu administracyjnego Shopify

Shopify wprowadza nowy wygląd panelu administracyjnego. W sklepach, w których ta zmiana została już wdrożona, aplikacja Workflow Webhooks wykorzystuje teraz te same kolory, czcionki i ikony, dzięki czemu wygląda ona tak samo jak pozostałe elementy panelu administracyjnego. W sklepach, w których zmiana ta nie została jeszcze wprowadzona, nic się nie zmienia.

Zaplanowane webhooki, 22 gotowe wzorce podpisów, treści formularzy i plików XML - w szybszym interfejsie

Państwa webhooki mogą teraz działać zgodnie z harmonogramem, weryfikować podpisy niemal każdego nadawcy oraz obsługiwać formaty inne niż JSON.

Uruchomienie przepływu pracy zgodnie z harmonogramem za pomocą dowolnego interfejsu API

Nowa zakładka Harmonogram dostępna dla każdego webhooka oraz bezpośredni sposób na jej uruchomienie: wybierz opcję Utwórz webhook i w odpowiedzi na pytanie „Co wywoła ten webhook?” wybierz opcję Nic - uruchom zgodnie z harmonogramem. Aplikacja pobiera adres URL co 5 minut, maksymalnie raz dziennie, i wysyła odpowiedź do webhooka, dzięki czemu przepływ pracy w Shopify Flow może być uruchamiany zgodnie z harmonogramem z dowolnego interfejsu API.

  • Wywołać funkcję „fire” przy każdym pobraniu danych czy tylko w przypadku zmiany odpowiedzi?
  • Proszę dodać nagłówki żądania, jeśli są one wymagane przez interfejs API. Są one przechowywane w postaci zaszyfrowanej.
  • Funkcja Run pobiera dane tylko raz i wyświetla odpowiedź.
  • W tej zakładce można sprawdzić, w jakim stopniu harmonogram jest zgodny z Państwa planem. Biegi pojawiają się w sekcji „Historia” jako Zgodnie z harmonogramem.
  • Zadanie, które zakończy się niepowodzeniem 20 razy z rzędu, wstrzymuje swoje działanie.

Zobacz Okresowe sprawdzanie adresów URL.

Weryfikacja podpisu niemal każdego nadawcy

22 wbudowane ustawienia wstępne (wcześniej 6), z których każde zostało zweryfikowane pod kątem zgodności z dokumentacją danego dostawcy: Stripe, GitHub, Shopify, Slack, Typeform, Calendly, standardowe webhooki (OpenAI, Supabase), Svix (Clerk, Resend), Paddle, Linear, WooCommerce, Square, Sentry, Vercel, Zendesk, Lemon Squeezy, Razorpay, Paystack, Customer.io, Sendcloud, Mollie oraz Sanity.

  • W przypadku nadawcy bez gotowego ustawienia stosowany jest podpis niestandardowy: należy wybrać nagłówek, algorytm, kodowanie, sygnaturę czasową z ochroną przed ponownym odtworzeniem oraz dokładną treść, która ma zostać podpisana.
  • Narzędzie do testowania podpisów w edytorze wskazuje, który etap weryfikacji zakończył się niepowodzeniem, oraz umożliwia wygenerowanie prawidłowego przykładowego żądania.
  • Tworzenie webhooka rozpoczyna się obecnie od pytania, jakie dane będą do niego wysyłane.

Zobacz Weryfikacja podpisanych webhooków, gdzie znajdą Państwo szczegółową instrukcję krok po kroku dla każdego nadawcy.

Dodatkowe metody uwierzytelniania

  • Token statyczny może teraz być przekazywany jako token typu Bearer, w ramach uwierzytelniania podstawowego (nazwa użytkownika i hasło) lub jako parametr adresu URL - w przypadku nadawców, którzy nie mogą ustawić niestandardowego nagłówka. Token zawarty w adresie URL jest maskowany w historii i nigdy nie jest przekazywany do Shopify Flow.
  • Wymiana klucza bez przestojów. Oprócz pierwszego klucza akceptowany jest drugi klucz - dotyczy to tokenów statycznych oraz wszystkich schematów podpisywania.
  • Lista dozwolonych adresów IP. Ogranicz dostęp do adresu URL wyłącznie do adresów lub zakresów adresów, które Państwo podadzą, niezależnie od stosowanych mechanizmów uwierzytelniania. Zobacz Listy dozwolonych adresów IP.

Zobacz Uwierzytelnianie.

Treści formularzy i plików XML oraz dzielenie tablic

  • Formularze wysyłkowe, formularze do przesyłania plików oraz pliki XML są obecnie odczytywane do pól, które można mapować, dokładnie tak samo jak JSON. Treść wiadomości będąca poprawnym JSON-em jest nadal odczytywana jako JSON, więc zachowanie istniejących nadawców nie ulega zmianie.
  • Podziel tablice na serie. Proszę wskazać w nowym ustawieniu listę zawartą w ładunku, a każda pozycja z tej listy uruchomi własną serię Shopify Flow - maksymalnie 100 na jedno żądanie. Każda pozycja liczy się jako jedno wywołanie.

Zobacz Formaty treści i dzielenie tablic.

Szybsza aplikacja, przebudowana w oparciu o komponenty internetowe platformy Shopify

Cała aplikacja działa obecnie w oparciu o komponenty internetowe samego panelu administracyjnego Shopify, a nie w oparciu o oddzielną bibliotekę interfejsu. Ilość danych do załadowania jest mniejsza, dzięki czemu strony otwierają się szybciej, a każde pole, menu i okno dialogowe wygląda i działa tak samo jak pozostałe elementy Państwa panelu administracyjnego.

  • Edytor webhooków to narzędzie do tworzenia. Po lewej stronie znajdują się ustawienia; po prawej - karta Endpoint zawierająca adres URL i identyfikator webhooka, a powyżej - opcje „Podgląd na żywo”, „Test” i „Wykorzystanie” - dzięki czemu można zmienić ustawienie i jednocześnie obserwować, jak przychodzi żądanie.
  • Lista webhooków zawiera informacje o każdym webhooku wraz z liczbą wywołań, sposobem uwierzytelniania się wywołujących oraz datą ostatniej zmiany, a także menu w każdym wierszu umożliwiające edycję, włączenie, wyłączenie lub usunięcie.
  • Podłączanie nadawcy z podpisem. Webhook dla serwisu Stripe, GitHub lub innego dostawcy zawiera instrukcję podłączenia oraz przycisk prowadzący do przewodnika konfiguracji, zamiast przykładowego żądania, którego weryfikacja nigdy nie byłaby możliwa.

Ponadto w tej wersji

  • Zablokowane żądania na pulpicie nawigacyjnym. Żądania odrzucone z powodu przekroczenia limitu w ramach Państwa planu nie pozostawiały dotychczas żadnych śladów. Na pulpicie nawigacyjnym wyświetlana jest teraz liczba żądań zablokowanych w ciągu ostatnich 30 dni, a karta planu pełni funkcję wskaźnika wykorzystania.
  • Paginacja na liście webhooków działa, a opcja Wyczyść wszystko w historii powoduje również wyczyszczenie filtru „Odtworzone”.
  • Każda strona zawiera link do odpowiedniego przewodnika w centrum pomocy, a na stronie „Pomoc” znajduje się lista naszych pozostałych aplikacji dla Shopify Flow.
  • Rutynowa konserwacja systemu bezpieczeństwa. Nie wymagają Państwo podjęcia żadnych działań.

Przekazanie danych z procesu Shopify Flow do podmiotu wywołującego

Do tej pory webhook mógł jedynie potwierdzić otrzymanie żądania - Państwa przepływ pracy w Shopify Flow uruchamiał się następnie, a strona wywołująca nigdy nie otrzymywała informacji o wyniku. Odpowiedź synchroniczna zmienia tę sytuację: aplikacja utrzymuje żądanie w stanie otwartym do momentu, aż Państwa przepływ pracy prześle dane z powrotem, a następnie przekazuje je stronie wywołującej.

Rozwiązanie to sprawdza się zawsze, gdy strona wywołująca potrzebuje odpowiedzi, a nie potwierdzenia - formularza przedstawiającego wynik, systemu oczekującego na obliczoną wartość lub wyszukiwania.

Jak to działa

W sekcji „Ustawienia zaawansowane” webhooka proszę włączyć opcję Odpowiedź synchroniczna. Następnie proszę utworzyć przepływ pracy w oparciu o nowy wyzwalacz Sync Webhook i zakończyć go nową akcją Return Webhook Response.

Proszę wpisać treść odpowiedzi bezpośrednio w akcji, korzystając ze zmiennych wyzwalacza:

{"ok": true, "orderId": "{{fieldOne}}", "email": "{{fieldTwo}}"}

lub stworzyć coś bardziej złożonego w ramach akcji „Uruchom kod” i przypisać wynik.

Typowy czas trwania wymiany danych wynosi od dwóch do czterech sekund. Jeśli Państwa system nie udzieli odpowiedzi w ciągu 15 sekund, dzwoniący otrzyma po prostu standardową odpowiedź - nigdy nie pojawi się komunikat o błędzie ani nie dojdzie do zawieszenia połączenia.

Kompletny przewodnik: Odpowiedź synchroniczna

Nic się nie zmieni, dopóki tego nie włączy Pan/Pani

W każdym webhooku opcja ta jest domyślnie wyłączona. Istniejące webhooki nadal odpowiadają natychmiastowo i nadal korzystają ze standardowego wyzwalacza webhooków, dokładnie tak jak dotychczas.

Specjalny adres dla interfejsu API oraz obszerna dokumentacja

Interfejs API REST oraz serwer MCP mają teraz własną, stałą lokalizację:

https://shopify.workflow-webhooks.app

Zatem adres API to https://shopify.workflow-webhooks.app/api/v1, a serwer MCP - https://shopify.workflow-webhooks.app/api/mcp. Oba są wyświetlane wraz z przyciskiem „Kopiuj” na stronie dla programistów.

Wcześniej znajdowały się one w adresie URL osadzonym w aplikacji. Wyodrębnienie ich oznacza, że adres, który wkleja Pan/Pani do skryptu, zadania CI lub asystenta AI, jest stały i niezależny od sposobu osadzenia aplikacji w panelu administracyjnym. Nowa nazwa hosta obsługuje wyłącznie API - sama aplikacja pozostaje w dotychczasowej lokalizacji, a żadne z dotychczasowych ustawień nie wymaga zmiany.

Znacznie więcej materiałów informacyjnych

Na stronie docs.workflow-webhooks.app opublikowano dziewięć nowych stron:

  • Stwórz swój pierwszy webhook - od początku do końca, łącznie z konfiguracją po stronie Shopify Flow
  • Uwierzytelnianie - token statyczny, HMAC oraz gotowe ustawienia dla serwisów Stripe, GitHub, Shopify, Slack, Typeform i Calendly
  • Mapowanie danych użytkowych i zmienne w Shopify Flow - ścieżki z kropkami, wartości zagnieżdżone oraz co zrobić, gdy cztery pola to za mało
  • Ochrona przed podwójną dostawą
  • Historia i rozwiązywanie problemów - wszystkie kody błędów oraz sposoby postępowania w poszczególnych przypadkach
  • Wywołanie webhooka z serwisu Shopify Flow
  • Plany taryfowe i wykorzystanie - co wlicza się do limitu, a co nie
  • Aplikacje pomocnicze i asystenci oparci na sztucznej inteligencji
  • Najczęściej zadawane pytania

Opublikowano również przewodnik dotyczący interfejsu API dla programistów oraz programu MCP.

Zapobieganie powielaniu zdarzeń wynikających z dwukrotnego uruchomienia Shopify Flow

Większość systemów ponawia próbę wysłania webhooka, jeśli nie otrzymają szybkiej odpowiedzi. Jeśli pierwsza próba faktycznie dotarła, Państwa przepływ pracy w Shopify Flow zostanie uruchomiony dwukrotnie dla tego samego zdarzenia - spowoduje to wysłanie drugiego e-maila, dodanie drugiego tagu oraz utworzenie zduplikowanej notatki do zamówienia.

Funkcja ochrony przed zduplikowanymi dostawami rozwiązuje ten problem. Jeśli Państwa system wysyłający nadaje każdemu zdarzeniu unikalny identyfikator, prosimy o poinformowanie nas, w którym nagłówku się on znajduje, a my zignorujemy powtórzenia.

Proszę ustawić tę opcję w sekcji Ustawienia zaawansowane -> „Duplikuj dostarczenie przy każdym webhooku”. Proszę wpisać nazwę nagłówka używanego przez nadawcę - zazwyczaj jest to Event-Id, Idempotency-Key lub X-Request-Id.

  • Pierwsze żądanie o danym identyfikatorze przebiega normalnie.
  • Każda kolejna próba wysłania w ciągu 24 godzin powoduje otrzymanie standardowej odpowiedzi 200 OK, w związku z czym nadawca zaprzestaje wysyłania ponowna próba - jednak nie jest to ponownie wysyłane do Shopify Flow.
  • Usunięte duplikaty nie są wliczane do limitu Państwa planu.
  • Nadal można je zobaczyć: narzędzie Live Request Inspector wyświetla żądanie i oznacza je jako usunięto duplikat, dzięki czemu nie sprawia to wrażenia, jakby połączenie zniknęło.

Jeśli pozostawią Państwo to pole puste, nic się nie zmieni - każde żądanie będzie przetwarzane dokładnie tak samo jak dotychczas. Opcja ta jest domyślnie wyłączona we wszystkich istniejących webhookach.

Interfejs API dla programistów i serwer MCP

Zarządzaj Państwo swoimi webhookami za pomocą własnego kodu lub za pośrednictwem asystenta AI, takiego jak Claude czy Cursor.

  • Nowa strona dla programistów: prosimy o utworzenie kluczy API o ograniczonym zakresie oraz pobranie gotowych do skopiowania poleceń połączenia dla aplikacji Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI oraz OpenAI Codex.
  • Interfejs API REST pod adresem /api/v1 - wyświetlanie listy webhooków i zarządzanie nimi, przeglądanie historii wywołań oraz statystyk, wyświetlanie listy szablonów.
  • Serwer MCP pod adresem /api/mcp, dzięki czemu asystent AI może wykonać tę samą czynność w trakcie rozmowy.
  • Trzy poziomy uprawnień. Klucze z uprawnieniami do odczytu umożliwiają jedynie przeglądanie. Klucze z uprawnieniami do zapisu pozwalają ponadto tworzyć, aktualizować i usuwać webhooki. Klucze z uprawnieniami do wykonywania mogą dodatkowo uruchamiać wywołania testowe lub odtwarzać wcześniejsze wywołania - co faktycznie uruchamia Państwa przepływy pracy w Shopify Flow.
  • Państwa dane pozostają bezpieczne. Token uwierzytelniający webhooka nigdy nie jest odczytywany za pośrednictwem API, a dane osobowe zawarte w treści żądań (adresy e-mail, numery telefonów, imiona i nazwiska, numery kart) są maskowane przed opuszczeniem serwera.

Obecnie nosi nazwę Workflow Webhooks - nowa dokumentacja, centrum pomocy oraz czat w aplikacji

Aplikacja Flow Webhooks nosi teraz nazwę Workflow Webhooks. Ta sama aplikacja, ta sama instalacja, te same webhooki - nowa nazwa, dostosowana do pozostałych produktów z naszej serii Workflow.

  • Nowa strona z dokumentacją pod adresem docs.workflow-webhooks.app, zawierająca kompletne instrukcje dotyczące n8n, Make i Zapier, w tym przewodniki wideo.
  • Nowe Centrum pomocy - prosimy zgłaszać błędy, zgłaszać prośby o dodanie nowych funkcji lub kontaktować się z nami za pośrednictwem odpowiedniego formularza, który trafia bezpośrednio do nas, wraz z załączonymi zrzutami ekranu.
  • Czat w aplikacji - dymek czatu jest teraz widoczny na każdej stronie aplikacji i dyskretnie znika, gdy otwarte jest okno dialogowe.
  • Przewodnik konfiguracyjny dostępny na pulpicie nawigacyjnym, który poprowadzi Państwa krok po kroku od pierwszego webhooka aż do uruchomienia działającego przepływu pracy w Shopify Flow. Zapamiętuje on, czy został on zwinięty.

Aktualizacja zabezpieczeń

Rutynowa konserwacja zabezpieczeń: aktualizacje bibliotek oraz wzmocnienie zabezpieczeń w całej aplikacji. Nie wymagają Państwo podjęcia żadnych działań.

Powiadomienia o awariach, gotowe wzorce sygnatur oraz bardziej rozbudowane dane użytkowe

  • Powiadomienia e-mailowe - otrzymuj powiadomienia, gdy zbliżają się Państwo do limitu określonego w planie, gdy go osiągną Państwo oraz gdy liczba niepowodzeń webhooków wzrośnie ponad zwykły poziom. Proszę dodać dodatkowych odbiorców oprócz właściciela sklepu, z których każdy będzie miał własny link do rezygnacji z subskrypcji.
  • Wstępne ustawienia podpisu HMAC - dostosowują się do schematu podpisywania stosowanego przez typowych nadawców bez konieczności ręcznego definiowania formatu.
  • Włącz opcję przesyłania dodatkowych danych żądania - dla każdego webhooka proszę wybrać, czy nagłówki żądania, parametry ciągu zapytania oraz surowa treść żądania mają być przekazywane do Shopify Flow.
  • Przeszukaj historię wywołań według treści danych użytkowych.

Zapytaj Shopify Sidekick o swoje webhooki

Sidekick może teraz bezpośrednio odpowiadać na pytania dotyczące tej aplikacji. Proszę zadawać pytania takie jak: „Czy mam webhook dla mojego formularza kontaktowego?”, „Czy mój webhook n8n jest włączony?”, „Ile razy został uruchomiony w tym tygodniu?” lub „Dlaczego moje ostatnie wywołanie zakończyło się niepowodzeniem?”.

Tylko do odczytu - Sidekick może przeglądać Państwa webhooki, ich konfigurację oraz historię wywołań, ale nie może niczego zmieniać.

Nowa infrastruktura UE - szybsza i bardziej niezawodna

Usługa Workflow Webhooks działa obecnie na nowej europejskiej platformie chmurowej. Sposób korzystania z niej pozostaje bez zmian, jednak pod względem technicznym:

  • Przetwarzanie webhooków zostało przeniesione do zarządzanej kolejki z mechanizmem obsługi wiadomości niedostarczalnych, dzięki czemu żadne wywołanie nie zostanie nigdy pominięte bez powiadomienia.
  • Bazy danych i pamięci podręczne są przechowywane lokalnie w poszczególnych regionach UE i są szyfrowane w stanie spoczynku.
  • Tajemnice handlowe - Państwa tokeny statyczne i klucze HMAC - są obecnie szyfrowane za pomocą dedykowanej usługi zarządzania kluczami, a nie tylko przechowywane w postaci zaszyfrowanej na poziomie dysku.
  • Instancje redundantne w różnych strefach dostępności.

W rezultacie uzyskano mniejsze opóźnienie w odbiorze webhooków oraz znacznie lepszą wydajność przy dużym obciążeniu.

Konfigurowalny nagłówek uwierzytelniający oraz przesyłki, które same się naprawiają

  • Niestandardowy nagłówek z tokenem statycznym - nagłówek z tokenem nie musi już mieć nazwy X-Api-Key. W sekcji „Ustawienia zaawansowane” można ustawić własną nazwę dla każdego webhooka, tak aby odpowiadała nazwie wysyłanej przez system wysyłający. Nazwy nagłówków zarezerwowanych oraz kontrolowanych przez serwer proxy są odrzucane ze względów bezpieczeństwa.
  • Automatyczne odświeżanie sesji - tokeny dostępu są teraz odświeżane w tle, dzięki czemu w przypadku długotrwałych operacji nie dochodzi już do niepowodzeń w dostarczaniu danych po wygaśnięciu tokenu.
  • Inteligentniejsze ponawianie prób - w przypadku nieudanych dostaw próby są powtarzane z zachowaniem odstępu czasowego, natomiast w przypadku trwałych błędów natychmiast zaprzestaje się ponawiania prób, zamiast marnować limit prób.

Optymalizacja wydajności i wzmocnienie zabezpieczeń

  • Dodano indeksy bazy danych, które przyspieszają wykonywanie zapytań dotyczących historii i statystyk w sklepach o dużym natężeniu ruchu.
  • Dodano funkcję monitorowania wydajności z punktu widzenia rzeczywistych użytkowników, dzięki czemu możemy wykrywać wolno ładujące się strony w panelu administracyjnym.
  • Kontrola bezpieczeństwa w aplikacji: aktualizacja zależności oraz wyeliminowanie niebezpiecznego renderowania kodu HTML.

Przebudowano pulpit nawigacyjny oraz zabezpieczenie przed utratą niezapisanych zmian

  • Przeprojektowano pulpit nawigacyjny, wprowadzając karty wskaźników, narzędzie do wyboru zakresu dat oraz wykres wywołań.
  • Niezapisane zmiany są teraz chronione. Podczas edycji webhooka wyświetla się pasek zapisywania Shopify, a przejście do innej karty lub kliknięcie przycisku „Wstecz” przy oczekujących zmianach powoduje wyświetlenie monitu z pytaniem o potwierdzenie, zamiast cichego odrzucenia tych zmian.

Szybsze przetwarzanie danych historycznych dla sklepów o dużym natężeniu sprzedaży

Przeprowadzono ponowne indeksowanie historii webhooków. Sklepy o dużej liczbie wywołań zauważą, że strona historii oraz pulpit nawigacyjny ładują się znacznie szybciej.

Odtwórz dowolne wywołanie oraz skorzystaj z szablonów, aby rozpocząć pracę

  • Powtórz - otwórz dowolne wcześniejsze wywołanie i wyślij je ponownie jednym kliknięciem. Jest to najszybszy sposób na skonfigurowanie przepływu pracy w Shopify Flow: zarejestruj zdarzenia w Shopify Flow, a następnie powtórz rzeczywiste wywołanie zamiast ponownie uruchamiać system źródłowy.
  • Szablony webhooków - gotowe rozwiązania wyjściowe dla n8n, Make, Zapier, formularzy kontaktowych oraz integracji niestandardowych.

Poprawki dotyczące uwierzytelniania i ścieżki proxy

  • Naprawiono rzadki przypadek związany z uwierzytelnianiem, który mógł powodować odrzucanie prawidłowych żądań.
  • Naprawiono rozpoznawanie ścieżek proxy, dzięki czemu adresy URL proxy aplikacji są prawidłowo przekierowywane.
  • Naprawiono błąd wyświetlania na liście webhooków.

Wywoływanie webhooków z serwisu Shopify Flow oraz statystyki na pulpicie nawigacyjnym

  • Akcja w Shopify Flow - kierunek odwrotny. Proces w Shopify Flow może teraz wywoływać webhook jako etap akcji, dzięki czemu Shopify Flow może zarówno wysyłać dane, jak i być przez nie uruchamiany.
  • Statystyki na pulpicie nawigacyjnym - łączna liczba wywołań, wskaźnik powodzenia oraz wykres obejmujący wybrany przez Państwa zakres dat.
  • Śledzenie źródła wywołań - historia rejestruje teraz, czy wywołanie pochodziło z Shopify Flow, testu, polecenia curl czy systemu zewnętrznego, a Państwo mogą filtrować dane według tego kryterium.

Zagnieżdżony JSON zachowuje teraz swoją strukturę podczas przesyłania do serwisu Shopify Flow

Zmienne w Shopify Flow są prostymi ciągami znaków, dlatego zagnieżdżone obiekty i tablice nie nadawały się dotychczas do wykorzystania.

Wartości będące obiektami lub tablicami są obecnie wykrywane automatycznie i przekazywane do Shopify Flow jako ciągi JSON, dzięki czemu żadne dane nie są utracone w trakcie przesyłania bez Państwa wiedzy.

Plany i wykorzystanie

Wprowadzono plany subskrypcyjne z miesięcznym limitem wywołań oraz funkcję śledzenia wykorzystania na pulpicie nawigacyjnym, dzięki czemu mogą Państwo sprawdzić, na jakim etapie są Państwo w stosunku do swojego limitu.

Każdy plan obejmuje wszystkie metody uwierzytelniania, mapowanie pól, CORS, historię i odtwarzanie - plany różnią się jedynie miesięcznym limitem.

Adresy URL serwerów proxy aplikacji oraz filtrowanie według daty w historii

  • Punkt końcowy proxy aplikacji - do każdego webhooka można teraz uzyskać dostęp również poprzez adres URL proxy aplikacji Shopify, co pozwala uniknąć problemów związanych z różnicą pochodzenia w przypadku wywołań z przeglądarki.
  • Filtr zakresu dat na stronie historii, dzięki czemu można zawęzić wyniki do konkretnego dnia, w którym wystąpił problem, zamiast przewijać stronę.

Proszę przesłać dane o dowolnym kształcie, korzystając z opcji „Zezwól na niestandardową treść żądania”

Cztery przypisane pola nie zawsze są wystarczające. Proszę włączyć opcję Zezwól na niestandardową treść żądania w ustawieniach zabezpieczeń webhooka, a cała treść przychodzącego żądania zostanie przekazana do Shopify Flow, oprócz czterech nazwanych pól.

Rozwiązanie to jest przydatne w sytuacji, gdy nie mają Państwo wpływu na kształt ładunku danych wysyłanego przez system nadawczy.

Szybsze ładowanie stron i bardziej przejrzysty status webhooków

  • Konfiguracja webhooków jest teraz buforowana, dzięki czemu obsługa przychodzących wywołań wymaga mniejszego nakładu pracy i zapewnia szybszą reakcję.
  • Wyłączone webhooki są wyraźnie oznaczone na liście, dzięki czemu od razu widać, dlaczego dany webhook nie uruchamia się.
  • Przeprojektowano stronę szczegółów webhooka oraz wprowadzono szereg drobnych poprawek.

Workflow Webhooks 1.0 - uruchamiaj Shopify Flow z dowolnego miejsca

Pierwsza wersja. Usługa Shopify Flow reaguje wyłącznie na zdarzenia występujące w ramach platformy Shopify - niniejsza aktualizacja znosi to ograniczenie.

  • Punkty końcowe webhooków - każdy webhook otrzymuje własny, bezpieczny adres URL, na który dowolny system zewnętrzny może wysłać żądanie POST.
  • Trzy tryby uwierzytelniania - brak uwierzytelniania (do celów testowych), statyczny token w nagłówku X-Api-Key lub HMAC SHA256 zapewniający podpis zabezpieczony przed manipulacją.
  • Mapowanie danych - proszę zmapować maksymalnie cztery pola z otrzymanego pliku JSON i wykorzystać je w Shopify Flow jako {{fieldOne}} do {{fieldFour}}.
  • Historia wywołań - każde wywołanie jest rejestrowane wraz z nagłówkami, treścią, statusem i czasem wykonania.
  • Obsługa CORS - proszę włączyć tę funkcję, aby przyjmować połączenia bezpośrednio z przeglądarki lub formularza w sklepie internetowym.
  • Panel zarządzania webhookami - tworzenie, włączanie, wyłączanie oraz zbiorcze zarządzanie wszystkimi punktami końcowymi w jednym miejscu, wraz z generatorem tokenów dostępnym za pomocą jednego kliknięcia.