Co robi webhook
Webhook wysyła szczegóły zdarzenia w Twoim sklepie w inne miejsce w chwili, gdy ono nastąpi. Ty wybierasz zdarzenie i miejsce docelowe:
- API: Storeep wysyła dane zdarzenia na adres internetowy (URL) Twojego serwera, CRM, scenariusza Zapier lub Make albo narzędzia do śledzenia reklam.
- E-mail: Storeep wysyła dane zdarzenia na adres e-mail, na przykład abyś dostawał e-mail przy każdym nowym zamówieniu.
Otwórz Ustawienia > Webhooki. Potrzebujesz uprawnienia Ustawienia.
Wiele narzędzi ma już gotową aplikację, co jest prostsze: Google Sheets, sieci kurierskie i piksele reklamowe. Najpierw sprawdź sklep z aplikacjami.
Tworzenie webhooka
Kliknij Dodaj nowy webhook, wypełnij formularz i kliknij Dodaj.
- Aktywuj: domyślnie zaznaczone. Gdy jest zaznaczone, zdarzenia są wysyłane od razu. Odznacz je, aby zachować webhook, ale go wstrzymać.
- Imię: etykieta na liście, na przykład "Nowe zamówienia do CRM".
- Typ: API albo E-mail.
- Zdarzenie:
- Zamówienie zostało utworzone: klient składa nowe zamówienie.
- Zamówienie zaktualizowane: zmienia się status lub szczegóły zamówienia.
- Sesja utworzona: nowy odwiedzający wchodzi do Twojego sklepu. Tylko typ API.
- Format: Json.
- URL (typ API): adres docelowy. Część
https://jest dodawana automatycznie, więc wpisz resztę, na przykładapi.example.com/orders. - Adres e-mail (typ E-mail): adres, na który trafia e-mail.
Webhook E-mail wysyła tylko zdarzenia zamówień. Jeśli wybierzesz E-mail razem ze zdarzeniem Sesja utworzona, nic nie zostanie wysłane.
Umieszczanie danych zamówienia w adresie URL
Dowolne pole danych zdarzenia możesz umieścić w adresie URL w podwójnych nawiasach klamrowych, {{field_name}}. Na przykład:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Wysyła to identyfikator kliknięcia z Facebooka i sumę zamówienia do platformy śledzenia reklam lub platformy partnerskiej, bez dodatkowego serwera. Pole, które nie istnieje, będzie puste. Aby poznać nazwy pól, utwórz webhook E-mail dla tego samego zdarzenia i sprawdź otrzymane dane.
Lista webhooków
Każdy wiersz pokazuje kolumny Imię, URL / E-mail, Typ, Zdarzenie, Format i Stan (Aktywowane lub Dezaktywowane). Kliknij wiersz, aby go edytować. Zaznacz wiersze i wybierz Usuń webhooki, aby usunąć je na stałe. Liczba webhooków na sklep jest ograniczona, a po osiągnięciu limitu zobaczysz komunikat.
Możesz utworzyć kilka webhooków dla tego samego zdarzenia, na przykład jeden do CRM i jeden do narzędzia śledzenia reklam.
Gdy dostarczenie się nie uda
- Twój serwer powinien szybko odpowiedzieć kodem powodzenia (2xx). Wolna odpowiedź jest liczona jako błąd.
- Jeśli Twój serwer nie działa lub jest przeciążony (odpowiedź 5xx lub 429 albo brak odpowiedzi), Storeep ponawia próbę kilka razy w ciągu kolejnych minut. Ponawiane są tylko webhooki, które zawiodły, więc pozostałe nie dostają duplikatów.
- Jeśli Twój serwer odrzuci żądanie (odpowiedź 4xx, na przykład 404 lub 403), Storeep nie ponawia próby, bo błędny jest adres lub jego zabezpieczenia.
- Gdy webhook zawiedzie kilka razy z rzędu, właściciel sklepu dostaje jeden e-mail: "Wymagane działanie: Twój webhook Storeep nie działa", z nazwą webhooka, adresem, zdarzeniem i ostatnim kodem błędu. Gdy webhook znów zacznie działać, przyszły problem może wysłać nowe ostrzeżenie. Możesz wyłączyć ten e-mail w Powiadomieniach.
- Webhooki E-mail są wysyłane raz, bez ponownych prób.
Webhooki wstrzymane przez nieopłacone saldo
Jeśli Twój sklep ma nieopłaconą należną kwotę, a portfel nie może jej pokryć, webhooki czekają. Zostaną wysłane, gdy dodasz środki i kwota zostanie uregulowana. Zobacz Portfel i rozliczenia.
Wskazówki
- Jeśli Twój serwer wymaga hasła lub klucza, umieść go w parametrach adresu URL, na przykład
?key=yoursecret. - Sesja utworzona uruchamia się przy każdym odwiedzającym, co w ruchliwym sklepie może oznaczać bardzo dużo zdarzeń. Używaj go tylko wtedy, gdy Twój serwer sobie z tym poradzi.
- Aby narzędzie mogło odczytywać Twoje zamówienia i produkty, kiedy tylko chce, użyj zamiast tego tokenu dostępu.