Nowość: webhooki zostały zaktualizowane
Webhooki mają teraz lepszą konfigurację, dzienniki dostarczania, ponowne odtwarzanie zdarzeń oraz weryfikację podpisu. Jeśli skonfigurowano webhooki przed 31 sierpnia 2026 r., punkty końcowe wciąż działają, jednak konieczna jest ich migracja przed październikiem 2026 r. Można zapoznać się z krokami migracji.
Webhooki umożliwiają otrzymywanie aktualizacji w czasie rzeczywistym dotyczących wysłanych i odebranych faksów bezpośrednio z Fax.Plus. Konfigurując webhooki, można zautomatyzować monitorowanie transmisji faksów i zintegrować aktualizacje statusu z istniejącymi systemami.
Konfiguracja webhooków
- Otwórz panel webhooków:
- Zaloguj się do swojego konta Fax.Plus.
- Przejdź do sekcji Integracje w Ustawieniach.
- Znajdź Webhooki i kliknij Zarządzaj.
- Dodaj punkt końcowy:
- Kliknij Dodaj punkt końcowy i wprowadź absolutny adres URL na swoim serwerze, który będzie odbierał zdarzenia.
- Wybierz, które zdarzenia mają być odbierane. Zapisz się na wszystkie zdarzenia lub wybierz tylko te, które są potrzebne, z
katalogu zdarzeń. -
Opcjonalnie: filtruj według numeru faksu. Przypisz jeden lub więcej swoich numerów faksu, aby otrzymywać zdarzenia tylko dla
tych numerów.
-
Odbieraj aktualizacje statusu
- Po skonfigurowaniu Fax.Plus wyśle webhook na podany adres URL za każdym razem, gdy status faksu
się zmieni. - Ładunek webhooka będzie zawierał ważne szczegóły, takie jak identyfikator faksu, status, znacznik czasu i
informacje o odbiorcy.
Uwaga: Jeśli hook.id nie jest równe data.id, oznacza to, że faks jest ponownie wysyłany. Jeśli hook.id jest równe data.id, oznacza to, że faks jest wysyłany po raz pierwszy
- Po skonfigurowaniu Fax.Plus wyśle webhook na podany adres URL za każdym razem, gdy status faksu
- Zweryfikuj podpis
- Dla każdego utworzonego punktu końcowego automatycznie generowany jest klucz podpisujący, którego można użyć do weryfikacji każdego przychodzącego żądania. Dowiedz się więcej o weryfikacji podpisów webhooków.
- (Opcjonalnie) Zweryfikuj adresy IP źródła:
- Można sprawdzić, czy odbierane webhooki pochodzą z naszej listy autoryzowanych adresów IP:
- 52.215.16.239
- 54.216.8.72
- 63.33.109.123
- 2a05:d028:17:8000::/56
- Można sprawdzić, czy odbierane webhooki pochodzą z naszej listy autoryzowanych adresów IP:
Rozwiązywanie problemów i monitorowanie
- Dzienniki i monitorowanie: w panelu webhooków można zobaczyć każde zdarzenie oraz to, czy zostało dostarczone poprawnie, czy nie.
- Ponowne próby: w przypadku niepowodzenia dostarczenia webhooki są automatycznie ponawiane.
- Odtwarzanie: można również wywołać ręczne ponowienia z panelu lub odtworzyć dowolne przeszłe zdarzenia w wybranym oknie czasowym.