- Kategoria
- API
- Kierunek
- Wysyłanie zdarzeń
- Format
- JSON podpisany HMAC-SHA256
- Adresy
- Do 25 na organizację
- Ponowienia
- Do 6 prób, w ciągu ponad doby
- Konfiguracja
- Adres HTTPS i sekret
- Plany
- Plan Enterprise
- Wydawca
- Upsellr
01Co robią webhooki
Sygnał, który napędza narzędzia.
- 01
Zdarzenie po zakończeniu każdego procesu
Zakończony, nieudany lub zatrzymany: po każdym procesie wzbogacania lub generowania Upsellr wysyła zdarzenie ze szczegółami procesu.
- 02
Podpisane, aby można je było zweryfikować
Każda wysyłka zawiera identyfikator, znacznik czasu i podpis HMAC-SHA256 obliczony z użyciem sekretu: narzędzie sprawdza, czy naprawdę pochodzi od Upsellr.
- 03
Ponawiane aż do odebrania
Bez odpowiedzi 2xx w ciągu 10 sekund Upsellr ponawia wysyłkę po 1 minucie, 5 minutach, 30 minutach, 4 godzinach, a potem po 24 godzinach.
- 04
Dziennik każdej wysyłki
Status, kod HTTP, liczba prób i treść: każdą dostawę można przejrzeć przez 7 dni, a nieudaną wysyłkę ponowić jednym kliknięciem.
- 05
Łącz narzędzia w łańcuch
Publikuj, powiadamiaj zespół lub uruchamiaj eksport, gdy tylko karty są gotowe: webhook daje sygnał, narzędzie robi resztę.
- 06
Zachowaj kontrolę
Wyłącz adres, zmień jego sekret lub go usuń: oczekujące ponowienia zostaną anulowane.
02Pierwsze kroki
Podłączone w kilka minut.
- 01
Otwórz ustawienia organizacji
Sekcja API i webhooki, dostępna tylko dla właścicieli i administratorów.
- 02
Dodaj adres
Adres URL w HTTPS, dostępny z internetu.
- 03
Skopiuj sekret
Wyświetla się tylko raz i służy do weryfikacji podpisu każdej wysyłki.
- 04
Zweryfikuj podpis
Oblicz ponownie podpis HMAC-SHA256 znacznika czasu i treści oraz odrzuć zbyt starą wysyłkę.
- 05
Odpowiadaj szybko
Odpowiedź 2xx w mniej niż 10 sekund, a dalsze przetwarzanie po własnej stronie.
03Zdarzenia
Wysyłane zdarzenia.
| Zdarzenie | Wysyłane | Ponawiane w razie potrzeby |
|---|---|---|
| Proces zakończony (workflow.run.completed) | Tak | Tak |
| Proces nieudany (workflow.run.failed) | Tak | Tak |
| Proces zatrzymany (workflow.run.stopped) | Tak | Tak |
Kompatybilność i wymagania
- Plan Enterprise
- Publiczny adres HTTPS, na porcie 443
- Rola właściciela lub administratora
- Odpowiedź 2xx w mniej niż 10 sekund
- Wskazówka: deduplikuj po identyfikatorze zdarzenia
Masz pełną kontrolę
Niezawodne z założenia.
- Podpisywane HMAC-SHA256, z osobnym sekretem dla każdego adresu
- Dostarczane co najmniej raz: deduplikuj po identyfikatorze zdarzenia
- Ponawiane do 6 razy, w ciągu ponad doby
- Wysyłane przez HTTPS, wyłącznie na adresy publiczne
04Pytania
Pytania o webhooki Upsellr.
Czy webhooki są dostępne w moim planie?
Tak jak API, są dostępne wyłącznie w planie Enterprise.
Jakie zdarzenia są wysyłane?
Zakończenie procesu wzbogacania lub generowania: zakończony, nieudany lub zatrzymany. Każde zdarzenie zawiera szczegóły procesu.
Jak sprawdzić, czy wysyłka pochodzi od Upsellr?
Oblicz ponownie podpis HMAC-SHA256 znacznika czasu i treści z użyciem sekretu, porównaj go z nagłówkiem X-Upsellr-Signature i odrzuć wysyłkę starszą niż 5 minut.
Co się stanie, jeśli serwer nie odpowie?
Bez odpowiedzi 2xx w ciągu 10 sekund Upsellr ponawia wysyłkę po 1 minucie, 5 minutach, 30 minutach, 4 godzinach, a potem po 24 godzinach. Nieudaną wysyłkę można też ponowić ręcznie z dziennika.
Czy mogę otrzymać to samo zdarzenie dwa razy?
Tak, to możliwe: dostarczenie jest gwarantowane co najmniej raz, bez gwarancji kolejności. Deduplikuj po identyfikatorze zdarzenia.
Jak długo przechowywany jest dziennik?
7 dni, ze statusem, kodem HTTP, liczbą prób i treścią każdej wysyłki.
Ile adresów mogę dodać?
Do 25 na organizację, każdy z własnym sekretem, który można odnowić.
Czy test w edytorze workflow wysyła zdarzenie?
Nie. Zdarzenia wysyłają tylko rzeczywiste procesy.
Twój kolejny produkt
zasługuje na więcej niż kopiuj-wklej.
Daj swojemu zespołowi AI pierwsze produkty do pracy.
Marcus
Amazon