Kto może korzystać z tej funkcji?
Dostępna w planie Enterprise.
Dostępna dla właścicieli i administratorów w aplikacji internetowej.
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 faksach bezpośrednio z Fax.Plus. Po skonfigurowaniu webhooków można zautomatyzować monitorowanie transmisji faksowych i włączyć aktualizacje statusu do istniejących systemów.
Dokumentacja dla programistów: Pełne szczegóły techniczne, w tym typy zdarzeń, strukturę payloadu i weryfikację podpisu, znajdziesz w dokumentacji API Fax.Plus dotyczącej webhooków.
Konfiguracja webhooków
- Otwórz panel webhooków:
- Zaloguj się na swoje konto Fax.Plus.
- Przejdź do sekcji Integracje w obszarze 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, jakie zdarzenia chcesz odbierać. Możesz subskrybować wszystkie zdarzenia albo wybrać tylko te, których potrzebujesz, z
katalogu zdarzeń. -
Opcjonalnie: filtruj według numeru faksu. Dołącz jeden lub kilka swoich numerów faksu, aby odbierać zdarzenia tylko dla
tych numerów.
-
Odbieraj aktualizacje statusu
- Po skonfigurowaniu Fax.Plus będzie wysyłać webhook na wskazany adres URL za każdym razem, gdy status faksu
ulegnie zmianie. - Payload webhooka będzie zawierać ważne informacje, takie jak identyfikator faksu, status, znacznik czasu oraz
informacje o odbiorcy.
Uwaga: Jeśli hook.id nie jest równy data.id, oznacza to, że faks jest wysyłany ponownie. Jeśli hook.id jest równy data.id, oznacza to, że faks 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 faksu
- Zweryfikuj podpis
- Dla każdego utworzonego endpointu automatycznie tworzony jest klucz do podpisywania, za pomocą którego możesz weryfikować każde przychodzące żądanie. Dowiedz się więcej o weryfikacji podpisów webhooków.
- (Opcjonalnie) Zweryfikuj źródłowe adresy IP:
- Możesz 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żesz sprawdzić, czy odbierane webhooki pochodzą z naszej listy autoryzowanych adresów IP:
Rozwiązywanie problemów i monitorowanie
- Logi i monitorowanie: w panelu webhooków możesz zobaczyć każde zdarzenie i sprawdzić, czy zostało dostarczone pomyślnie.
- Ponawianie prób: w przypadku niepowodzenia dostarczenia webhooki są automatycznie ponawiane.
- Odtwarzanie: z poziomu panelu możesz też ręcznie wywołać ponowne próby lub odtworzyć dowolne wcześniejsze zdarzenia z wybranego przedziału czasu.