Najpierw otwórz Webhooki w panelu: każda dostawa pokazuje odpowiedź HTTP lub błąd, który otrzymaliśmy. Większość problemów to jeden z poniższych przypadków.
Nic nie jest wysyłane
Projekt nie ma URL webhooka. Dodaj go w ustawieniach projektu; wysyłamy tylko na adres zapisany w projekcie.
Dostawy kończą się błędem
- To nie jest publiczny adres https. Zwykły http, adresy lokalne i sieci prywatne są odrzucane.
- Przekierowania. Nie podążamy za nimi. Użyj adresu docelowego, z właściwym www i ukośnikiem na końcu.
- Blokada przez firewall lub ochronę przed botami. Przepuść nasze żądania POST na tej ścieżce.
- Zła odpowiedź. Liczy się tylko status 2xx. Odpowiedz w ciągu kilku sekund, a wolniejsze operacje wykonaj później.
- Twój kod się wysypuje. Sprawdź log błędów serwera z chwili nieudanej dostawy.
Podpis się nie zgadza
- Użyj sekretu do podpisywania webhooków, a nie sekretu API.
- Licz podpis z surowej treści dokładnie w otrzymanej postaci, przed jakimkolwiek parsowaniem.
- Po wygenerowaniu nowego sekretu webhooka zaktualizuj serwer.
Ponowienia i alerty
Nieudane dostawy są ponawiane przez około dwa dni. Po trzech błędach z rzędu przy zdarzeniach produkcyjnych właściciel projektu dostaje jednego e-maila; alert uzbraja się ponownie po następnym sukcesie.
Naprawione?
Kliknij Wyślij ponownie przy nieudanych dostawach w sekcji Webhooki albo Wyślij test.ping na stronie projektu, aby sprawdzić endpoint. Nadal nie działa? Napisz do nas przez stronę kontaktową i podaj ID dostawy.