Funkcja Webhooks umożliwia automatyczne przekazywanie przychodzących wiadomości SMS lub MMS na zdefiniowany adres URL w czasie rzeczywistym.
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. Funkcja pozwala także wywołać endpoint URL, gdy zmieni się status wiadomości wychodzącej, na przykład gdy wiadomość została wysłana lub dostarczona, albo gdy podczas wysyłki wystąpił błąd. Żądanie może być typu GET lub POST.
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ć.
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 lub POST na Twój adres callback URL, SMSEagle oczekuje odpowiedzi HTTP zgodnej z parametrem „Expected HTTP Status Code(s)”. 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.
