Wprowadzenie do Workflow Webhooks

Shopify Flow to potężne narzędzie, ale reaguje wyłącznie na zdarzenia występujące w ramach platformy Shopify. Workflow Webhooks((url)) eliminuje to ograniczenie. Zapewnia ono bezpieczny punkt końcowy URL, do którego systemy zewnętrzne mogą wysyłać żądania typu POST - a gdy to zrobią, Państwa przepływ pracy w Shopify Flow uruchamia się natychmiast, a dane zawarte w żądaniu są przekazywane jako zmienne, z których można korzystać.

Jak to działa

• Państwa narzędzie zewnętrzne wysyła żądanie HTTP POST na adres URL Państwa webhooka wraz z danymi w formacie JSON (np. imię i nazwisko, adres e-mail, pytanie). Współpracuje z n8n, Make, Zapier oraz każdym narzędziem obsługującym protokół HTTP.
• Usługa Workflow Webhooks odbiera żądanie, uwierzytelnia je i rejestruje wraz z pełnymi nagłówkami oraz dane użytkowe, a następnie uruchamia powiązany wyzwalacz Shopify Flow.
• Shopify Flow zarządza procesami automatyzacji - przypisuje klientowi tag, wysyła wiadomość e-mail, aktualizuje metapole - wykorzystanie danych ładunku jako zmiennych nazwanych ({{fieldOne}}, {{fieldTwo}}, {{fieldThree}}, {{fieldFour}}). Można również przesłać dodatkowe dane, zaznaczając opcję Bezpieczeństwo -> Zezwól na niestandardową treść żądania w webhooku.
• Jeden punkt końcowy webhooka może obsługiwać dowolną automatyzację w ramach Shopify Flow.

Funkcje

Funkcja	Opis
Wyzwalacze webhooków dla Shopify Flow	Zabezpieczone punkty końcowe HTTP, które uruchamiają dowolną automatyzację w ramach Shopify Flow na żądanie
Mapowanie zmiennych	Należy przypisać pola danych do zmiennych Shopify Flow i odwoływać się do nich jako {{fieldOne}}, {{fieldTwo}} itd.
Uwierzytelnianie	Token statyczny (prosty) lub HMAC SHA256 (odporny na manipulacje)
Historia wywołań	Pełny dziennik wszystkich żądań - sygnał czasowy, treść żądania, nagłówki i status
Obsługa CORS	Włącz integrację z przeglądarką lub interfejsem użytkownika
Treść żądania niestandardowego	Obsługa elastycznych struktur ładunku z platform innych dostawców
Pulpit nawigacyjny Webhook	Zarządzanie, monitorowanie i testowanie wszystkich punktów końcowych w jednym miejscu
Ochrona przed duplikatami	Proszę zignorować powtarzające się dostawy, które zawierają identyfikator zdarzenia, który już Państwo widzieli

---

Uwierzytelnianie

Metoda	Jak to działa	Najlepiej nadaje się do
Brak	Brak uwierzytelnienia	Wyłącznie do celów testowych, nie do użytku produkcyjnego
Token statyczny ✓	Poprawiono token w nagłówku X-Api-Key	Większość integracji (n8n, Make, Zapier)
HMAC SHA256	Podpis utworzony na podstawie danych użytkowych i klucza tajnego	Wysoki poziom bezpieczeństwa lub zgodność z przepisami

Mapowanie zmiennych

Funkcja Workflow Webhooks umożliwia przypisanie pól w otrzymywanych danych JSON do nazwanych zmiennych, z których może korzystać Shopify Flow. W zakładce „Ustawienia zaawansowane” można zdefiniować maksymalnie 4 nazwy pól. Można również przesłać dodatkowe dane, zaznaczając opcję Bezpieczeństwo → Zezwól na niestandardową treść żądania.

Pole w aplikacji	Pański klucz ładunku	Odwołanie w Shopify Flow
Pole 1	name	{{fieldOne}}
Pole 2	email	{{fieldTwo}}
Pole 3	question	{{fieldThree}}
Pole 4	other	{{fieldFour}}

Ochrona przed podwójną dostawą

Większość systemów ponawia próbę wysłania webhooka, gdy 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.

Jeśli Państwa system wysyłający zawiera unikalny identyfikator dla każdego zdarzenia, proszę nadać taki identyfikator w sekcji Ustawienia zaawansowane → Wykrywanie zduplikowanych dostaw w webhooku**,** a powtórzenia zostaną zignorowane.

	Zachowanie
Pierwsze żądanie o podanym identyfikatorze	Przetworzono w standardowy sposób, uruchomiono Shopify Flow
Proszę powtórzyć w ciągu 24 godzin	200 OK z duplicate: true - nie zostało przesłane do Shopify Flow
Inny identyfikator	Przetworzono w zwykły sposób
W żądaniu nie ma takiego nagłówka	Przetworzono w zwykły sposób

Typowe nazwy nagłówków: Event-Id, Idempotency-Key, X-Request-Id. Podczas porównywania nie uwzględnia się wielkości liter.

# Second call with the same Event-Id is accepted but not re-sent to Flow
curl -X POST https://.../webhook/<short> \
  -H "Content-Type: application/json" \
  -H "Event-Id: evt_12345" \
  -d '{"orderId":"1001"}'

Typowe przykłady zastosowań

• Proszę oznaczyć lub zaktualizować dane klienta Shopify po przesłaniu formularza z zewnętrznego źródła
• Uruchamianie zleceń lub działań związanych z realizacją zamówień z poziomu przepływu pracy w n8n lub Make
• Synchronizuj dane kontaktowe z systemu CRM lub centrum obsługi klienta z platformą Shopify, gdy nastąpi zmiana w rekordzie
• Uruchom proces w Shopify Flow po zakończeniu automatyzacji w Zapier
• Uruchamianie automatyzacji z poziomu formularza interfejsu użytkownika (z włączoną obsługą CORS)
• Zastąp wiele integracji o jednym przeznaczeniu jednym, ujednoliconym menedżerem webhooków

Przewodniki po integracji krok po kroku

1. Jak połączyć n8n z funkcją Workflow Webhooks
2. Jak połączyć Make z funkcją Workflow Webhooks
3. Jak połączyć Zapier z usługą Workflow Webhooks

Co mówią sprzedawcy

„Ta aplikacja sprawia, że Shopify Flow staje się pięć razy bardziej przydatny. Bardzo łatwo jest skontaktować się z jej twórcą” „…i niezwykle pomocne” - SuperFast Startup, Portugalia

„Brakujący element w Shopify Flow - wystarczy jeden Shopify Flow, aby współpracować ze wszystkimi „Państwa webhooki” - Senkels, Austria

„Właśnie to próbowałem rozwiązać za pomocą szeregu aplikacji innych producentów. Bardzo „polecam” - Aloha Tinyboards, Stany Zjednoczone

Zainstaluj

Zainstaluj aplikację Workflow Webhooks ze sklepu Shopify App Store

Pomoc techniczna

Potrzebują Państwo pomocy? Proszę zapoznać się z sekcją Wsparcie lub skorzystać z ikony czatu dostępnej na dowolnej stronie aplikacji w panelu administracyjnym Shopify.