Webhooki: powiadomienia do Twojego systemu
Aktualizacja:
Webhook działa jak SMS z powiadomieniem, tylko wysyłany do Twojego programu zamiast do człowieka. Gdy w SMS Portal|app coś się stanie, nasz serwer wysyła do wskazanego przez Ciebie adresu krótką wiadomość z danymi. Twój program może wtedy na przykład zapisać odpowiedź klienta w swojej bazie.
Dodaj webhook
- W menu panelu kliknij „Webhooki”.
- Kliknij „Utwórz webhook”.
- W polu „Nazwa (opcjonalnie)” wpisz krótką nazwę, na przykład „CRM produkcyjny”. Pomoże Ci odróżnić webhooki.
- W polu „Adres dostarczenia” wpisz adres w swoim systemie. Serwer wyśle tam żądania POST.
- W polu „Sekret podpisu” wpisz własny ciąg znaków albo kliknij „Wygeneruj”. Sekret służy do sprawdzenia, że dane naprawdę pochodzą od nas.
- W polu „Zdarzenia” zaznacz co najmniej jedno:
MESSAGE_RECEIVED(SMS odebrany),MESSAGE_SENT(wysłany),MESSAGE_DELIVERED(dostarczony) lubMESSAGE_FAILED(nie wyszedł). - Kliknij „Utwórz”.

Na karcie webhooka możesz go wyłączyć i włączyć przełącznikiem, edytować, skopiować adres oraz pokazać lub skopiować sekret. Możesz mieć do 5 webhooków.
Co dostaje Twój system
Każde powiadomienie to żądanie POST z danymi w formacie JSON i nagłówkiem X-Signature. Dane zawierają między innymi identyfikator wiadomości, numer, treść, identyfikator telefonu i nazwę zdarzenia w polu webhookEvent. Przykłady każdego zdarzenia znajdziesz na dole strony Webhooki, w sekcji „Instrukcja bezpieczeństwa i wdrożenia”.
Twój system powinien:
- Przyjąć żądanie POST.
- Odpowiedzieć kodem 2XX, na przykład 200.
- Zrobić to w ciągu 10 sekund.
Sprawdź podpis
Nagłówek X-Signature to podpis liczony algorytmem HMAC-SHA256 z danych i Twojego sekretu. Policz go po swojej stronie i porównaj. Jeśli się nie zgadza, odrzuć żądanie. Gotowe przykłady w Node.js i Pythonie są w zakładce „Weryfikacja” na stronie Webhooki.
Dziennik dostarczeń i ponowienia
Kliknij zakładkę „Dostarczenia”. Zobaczysz każde powiadomienie z kolumnami „Zdarzenie”, „Urządzenie”, „Status”, „Adres dostarczania” i „Utworzono”. Kliknięcie ikony oka otwiera dane, które poszły do Twojego systemu. Filtry zawężają listę po telefonie, webhooku, typie zdarzenia, statusie i dacie.
| Status | Co znaczy |
|---|---|
| Dostarczone | Twój system odpowiedział poprawnie. |
| Oczekujące | Powiadomienie czeka na pierwszą próbę. |
| Ponawianie | Próba się nie udała, serwer spróbuje ponownie. |
| Nieudane | Serwer przestał próbować. |
Gdy Twój system nie odpowie poprawnie, ponowimy wysyłkę po: 3 minutach, 5 minutach, 30 minutach, 1 godzinie, 6 godzinach, 1 dniu, 3 dniach, 7 dniach i 30 dniach. Powiadomienie ma najwyżej 10 prób. Przy błędach klienta (kody 4XX) serwer przestaje po trzeciej próbie. Wyłączony webhook nie dostaje już powiadomień.
Pytania i odpowiedzi
- Ile webhooków mogę mieć?
- Do 5 na koncie. Gdy osiągniesz limit, usuń jeden, aby dodać kolejny.
- Co jeśli mój system nie odpowie?
- SMS Portal|app ponowi próbę po 3 minutach, potem po 5 i 30 minutach, 1 godzinie i dłużej, łącznie do 10 prób.
Powiązane instrukcje
Nie znalazłeś odpowiedzi? Napisz do nas