Home / Funkcje / Webhooks

Webhooks

Funkcja Webhooks umożliwia automatyczne przekazywanie przychodzących wiadomości SMS lub MMS na zdefiniowany adres URL w czasie rzeczywistym.

Szczegóły funkcji

Funkcja Webhooks pozwala na przekierowanie każdej przychodzącej wiadomości SMS lub MMS do określonego adresu URL. Po jej włączeniu każda wiadomość odebrana przez urządzenie SMSEagle wywoła żądanie HTTP(S) do zdefiniowanego przez użytkownika punktu końcowego. Żądanie może być typu GET lub POST.

Konfiguracja

Dzięki Webhooks możesz przekazywać przychodzące wiadomości bezpośrednio do zewnętrznych systemów. Za każdym razem, gdy SMS lub MMS dotrze do bramki SMSEagle, urządzenie automatycznie wyśle żądanie HTTP(S) do wskazanego adresu URL.
Funkcja pozwala utworzyć nieograniczoną liczbę reguł, a każdą z nich można w dowolnym momencie włączyć lub wyłączyć.

Adding/editing rules

Podczas tworzenia nowej reguły należy uzupełnić następujące pola:

  • URL – adres docelowego punktu webhooka.

  • Test URL – umożliwia sprawdzenie poprawności konfiguracji. SMSEagle wyśle testowe żądanie HTTP(S) z przykładowymi parametrami i zweryfikuje odpowiedź serwera.

  • URL method – wybór metody żądania HTTP(S): GET lub POST.

  • Wyślij żądanie gdy – definiuje warunki, w których webhook ma zostać wywołany. Może być wysyłany zawsze, tylko gdy nadawca wiadomości należy do określonego kontaktu/grupy z książki telefonicznej lub tylko wtedy, gdy treść wiadomości zawiera wskazany ciąg znaków.

  • Klucz API usługi (opcjonalnie) – jeśli zostanie podany, wartość ta zostanie przekazana w parametrze apikey. Jeśli pole pozostanie puste, parametr nie zostanie wysłany.

  • Obsługa certyfikatów SSL self-signed – opcjonalnie można włączyć obsługę certyfikatów samopodpisanych.

Po wysłaniu żądania HTTP(S) GET/POST do wskazanego adresu webhooka, SMSEagle oczekuje odpowiedzi 200 OK.


Jeśli urządzenie nie otrzyma takiej odpowiedzi lub serwer będzie niedostępny, SMSEagle automatycznie ponowi próbę w zdefiniowanych odstępach czasu przez okres do 24 godzin.

Czym jest sprzętowa
bramka SMS?

Szczegółowy opis
znajduje się w
podręczniku użytkownika