Jak mogę używać webhooków, aby sprawdzić status wysłanego lub odebranego faxu?

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

  1. 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.
  2. 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.
  3. 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

  4. 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.
  5. (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

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.
Czy ten artykuł był pomocny?
Liczba użytkowników, którzy uważają ten artykuł za przydatny: 0 z 1
Więcej artykułów w tej sekcji