Tworzenie elementów webhook

Elementy webhook są narzędziem służącym do pobierania i przechowywania danych z określonego zdarzenia. Umożliwiają one rejestrację adresu URL https://, pod którym dane zdarzenia mogą być przechowywane w formatach JSON lub XML. Elementy webhook są często wykorzystywane w następujących zadaniach:

• Składanie zamówienia
• Zmiana ceny produktu
• Powiadamianie klienta IM lub wysyłanie informacji na pager, jeśli jesteś w trybie offline
• Gromadzenie danych dla hurtowni danych
• Integrowanie oprogramowania księgowego
• Filtrowanie pozycji zamówienia i informowanie spedytorów o zamówieniu
• Usuwanie danych klienta z bazy danych w przypadku odinstalowania przez niego Twojej aplikacji

Uwaga

Otrzymasz wiadomość e-mail na adres właściciela sklepu, gdy działanie elementu webhook nie powiedzie się. E-mail jest wysyłany tylko wtedy, gdy element webhook jest tworzony przez aplikację z Shopify App Store lub przez aplikację niestandardową. Jeśli miejsce docelowe elementu webhook wielokrotnie zwraca odpowiedź o statusie innym niż 200, subskrypcja elementu webhook jest automatycznie usuwana z panelu administracyjnego Shopify.

Obsługiwane zdarzenia związane z elementami webhook

Podczas tworzenia elementu webhook możesz wybrać dowolne z wymienionych zdarzeń. Na przykład, jeśli chcesz utworzyć element webhook, który jest wysyłany za każdym razem, gdy zamówienie zostało opłacone, wybierz opcję Płatność za zamówienie. Natomiast jeśli przykładowo chcesz utworzyć element webhook, który jest wysyłany za każdym razem, gdy właściwość sklepu jest aktualizowana, wybierz opcję Aktualizacja sklepu.

Tabela z listą obsługiwanych zdarzeń związanych z elementem webhook, które są dostępne w panelu administracyjnym Shopify.

Kategoria	Zdarzenia
Koszyk	Tworzenie koszyka Aktualizacja koszyka
Realizacja zakupu	Tworzenie realizacji zakupu Usuwanie strony realizacji zakupu Aktualizacja strony realizacji zakupu
Kolekcja	Tworzenie kolekcji Usuwanie kolekcji Aktualizacja kolekcji
Customer	Aktualizacja zgody klienta na otrzymywanie marketingowych wiadomości SMS Aktualizacja ustawień kont klientów Tworzenie klienta Usuwanie klienta Wyłączenie klienta Aktualizacja zgody klienta na otrzymywanie e-maili marketingowych Włączenie klienta Tworzenie grupy klientów Usuwanie grupy klientów Aktualizacja grupy klientów Tagi klienta zostały dodane Tagi klienta zostały usunięte Aktualizacja klienta
Rabat	Tworzenie rabatu Usunięcie rabatu Aktualizacja rabatu
Wersja robocza zamówienia	Tworzenie wersji roboczej zamówienia Usuwanie wersji roboczej zamówienia Aktualizacja wersji roboczej zamówienia
Realizacja	Tworzenie realizacji Zamówienie do realizacji nie może zostać wykonane przez usługę realizacji Pozycje pojedyncze zamówienia do realizacji są przygotowane do odbioru Przesunięto zamówienie do realizacji Zamówienie do realizacji wstrzymane Harmonogram zamówienia do realizacji został zmieniony Zaplanowane zamówienie do realizacji staje się wymagalne Wyznaczanie tras dla zamówień do realizacji zakończone Anulowano zamówienia do realizacji Zaakceptowano żądanie anulowania zamówień do realizacji Odrzucono żądanie anulowania zamówień do realizacji Przesłano żądanie anulowania zamówień do realizacji Zaakceptowano żądanie realizacji zamówień do realizacji Odrzucono żądanie realizacji zamówień do realizacji Przesłano żądanie realizacji zamówień do realizacji Anulowano wstrzymanie zamówień do realizacji Pozycje pojedyncze zamówienia do realizacji są przygotowane do lokalnej dostawy Połączono zamówienia do realizacji Podział zamówień do realizacji Aktualizacja realizacji
Zapasy	Tworzenie pozycji zapasów Usuwanie pozycji zapasów Aktualizacja pozycji zapasów Łączenie poziomu zapasów Rozłączenie poziomu zapasów Aktualizacja poziomu zapasów
Lokalizacja	Aktywacja lokalizacji Tworzenie lokalizacji Dezaktywacja lokalizacji Usuwanie lokalizacji Aktualizacja pozycji lokalizacji
Rynek	Tworzenie rynku Usuwanie rynku Aktualizacja rynku
Zamówienie	Anulowanie zamówienia Tworzenie zamówienia Usuwanie zamówienia Edycja zamówienia Realizacja zamówienia Płatność za zamówienie Zmieniono ocenę ryzyka zamówienia Aktualizacja zamówienia
Produkt	Tworzenie produktu Usuwanie produktu Aktualizacja produktu
Zwrot kosztów	Tworzenie zwrotu kosztów
Shop	Aktualizacja sklepu
Przetarg	Tworzenie transakcji płatniczej
Szablon	Tworzenie szablonu Usuwanie szablonu Publikowanie szablonu Aktualizacja szablonu
Transakcja	Tworzenie transakcji

Wskazówka

Programiści mogą zapoznać się z pełną listą tematów dotyczących elementów webhook podczas tworzenia subskrypcji elementów webhook.

Utwórz elementy webhook

Element webhook możesz utworzyć w dowolnym momencie. Elementy webhook są sygnowane identyfikatorem składającym się z kombinacji liter i cyfr, które są unikalne dla Twojego sklepu.

Kroki:

Pulpit

1. Z panelu administracyjnego Shopify przejdź do opcji Ustawienia >Powiadomienia.

2. Kliknij Elementy webhook.

3. Kliknij ⊕ Utwórz element webhook.

4. W menu rozwijanym Zdarzenie wybierz dowolne z obsługiwanych zdarzeń elementu webhook, którego chcesz użyć jako zdarzenia elementu webhook. Nie możesz zmienić zdarzenia elementu webhook po utworzeniu elementu webhook.

5. W menu rozwijanym Format wybierz format, w którym Shopify ma wysłać Ci te informacje. Możesz wybrać JSON lub XML.

6. W polu URL wprowadź adres URL, pod którym mają być przechowywane dane. Elementy webhook nie mogą być zwracane do następujących adresów URL:

   • Host lokalny
   • Dowolny adres URL kończący się słowem „internal” (np. adres example.com/internal)
   • Dowolny adres URL z dowolnej domeny niestandardowej dołączonej do sklepu
   • „Fałszywe” domeny (takie jak www.example.com)
   • Domeny Shopify (takie jak shopify.com i myshopify.com)

7. W opcji Wersja API elementu webhook wybierz preferowaną wersję elementu webhook.

8. Kliknij opcję Zapisz.

iPhone

1. W aplikacji Shopify naciśnij przycisk …, a następnie Ustawienia.
2. W sekcji Ustawienia sklepu naciśnij Powiadomienia.
3. Naciśnij Elementy webhook.
4. Naciśnij ⊕ Utwórz element webhook.
5. W menu rozwijanym Zdarzenie wybierz dowolne z obsługiwanych zdarzeń elementu webhook, którego chcesz użyć jako zdarzenia elementu webhook. Nie możesz zmienić zdarzenia elementu webhook po utworzeniu elementu webhook.
6. W menu rozwijanym Format wybierz format, w którym Shopify ma wysłać Ci te informacje. Możesz wybrać JSON lub XML.

7. W polu URL wprowadź adres URL, pod którym mają być przechowywane dane. Elementy webhook nie mogą być zwracane do następujących adresów URL:

   • Host lokalny
   • Dowolny adres URL kończący się słowem „internal” (np. adres example.com/internal)
   • Dowolny adres URL z dowolnej domeny niestandardowej dołączonej do sklepu
   • „Fałszywe” domeny (takie jak www.example.com)
   • Domeny Shopify (takie jak shopify.com i myshopify.com)

8. W opcji Wersja API elementu webhook wybierz preferowaną wersję elementu webhook.

9. Naciśnij Zapisz.

Android

1. W aplikacji Shopify naciśnij przycisk ☰, a następnie Ustawienia.
2. W sekcji Ustawienia sklepu naciśnij Powiadomienia.
3. Naciśnij Elementy webhook.
4. Naciśnij ⊕ Utwórz element webhook.
5. W menu rozwijanym Zdarzenie wybierz dowolne z obsługiwanych zdarzeń elementu webhook, którego chcesz użyć jako zdarzenia elementu webhook. Nie możesz zmienić zdarzenia elementu webhook po utworzeniu elementu webhook.
6. W menu rozwijanym Format wybierz format, w którym Shopify ma wysłać Ci te informacje. Możesz wybrać JSON lub XML.

7. W polu URL wprowadź adres URL, pod którym mają być przechowywane dane. Elementy webhook nie mogą być zwracane do następujących adresów URL:

   • Host lokalny
   • Dowolny adres URL kończący się słowem „internal” (np. adres example.com/internal)
   • Dowolny adres URL z dowolnej domeny niestandardowej dołączonej do sklepu
   • „Fałszywe” domeny (takie jak www.example.com)
   • Domeny Shopify (takie jak shopify.com i myshopify.com)

8. W opcji Wersja API elementu webhook wybierz preferowaną wersję elementu webhook.

9. Naciśnij ✓.

Po zapisaniu nowego elementu webhook jest on wyświetlany na stronie Elementy webhook.

Edytuj elementy webhook

Możesz edytować konfigurację elementu webhook po jego utworzeniu. Nie możesz jednak modyfikować wybranego zdarzenia elementu webhook.

Kroki:

Pulpit

1. Z panelu administracyjnego Shopify przejdź do opcji Ustawienia >Powiadomienia.

2. Kliknij Elementy webhook.

3. W wierszu zawierającym element webhook, który chcesz edytować, kliknij ... > Edytuj.

4. W oknie dialogowym Edytuj element webhook zmodyfikuj element webhook w razie potrzeby.

5. Kliknij opcję Zapisz.

iPhone

1. W aplikacji Shopify naciśnij przycisk …, a następnie Ustawienia.
2. W sekcji Ustawienia sklepu naciśnij Powiadomienia.
3. Naciśnij Elementy webhook.
4. W wierszu zawierającym element webhook, który chcesz edytować, naciśnij ... > Edytuj.
5. W oknie dialogowym Edytuj element webhook zmodyfikuj element webhook w razie potrzeby.
6. Naciśnij Zapisz.

Android

1. W aplikacji Shopify naciśnij przycisk ☰, a następnie Ustawienia.
2. W sekcji Ustawienia sklepu naciśnij Powiadomienia.
3. Naciśnij Elementy webhook.
4. W wierszu zawierającym element webhook, który chcesz edytować, naciśnij ... > Edytuj.
5. W oknie dialogowym Edytuj element webhook zmodyfikuj element webhook w razie potrzeby.
6. Naciśnij ✓.

Testuj elementy webhook

Możesz przetestować element webhook, aby upewnić się, że informacje o zdarzeniu, których potrzebujesz, są wysyłane na prawidłowy adres URL.

Kroki:

Pulpit

1. Z panelu administracyjnego Shopify przejdź do opcji Ustawienia >Powiadomienia.

2. Kliknij Elementy webhook.

3. W wierszu zawierającym element webhook, który chcesz przetestować, kliknij ... > Wyślij test.

4. Pod adresem URL określonym dla elementu webhook sprawdź, czy powiadomienie działa.

iPhone

1. W aplikacji Shopify naciśnij przycisk …, a następnie Ustawienia.
2. W sekcji Ustawienia sklepu naciśnij Powiadomienia.
3. Naciśnij Elementy webhook.
4. W wierszu zawierającym element webhook, który chcesz przetestować, naciśnij ... > Wyślij test.
5. Pod adresem URL określonym dla elementu webhook sprawdź, czy powiadomienie działa.

Android

1. W aplikacji Shopify naciśnij przycisk ☰, a następnie Ustawienia.
2. W sekcji Ustawienia sklepu naciśnij Powiadomienia.
3. Naciśnij Elementy webhook.
4. W wierszu zawierającym element webhook, który chcesz przetestować, naciśnij ... > Wyślij test.
5. Pod adresem URL określonym dla elementu webhook sprawdź, czy powiadomienie działa.

Usuń elementy webhook

Możesz usunąć element webhook z panelu administracyjnego Shopify. Tej czynności nie można cofnąć.

Uwaga

Jeśli miejsce docelowe elementu webhook wielokrotnie zwraca odpowiedź o statusie innym niż 200, subskrypcja elementu webhook jest automatycznie usuwana z panelu administracyjnego Shopify.

Kroki:

Pulpit

1. Z panelu administracyjnego Shopify przejdź do opcji Ustawienia >Powiadomienia.

2. Kliknij Elementy webhook.

3. W wierszu zawierającym element webhook, który chcesz usunąć, kliknij ... > Usuń.

iPhone

1. W aplikacji Shopify naciśnij przycisk …, a następnie Ustawienia.
2. W sekcji Ustawienia sklepu naciśnij Powiadomienia.
3. Naciśnij Elementy webhook.
4. W wierszu zawierającym element webhook, który chcesz usunąć, naciśnij ... > Usuń.

Android

1. W aplikacji Shopify naciśnij przycisk ☰, a następnie Ustawienia.
2. W sekcji Ustawienia sklepu naciśnij Powiadomienia.
3. Naciśnij Elementy webhook.
4. W wierszu zawierającym element webhook, który chcesz usunąć, naciśnij ... > Usuń.