Nowość: aktualizacja webhooków
Webhooki oferują teraz lepszą konfigurację, dzienniki dostarczania, ponowne odtwarzanie zdarzeń i weryfikację podpisu. Jeśli webhooki zostały skonfigurowane przed 31 sierpnia 2026 r., Twoje endpointy nadal działają, ale trzeba je zmigrować przed 15 stycznia 2027 r. Możesz skorzystać z instrukcji migracji.
Webhooki umożliwiają otrzymywanie w czasie rzeczywistym aktualizacji o wysłanych i odebranych faxach bezpośrednio z Fax.Plus. Konfigurując webhooki, możesz zautomatyzować monitorowanie transmisji faxów i zintegrować aktualizacje statusu z już używanymi systemami.
Konfiguracja webhooków
- Otwórz panel webhooków:
- Zaloguj się na swoje konto Fax.Plus.
- Przejdź do sekcji Integracje w menu Ustawienia.
- Znajdź Webhooki i kliknij Zarządzaj.
- Dodaj endpoint:
- Kliknij Dodaj endpoint i wpisz bezwzględny adres URL na swoim serwerze, który będzie odbierać zdarzenia.
- Wybierz zdarzenia, które chcesz otrzymywać. Możesz subskrybować wszystkie zdarzenia albo wybrać tylko te potrzebne z
katalogu zdarzeń. -
Opcjonalnie: filtrowanie według numeru fax. Przypisz do endpointu jeden lub więcej swoich numerów fax, aby otrzymywać zdarzenia tylko dla
tych numerów.
-
Odbieranie aktualizacji statusu
- Po skonfigurowaniu Fax.Plus będzie wysyłać webhook na wskazany adres URL za każdym razem, gdy status
faxu ulegnie zmianie. - Ładunek webhooka (payload) zawiera ważne informacje, takie jak identyfikator faxu, status, znacznik czasu i
dane odbiorcy.
Uwaga: Jeśli hook.id nie jest równe data.id, oznacza to, że fax jest wysyłany ponownie. Jeśli hook.id jest równe data.id, oznacza to, że fax jest wysyłany po raz pierwszy.
- Po skonfigurowaniu Fax.Plus będzie wysyłać webhook na wskazany adres URL za każdym razem, gdy status
- Weryfikacja podpisu
- Dla każdego utworzonego endpointu automatycznie generowany jest tajny klucz podpisu, za pomocą którego można weryfikować każde przychodzące żądanie. Dowiedz się więcej o weryfikacji podpisów webhooków.
- (Opcjonalnie) Weryfikacja adresów IP źródła:
- Możesz sprawdzić, czy otrzymywane 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żesz sprawdzić, czy otrzymywane webhooki pochodzą z naszej listy autoryzowanych adresów IP:
Rozwiązywanie problemów i monitorowanie
- Dzienniki i obserwowalność: w panelu webhooków widać każde zdarzenie oraz informację, czy zostało dostarczone pomyślnie.
- Ponowne próby: w przypadku niepowodzenia dostarczenia webhooki są automatycznie ponawiane.
- Odtwarzanie: z poziomu panelu można też ręcznie uruchomić ponowne próby lub odtworzyć dowolne wcześniejsze zdarzenia z wybranego przedziału czasu.