Webhooki

Właściciel i Administrator firmy otwierają Administrator firmy → Sprzedaż i integracje → Integracje → API i webhooki. Webhook wysyła do Państwa systemu żądanie HTTPS POST z JSON za każdym razem, gdy nastąpi wybrane zdarzenie.

#Tworzenie webhooka

1. W sekcji Webhooki proszę wybrać Nowy webhook.
2. Proszę wpisać Nazwa i URL. Tylko HTTPS. Adresy sieci wewnętrznych i prywatnych są blokowane.
3. W sekcji Zdarzenia proszę zaznaczyć, co wysyłać: lead.created, deal.created, deal.stage_changed, deal.won, deal.lost, contact.created, contact.updated, company.created, company.updated.
4. Proszę wybrać Utwórz webhook, skopiować klucz podpisu i wybrać Zapisałem(-am) go. Służy do sprawdzania nagłówka X-Dromix-Signature w każdym żądaniu. Jest wyświetlany tylko teraz; później można go zmienić.

Wyślij test od razu wysyła zdarzenie ping.

#Sprawdzanie podpisu

Każde żądanie zawiera nagłówki X-Dromix-Event, X-Dromix-Event-Id, X-Dromix-Delivery, X-Dromix-Timestamp (sekundy Unix) i X-Dromix-Signature. Podpis to sha256= + HMAC-SHA256(secret, {timestamp}.{body}). Proszę obliczyć go po swojej stronie, porównać i odrzucać żądania starsze niż 5 minut.

Po ponowieniu to samo zdarzenie może przyjść dwa razy. X-Dromix-Event-Id pozwala pominąć duplikaty.

Jeśli klucz wycieknie, proszę wybrać Zmień klucz tajny. Stary klucz natychmiast przestanie działać. Zaraz potem należy zaktualizować odbiorcę.

#Dostarczenia i ponowienia

Dziennik dostarczeń pokazuje każde dostarczenie ze statusem, próbami i następną próbą. Nieudane dostarczenia są ponawiane po 1 min, 5 min, 30 min, 2 godz., 6 godz. i 24 godz. Webhook jest wyłączany po 50 kolejnych niepowodzeniach lub gdy odbiorca odpowie 410 Gone.

Gdy odbiorca znów działa, proszę ponownie włączyć webhook przełącznikiem Wł..