Wysyłaj zdarzenia ofert do swojego CRM
Otrzymuj natychmiastowe podpisane wywołanie zwrotne, gdy klient wyświetli, zaakceptuje lub odrzuci ofertę — dzięki czemu Twoje systemy pozostają zsynchronizowane bez ręcznego przepisywania.
Czego się nauczysz
- ✓Dodawanie adresu i wybór zdarzeń
- ✓Bezpieczne przechowywanie sekretu podpisu
- ✓Weryfikacja, że żądanie naprawdę pochodzi z CueQuote
- ✓Wykrywanie adresu, który przestał działać
Dodaj swój adres
Otwórz Ustawienia i znajdź „Webhooki”. Kliknij „Dodaj adres” i wklej adres https, który ma otrzymywać zdarzenia. Zaznacz interesujące Cię zdarzenia — większość osób zaczyna od proposal.accepted, bo to o nim warto powiadomić CRM.
Wskazówka: Webhooki są dostępne w planie Business. Adres musi być https; zwykły http jest odrzucany.
Skopiuj sekret podpisu
Zaraz po utworzeniu adresu zobaczysz sekret zaczynający się od whsec_. Skopiuj go teraz do zmiennych środowiskowych — jest pokazywany dokładnie raz i nie da się go wyświetlić ponownie.
Wskazówka: Zgubiłeś go? Usuń adres i dodaj go ponownie. Otrzymasz nowy sekret.
Zweryfikuj podpis
Każde żądanie zawiera nagłówek X-CueQuote-Signature ze znacznikiem czasu i HMAC-SHA256 tego znacznika oraz surowej treści, podpisany Twoim sekretem. Przelicz go i porównaj, zanim czemukolwiek zaufasz. Bez tej weryfikacji każdy, kto pozna Twój adres, może wysyłać Ci fałszywe oferty.
Wskazówka: Haszuj surowe bajty treści. Sparsowanie JSON i ponowne zserializowanie zmienia bajty, a podpis nigdy się nie zgodzi — to najczęstszy błąd.
Odpowiadaj szybko
Zwróć dowolny status 2xx, gdy tylko przyjmiesz ładunek, a powolną pracę wykonaj później. Rezygnujemy po 10 sekundach, a przekroczenie czasu jest zapisywane jako błąd.
Wskazówka: Traktuj swój kod jako idempotentny — opieraj się na identyfikatorze oferty i zdarzeniu, zamiast zakładać, że każde zdarzenie dotrze dokładnie raz.
Obserwuj błędy
W Ustawieniach każdy adres pokazuje, ile dostaw otrzymał w ciągu ostatnich 7 dni i ile się nie powiodło. Czerwona plakietka „Błąd” oznacza, że Twój adres zwrócił błąd lub przekroczył limit czasu.
Wskazówka: Warto zaglądać tam od czasu do czasu: gdy integracja z CRM po cichu się zepsuje, nic innego Cię o tym nie poinformuje — oferty po prostu przestają docierać.