Jak połączyć Shopify z Shopify Flow

Shopify podpisuje własne webhooki oraz wywołania między aplikacjami przy użyciu tajnego klucza API Państwa aplikacji. To ustawienie pozwala na odbieranie webhooków z innego sklepu Shopify lub z Państwa własnej aplikacji oraz weryfikowanie ich dokładnie zgodnie z dokumentacją Shopify. Workflow Webhooks przekształca takie wywołanie w wyzwalacz Shopify Flow, dzięki czemu Państwa sklep może na nie zareagować: oznaczyć klienta, dodać notatkę do zamówienia, wysłać wewnętrzną wiadomość e-mail, zaktualizować metapole - czyli wykonać dowolną czynność, do której umożliwia Shopify Flow.

W niniejszym przewodniku opisano całą ścieżkę działania - Shopify wysyła dane, Workflow Webhooks je odbiera i weryfikuje, a Shopify Flow podejmuje odpowiednie działania - przy czym w każdym żądaniu sprawdzany jest podpis HMAC serwisu Shopify, dzięki czemu wyłącznie Shopify może uruchomić Państwa przepływ pracy.

Co można zbudować

• Proszę skopiować zamówienie z drugiego sklepu Shopify do tego sklepu: proszę oznaczyć klienta, dodać notatkę lub uruchomić proces realizacji zamówienia.
• Aby zareagować w Shopify Flow na temat, którego Shopify Flow sam nie oferuje jako wyzwalacza, należy zasubskrybować go za pomocą własnej aplikacji.
• Zapewnij spójne działanie sklepu hurtowego i detalicznego bez konieczności tworzenia usługi pośredniczącej.

Typowe zdarzenia, które należy wysyłać: orders/create, products/update, customers/create, fulfillments/create.

Zanim zaczną Państwo

• Webhooki Workflow Webhooks zainstalowane w Państwa sklepie Shopify.
• Zainstalowano aplikację Shopify Flow, którą można pobrać bezpłatnie ze sklepu Shopify App Store.
• Konto w serwisie Shopify z uprawnieniami do tworzenia webhooków.

Krok 1 - Utwórz webhook w sekcji Workflow Webhooks

1. Proszę otworzyć sekcję Workflow Webhooks → Webhooks → Utwórz webhook i nadać mu nazwę, którą będą Państwo w stanie rozpoznać w Shopify Flow, na przykład Shopify events.
2. W sekcji Uwierzytelnianie proszę wybrać opcję HMAC.
3. W sekcji Dostawca podpisu proszę wybrać opcję Shopify. Aplikacja automatycznie wypełni pola „nagłówek”, „algorytm”, „podpisany ładunek” oraz „okno odtworzenia” - nie ma potrzeby konfigurowania żadnych innych ustawień.
4. Na razie proszę pozostawić pole „secret” puste i kliknąć Zapisz. Proszę skopiować adres URL webhooka wyświetlony na stronie.

Informacje na temat pozostałych trybów uwierzytelniania można znaleźć w sekcji Uwierzytelnianie, a informacje dotyczące wyboru pól, które mają zostać przesłane do Shopify Flow - w sekcji Mapowanie danych użytkowych i zmienne w Shopify Flow.

Krok 2 - Dodaj punkt końcowy w Shopify

Proszę utworzyć subskrypcję webhooka w sklepie lub aplikacji wysyłającej, podając skopiowany adres URL, a następnie podpisać ją kluczem API tej aplikacji.

Jak znaleźć swój klucz tajny do logowania w Shopify

Klucz tajny API Państwa aplikacji / klucz tajny do podpisywania webhooków.

W dokumentacji Shopify dotyczącej podpisów webhooków znajdą Państwo dokładne sformułowania oraz zrzuty ekranu dotyczące Państwa konta.

Wklej ten klucz do pola Secret (Klucz) webhooka w sekcji Workflow Webhooks i zapisz zmiany. Od tego momentu każda dostawa z Shopify będzie weryfikowana, zanim trafi do Shopify Flow.

Co to sprawdza

Co	Wartość
Nagłówek podpisu	X-Shopify-Hmac-Sha256
Miejsce umieszczenia podpisu	Cała wartość nagłówka
Co zostało podpisane	{body}
Podpis	HMAC-SHA256, zakodowany w formacie base64
Sygnatura czasowa	Nie jest używane przez tego nadawcę
Ochrona przed ponownym odtworzeniem	Brak - ten nadawca nie podpisuje znacznika czasu, więc każdy ważny podpis zachowuje swoją ważność
Sekret	Należy użyć jako zwykły tekst. Proszę wkleić go dokładnie tak, jak przedstawił go nadawca

W podpisanej treści żądania {body} stanowi surową treść żądania, bajt po bajcie.

Żądanie, które nie spełnia któregokolwiek z tych warunków, jest odrzucane z kodem błędu 401, rejestrowane w sekcji Historia i rozwiązywanie problemów i nigdy nie uruchamia przepływu pracy.

Krok 3 - Utwórz proces w Shopify Flow

1. W Shopify Flow proszę utworzyć przepływ pracy i wybrać wyzwalacz Workflow Webhooks.
2. Proszę kliknąć opcję Rejestruj zdarzenia, a następnie wysłać zdarzenie testowe z Shopify (lub skorzystać z opcji Wyślij zdarzenie testowe w sekcji Workflow Webhooks), aby Shopify Flow rozpoznał strukturę Państwa danych.
3. Każdy posiadany przez Państwa webhook uruchamia ten sam wyzwalacz w Shopify Flow, dlatego proszę dodać pierwszy warunek oparty na identyfikatorze webhooka, aby ograniczyć ten przepływ pracy wyłącznie do Shopify. Identyfikator ten jest widoczny na stronie webhooka.
4. Proszę dodać swoje działania - oznaczyć klienta, dodać notatkę, wysłać wewnętrzną wiadomość e-mail, zaktualizować metapole.

Krok 4 - Przeprowadź test od początku do końca

Wywołaj rzeczywiste zdarzenie w Shopify. W sekcji Workflow Webhooks → Historia powinno pojawić się wywołanie o statusie Success. Jeśli podpis był nieprawidłowy, pojawi się zamiast tego wpis o niepowodzeniu wraz z przyczyną, a Weryfikacja podpisanych webhooków zawiera wyjaśnienie narzędzia do weryfikacji podpisu, które wskazuje dokładnie, który etap zakończył się niepowodzeniem.

Powiązane

• Weryfikacja podpisanych webhooków - każdy dostawca, którego weryfikujemy, oraz sposób opisania dostawcy, którego nie weryfikujemy.
• Mapowanie danych użytkowych i zmienne w Shopify Flow - pobieranie odpowiednich pól z danych przesyłanych i wprowadzanie ich do Shopify Flow.
• Ochrona przed podwójną dostawą - co się dzieje, gdy Shopify ponawia próbę dostawy.
• Historia i rozwiązywanie problemów - dziennik wszystkich żądań wraz z możliwością odtworzenia.