Przestrzenie robocze w planie Business Pro obsługują do 30 000 zdarzeń webhook na okres rozliczeniowy. Przed skonfigurowaniem automatyzacji o dużej częstotliwości sprawdź limity swojego planu.
Obsługiwane zdarzenia
Możesz subskrybować webhook do dowolnej kombinacji następujących zdarzeń:Utwórz webhook
1
Przejdź do zarządzania webhookami
Na lewym pasku bocznym przejdź do Integracje → Zarządzanie webhookami.
2
Uwierzytelnij swój token
Kliknij przycisk Zarządzanie, aby uwierzytelnić swój token webhook. Ten token służy do podpisywania wychodzących ładunków, dzięki czemu możesz zweryfikować, że pochodzą z AgencyHandy.
3
Utwórz nowy webhook
Kliknij Utwórz nowy webhook, aby otworzyć formularz konfiguracji webhooka.
4
Wprowadź adres URL punktu końcowego
W polu Adres URL punktu końcowego wprowadź adres URL zewnętrznego systemu, który powinien odbierać dane webhooks. Musi to być publicznie dostępny punkt końcowy POST.
5
Wybierz typ zawartości
Wybierz JSON jako typ zawartości. AgencyHandy wysyła wszystkie ładunki webhooks jako
application/json.6
Wybierz zdarzenia webhooks
Wybierz każde zdarzenie, które powinno wyzwolić ten webhook. Możesz wybierać zdarzenia z wielu kategorii — na przykład Zamówienie: Utworzone i Faktura: Zmiana statusu mogą wskazywać na ten sam punkt końcowy.
7
Aktywuj webhook
Włącz przycisk radiowy Aktywny. Gdy jest aktywny, AgencyHandy dostarcza ładunki dla wszystkich wybranych zdarzeń do Twojego punktu końcowego w czasie rzeczywistym.
8
Zapisz konfigurację
Sprawdź ustawienia, a następnie kliknij Zapisz. Webhook pojawia się na liście i natychmiast zaczyna dostarczać zdarzenia.
Przetestuj webhook
Po utworzeniu webhooka wyślij testowy ładunek, aby potwierdzić, że Twój punkt końcowy jest dostępny i poprawnie przetwarza dane.1
Otwórz webhook
Na liście zarządzania webhookami kliknij webhook, który chcesz przetestować.
2
Kliknij Testuj zdarzenie
Kliknij przycisk Testuj zdarzenie na stronie szczegółów webhooka.
3
Wybierz zdarzenie testowe
Wybierz przykładowe zdarzenie z listy zdarzeń skonfigurowanych dla tego webhooka (np. Zamówienie: Utworzone).
4
Wyślij testowy ładunek
Kliknij Wyślij. AgencyHandy opublikuje przykładowy ładunek na Twoim adresie URL punktu końcowego.
5
Zweryfikuj wynik
Sprawdź swój zewnętrzny system, aby potwierdzić, że testowy ładunek dotarł i został przetworzony zgodnie z oczekiwaniami. W AgencyHandy kliknij webhook, aby przejrzeć jego historię — możesz zobaczyć pełne żądanie, odpowiedź zwróconą przez Twój punkt końcowy i ponownie dostarczyć dowolne poprzednie zdarzenie, jeśli zajdzie taka potrzeba.
Uwierzytelniaj ładunki webhooków
Każde wychodzące żądanie webhook z AgencyHandy zawiera nagłówek sygnatury, którego Twój punkt końcowy może użyć do weryfikacji, że ładunek jest autentyczny i nie został zmodyfikowany.Nagłówek sygnatury
Zweryfikuj sygnaturę webhooka
Wyślij następujące żądanie, aby potwierdzić autentyczność ładunku:string
wymagane
Identyfikator webhooka, który otrzymał zdarzenie. Znajdziesz go na stronie szczegółów webhooka w AgencyHandy.
string
wymagane
Wartość nagłówka
x-ah-sig z przychodzącego żądania webhooka.string
wymagane
Sekret webhooka widoczny na stronie szczegółów webhooka w AgencyHandy.
object
wymagane
Surowe ciało JSON odebrane z żądania webhooka AgencyHandy.
string
SUCCESS gdy sygnatura jest prawidłowa. FAILED gdy weryfikacja nie powiedzie się (HTTP 403).Success (200)
Failure (403)
Ważne uwagi
- Adres URL Twojego punktu końcowego musi być publicznie dostępnym adresem URL HTTPS POST.
- Jeśli Twój punkt końcowy jest tymczasowo niedostępny, sprawdź panel historii webhooka w AgencyHandy — możesz ponownie dostarczyć dowolne poprzednie zdarzenie bezpośrednio stamtąd.
- Regularnie monitoruj aktywność webhooków, aby wykrywać nieudane dostarczenia lub nieautoryzowane próby dostępu.
- Webhooks, które wielokrotnie kończą się niepowodzeniem, mogą zostać wstrzymane przez AgencyHandy — przeglądaj dzienniki dostaw, aby wcześnie wykrywać problemy.

