Jak połączyć Svix zShopify Flow

Svix to infrastruktura webhooków stanowiąca podstawę działania serwisów Clerk, Resend, Superwall oraz wielu innych produktów. Jeśli Państwa nadawca korzysta z usług Svix, to ustawienie to pozwala to zweryfikować. Funkcja Workflow Webhooks przekształca to 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ć każdą czynność, do której umożliwia Shopify Flow.

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

Co można zbudować

• Proszę oznaczyć klienta Shopify, gdy aplikacja Clerk zgłosi, że zarejestrował się on lub zweryfikował swój adres e-mail w Państwa aplikacji.
• Proszę zareagować na zdarzenie związane z ponownym wysłaniem przesyłki lub zwrotem przesyłki oraz oznaczyć klienta, którego adres jest nieprawidłowy.
• Odbieraj dane z dowolnego produktu opartego na technologii Svix bez konieczności konfigurowania niestandardowego podpisu.

Typowe zdarzenia do wysłania: dowolne zdarzenie zdefiniowane przez usługę wysyłającą.

Ten sam profil weryfikuje również webhooki z serwisów Clerk, Resend i Superwall.

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 Svix 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 Svix events.
2. W sekcji Uwierzytelnianie proszę wybrać opcję HMAC.
3. W sekcji Dostawca podpisu proszę wybrać Svix. Aplikacja automatycznie wypełni pola dotyczące nagłówka, algorytmu, podpisanej treści oraz okna odtwarzania - nie ma potrzeby konfigurowania niczego więcej.
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 - Dodanie punktu końcowego w Svix

Proszę dodać ten adres URL jako punkt końcowy w ustawieniach webhooka usługi wysyłającej, a następnie wyświetlić i skopiować jej klucz podpisujący (zaczyna się on od whsec_).

Jak znaleźć swój klucz tajny do podpisywania w systemie Svix

Klucz tajny do podpisywania punktów końcowych, którego nazwa zaczyna się od „whsec_”, pochodzący z ustawień webhooka tej usługi.

Własna dokumentacja serwisu Svix dotycząca podpisów webhooków zawiera dokładne sformułowania oraz zrzuty ekranu dotyczące Państwa konta.

Wklej ten klucz tajny w polu Secret (Klucz tajny) webhooka w sekcji Workflow Webhooks i zapisz zmiany. Od tego momentu każda dostawa z serwisu Svix będzie weryfikowana przed dotarciem do Shopify Flow.

Co to sprawdza

Co	Wartość
Nagłówek podpisu	svix-signature
Miejsce umieszczenia podpisu	Wartość nagłówka, po przedrostku v1,
Co zostało podpisane	{header:svix-id}.{timestamp}.{body}
Podpis	HMAC-SHA256, zakodowany w formacie base64
Sygnatura czasowa	Nagłówek svix-timestamp, wyrażony w sekundach systemu Unix
Ochrona przed ponownym odtworzeniem	Żądania, których podpisany znacznik czasu odbiega od chwili obecnej o ponad 5 minut, są odrzucane
Sekret	Przed użyciem należy zdekodować kod Base64. Przed dekodowaniem usuwa się przedrostek whsec_. Proszę wkleić tekst dokładnie tak, jak przedstawił go nadawca.

W podpisanej treści żądania {body} stanowi surową treść żądania, bajt po bajcie, {timestamp} to powyższy znacznik czasu, a {header:svix-id} to nagłówek żądania svix-id.

Żą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 serwisu Svix (lub skorzystać z opcji Wyślij test 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 prosimy o dodanie pierwszego warunku opartego na identyfikatorze webhooka, aby ten przepływ pracy dotyczył wyłącznie Svix. 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 systemie Svix. 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 podaną przyczyną, a Weryfikacja podpisanych webhooków zawiera wyjaśnienie dotyczące 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 Svix ponawia próbę dostarczenia wiadomości.
• Historia i rozwiązywanie problemów - dziennik wszystkich żądań wraz z możliwością odtworzenia.