Webhooki: zdarzenia do systemów zewnętrznych

Webhooki automatycznie wysyłają wiadomości na zewnętrzny URL przy określonych zdarzeniach w Tesoro: nowy lead, transakcja ze statusem Won, nieruchomość ze statusem Sold. Służą do integracji z Zapier, Make, własnymi systemami.

Kiedy tego użyć?

Nowy lead przez Zapier na kanał Slack
Zdarzenie transakcji ze statusem Won do Państwa systemu księgowego
Zewnętrzne narzędzie analityczne otrzymujące dane w czasie rzeczywistym

Co to jest webhook?

Przy każdym wybranym zdarzeniu Tesoro wysyła żądanie HTTP POST na Państwa URL z ładunkiem JSON. Państwa system odbiera, przetwarza i odpowiada (200 OK).

Tworzenie webhooka

Settings → Webhooks → Add webhook.
Proszę wypełnić:
- Name: rozpoznawalna nazwa
- URL: endpoint, który odbiera ładunek (HTTPS zalecane)
- Events: proszę wybrać, które zdarzenia mają być wyzwalane
- Secret (opcjonalnie), do walidacji żądań
Save → webhook aktywny.

Dostępne zdarzenia

Kategoria	Zdarzenia
Lead	created, updated, status_changed, converted, deleted
Kontakt	created, updated, deleted, portal_user_created
Transakcja	created, status_changed, won, lost, deleted
Nieruchomość	created, status_changed, sold, rented, deleted
Spotkanie	created, status_changed, completed
Aktywność	task_created, task_completed, note_created

Proszę wybrać co najmniej 1, możliwe jest wybranie wielu.

Format ładunku

Ciało JSON zawiera:

event: typ (np. lead.created)
timestamp: kiedy
data: pełny rekord ze wszystkimi polami
previous_data (przy zmianach), poprzedni status
company_id: do integracji multi-tenant

Autoryzacja + bezpieczeństwo

Walidacja sekretu (zalecane): Tesoro podpisuje każdy webhook za pomocą HMAC. Państwa endpoint oblicza ten sam HMAC i weryfikuje.

Bez sekretu: każde żądanie POST może pochodzić z dowolnego źródła. Niezalecane dla systemów produkcyjnych.

Zachowanie przy ponownych próbach

Webhook nie powiedzie się (brak odpowiedzi 200 w ciągu X sekund lub przekroczenie limitu czasu sieci)? Tesoro próbuje ponownie:

1 minutę później
5 minut później
30 minut później
2 godziny później
Następnie oznaczony jako Failed, bez dalszych prób

Nieudane webhooki są widoczne w panelu. Możliwa ręczna ponowna próba.

Logi webhooków

Dla każdego webhooka widoczne są ostatnie próby:

Znacznik czasu
Typ zdarzenia
Status odpowiedzi
Liczba ponownych prób
Ciało (wejście/wyjście)

Pomaga w debugowaniu.

Częste błędy

Brak otrzymanych zdarzeń

Proszę sprawdzić:

Czy adres URL jest dostępny z internetu?
Czy certyfikat HTTPS jest ważny?
Czy endpoint wysyła odpowiedź 200 w ciągu 5 sekund?
Czy zdarzenia zostały faktycznie wybrane w konfiguracji webhooka?

Podwójne zdarzenia

Zachowanie przy ponownych próbach webhooka, w przypadku problemów z czasem może Pan/Pani czasami otrzymać ponowną próbę już udanego dostarczenia. Proszę uczynić swój endpoint idempotentnym: otrzymanie dwa razy tego samego identyfikatora zdarzenia → przetworzenie tylko raz.

Następny krok

Integracje API Klucze API do dostępu z systemów zewnętrznych.