Webhooki i statusy doręczeń: monitoring wysyłek SMS od strony technicznej

Dodał: Marta Data: 2026-11-01 08:26:01 (czytane: 2009)

Wysłanie SMS-a przez API to dopiero połowa pracy. Odpowiedź serwera ?przyjęto? oznacza jedynie, że bramka zaakceptowała żądanie ? nie że wiadomość dotarła do telefonu odbiorcy. Aby mieć pełną kontrolę nad komunikacją, system musi odbierać i przetwarzać statusy doręczeń. Najwygodniej robi się to za pomocą webhooków.

Webhooki i statusy doręczeń: monitoring wysyłek SMS od strony technicznej. Foto: 43854_sms.jpg


Cykl życia wiadomości SMS

Każdy SMS przechodzi przez kilka etapów. Najpierw aplikacja wysyła żądanie do API bramki. Bramka waliduje je, nadaje wiadomości identyfikator i przekazuje ją do operatora sieci komórkowej. Operator próbuje dostarczyć SMS do urządzenia, a następnie odsyła raport doręczenia, tzw. DLR (Delivery Report). Dopiero ten raport mówi, co faktycznie stało się z wiadomością.

Najważniejsze statusy doręczeń

Nazewnictwo różni się w zależności od dostawcy, ale logika jest podobna. Typowe statusy to:

  • przyjęta lub w kolejce ? bramka zaakceptowała wiadomość i czeka na jej wysłanie,

  • wysłana ? wiadomość trafiła do operatora,

  • doręczona ? operator potwierdził dostarczenie do telefonu,

  • niedoręczona ? próba się nie powiodła, np. z powodu nieaktywnego numeru,

  • wygasła ? telefon był wyłączony lub poza zasięgiem dłużej niż okres ważności wiadomości,

  • odrzucona ? wiadomość zablokowano, np. z powodu błędnego numeru lub braku środków.

Status ?doręczona? potwierdzony przez operatora to najpewniejsza informacja, jaką można uzyskać w kanale SMS.

Polling czy webhooki

Statusy można pobierać na dwa sposoby.

Odpytywanie API (polling)

Aplikacja co jakiś czas pyta bramkę o status wiadomości po jej identyfikatorze. Rozwiązanie jest proste, ale nieefektywne. Przy dużym wolumenie generuje tysiące zbędnych zapytań, a informacja i tak dociera z opóźnieniem zależnym od częstotliwości odpytywania.

Webhooki (callback URL)

W tym modelu to bramka wysyła informację do aplikacji, gdy tylko status się zmieni. Wystarczy wskazać adres URL, pod który mają trafiać powiadomienia. Bramka wykonuje na niego żądanie HTTP z danymi: identyfikatorem wiadomości, numerem, nowym statusem i znacznikiem czasu. To podejście jest szybsze, tańsze i lepiej się skaluje.

Jak poprawnie zaimplementować endpoint webhooka?

Odbiór webhooków wydaje się prosty, ale kilka szczegółów decyduje o niezawodności.

Szybka odpowiedź

Endpoint powinien jak najszybciej zwrócić kod HTTP 200, a właściwe przetwarzanie danych przekazać do kolejki. Jeśli odpowiedź się opóźni, bramka może uznać próbę za nieudaną i ponowić wysyłkę.

Idempotentność

Ten sam status może dotrzeć więcej niż raz. Obsługa powinna rozpoznawać duplikaty po identyfikatorze wiadomości i statusie, tak aby powtórzone powiadomienie nie wywołało podwójnej akcji.

Kolejność zdarzeń

Statusy nie zawsze przychodzą w porządku chronologicznym. Warto zapisywać znacznik czasu i nie nadpisywać statusu końcowego, np. ?doręczona?, statusem pośrednim, który dotarł później.

Bezpieczeństwo

Endpoint jest publiczny, więc należy weryfikować źródło żądań, np. przez token w adresie, podpis wiadomości lub listę dozwolonych adresów IP. Komunikacja powinna odbywać się wyłącznie przez HTTPS.

Co zrobić z danymi o statusach

Zebrane statusy to cenne źródło wiedzy. Pozwalają automatycznie oczyszczać bazę z nieaktywnych numerów, uruchamiać kanał zapasowy, np. e-mail, gdy SMS z kodem jednorazowym nie dotrze, oraz mierzyć realną doręczalność kampanii. Monitoring odsetka wiadomości niedoręczonych pomaga też szybko wykryć problem, zanim zauważą go klienci.

Wybór API z myślą o monitoringu

Przy wyborze dostawcy warto sprawdzić, czy SMS API udostępnia szczegółowe statusy potwierdzane przez operatorów, obsługuje callbacki i ma czytelną dokumentację. Istotne jest także wsparcie techniczne na etapie integracji ? oszczędza godziny debugowania.

Podsumowanie

Statusy doręczeń zamieniają wysyłkę SMS z działania ?na ślepo? w mierzalny proces. Webhooki pozwalają reagować na nie w czasie rzeczywistym, pod warunkiem że endpoint jest szybki, idempotentny i zabezpieczony. To niewielki nakład pracy, który daje pełną kontrolę nad komunikacją.

/Artykuł sponsorowany/ 

REKLAMA

Inntax Biuro Rachunkowe - Magdalena Marchewka

Busko-Zdrój, ul. Partyzantów 78

Biuro Rachunkowe EFEKT

Busko Zdrój, Langiewicza 39

Biuro Rachunkowe PERFEKTUS

Busko Zdrój, ul. Wyszyńskiego 12

Biuro Rachunkowe DASMA - usługi księgowe

Pińczów, ul. 3-go Maja 20A

Willa SŁONECZNA - noclegi, pokoje gościnne

Busko-Zdrój, ul. Słoneczna 18

Pensjonat SANATO SPA

Busko-Zdrój, 1-go Maja 29

Imprezy/wydarzenia w regionie

Kora drzew, wiklina, gałązki bzu czy sosnowe igły mogą stać się tworzywem artystycznym. Przekonają się o tym odwiedzający Dom Zdrojowy w Busku-Zdroju, gdzie od 20 października prezentowana jest wystawa 'Powrót do Natury' autorstwa Tamary Maj. W Oranżerii można zobaczyć ponad 30 prac, w których przyroda jest nie tylko inspiracją, ale również częścią samych dzieł.
2026-10-23 - 2026-11-20

41. Przegląd Plastyki Ponidzie 2026

Jak wyglądali i jakiego uzbrojenia używali polscy żołnierze podczas powstania listopadowego? Odpowiedzi można znaleźć na wystawie w Galerii Sztuki Willa Polonia w Busku-Zdroju. Ekspozycja przybliża wydarzenia sprzed niemal 200 lat i przypomina o ich związkach z historią ziemi kieleckiej.
Fotografia, która zatrzymuje na chwilę i pozwala spojrzeć na otaczający świat z innej perspektywy. Już 1 listopada 2026 roku w Domu Zdrojowym kompleksu Tężnia Busko-Zdrój rozpocznie się wystawa 'Linia Ciszy' autorstwa Daniela Piwowarczyka. Ekspozycja będzie okazją do poznania twórczości fotografa, grafika i kuratora, od lat związanego ze środowiskiem artystycznym Ponidzia.
Czy piękno jest jeszcze kwestią osobistego wyboru, czy stało się obowiązkiem narzucanym przez współczesny świat? Jak daleko jesteśmy gotowi się posunąć, by sprostać ideałom kreowanym przez media i społeczne oczekiwania? Te pytania staną się punktem wyjścia do niezwykłej wystawy Magdaleny Leśniak 'Don't hate me because I'm beautiful'.
7 listopada 2026 roku w Galerii Sztuki Gromada w Busku-Zdroju odbędzie się wernisaż jej wystawy 'Ślady niewidzialnego'. Czy można zobaczyć to, co niewidzialne? Nadać kształt emocjom, duchowym przeżyciom i tajemnicom ludzkiego istnienia? Małgorzata Nega udowadnia, że sztuka potrafi przekraczać granice rzeczywistości.
Buskie Samorządowe Centrum Kultury dodało do listopadowego repertuaru film 'Nasza rewolucja'. To historia miłości Jacka i Grażyny Kuroniów. Premierowe seanse odbędą się od wtorku do piątku, o godz. 16:00 i 19:00.
2026-11-18 - 2026-11-28

Kino Zdrój w Busku-Zdroju

Zapraszamy na wydarzenia zorganizowane w Kompleksie Tężnia w Busku-Zdroju. A programie między innymi:
2026-11-18 - 2026-11-30

Wydarzenia w Kompleksie Tężnia Busko

Miłośników poezji, muzyki i sztuki czeka wyjątkowe spotkanie w Busku-Zdroju. W czwartek, 19 listopada 2026 roku, w Buskim Samorządowym Centrum Kultury odbędzie się wieczór autorski Andrzeja Smulczyńskiego, poświęcony jego najnowszemu tomikowi 'Droga słów'. W programie znalazły się również interpretacje poezji, recital piosenkarski oraz wernisaż malarstwa.
'Tacy byliśmy', 'Mr. Lennon', 'Wołanie przez ciszę' czy 'W perły zmienić deszcz' - te piosenki zna i nuci kilka pokoleń Polaków. Już 20 listopada największe przeboje zespołu Universe zabrzmią w Solcu-Zdroju. Grupa wystąpi w Gminnym Centrum Kultury z koncertem 'Tacy byliśmy jeszcze wczoraj', zabierając publiczność w sentymentalną podróż do lat 80. i 90.
Peruki są, paradne stroje też. Do tego szpady, koronki, kapelusze i cała galeria postaci, które wyglądają tak, jakby właśnie opuściły XVII-wieczny salon. Teatr Ciut Frapujący z Pińczowa szykuje premierę na swoje 25-lecie i nie zamierza świętować skromnie. 14 listopada na scenę wkroczy 'Mieszczanin szlachcicem' Moliera.
Zapraszamy na seanse do Kina Solec-Zdrój! A w repertuarze między innymi:
2026-11-21 - 2026-11-29

Kino w Solcu-Zdroju zaprasza na seanse

Lekka komedia o skomplikowanych relacjach, z mnóstwem zabawnych dialogów i nieoczywistych zdarzeń. Świetną rozrywkę gwarantuje gwiazdorska obsada.
Sportowe emocje, rywalizacja na parkiecie i okazja do wspólnego kibicowania. Już 21 listopada w Busku-Zdroju odbędzie się Turniej Piłki Nożnej Halowej struktur powiatowych Koalicji Obywatelskiej Regionu Świętokrzyskiego. Drużyny z czterech powiatów zmierzą się w walce o puchar posła Artura Gierady.
W sobotę, 21 listopada, w hali sportowej w Solcu-Zdroju odbędzie się turniej siatkarski im. Pawła Ślusarskiego. Organizuje go Gminny Klub Sportowy Solec-Zdrój, a początek zaplanowano na godz. 9:00.

Ogłoszenia

Dodano: 2026-11-19 02:02:07

Oferuję pożyczki od 1000 do 250 000 euro

Dodano: 2026-11-19 02:00:34

Oferta finansowa, która Ci pomoże

Dodano: 2026-11-19 01:35:26

Oferta finansowa, która Ci pomoże

Dodano: 2026-11-18 21:32:00

Wycinka

Dodano: 2026-11-18 19:56:56

SKUP SAMOCHODÓW, AUT OSOBOWE DOSTAWCZE

Dodano: 2026-11-18 19:52:45

Brukarzu

Dodano: 2026-11-18 19:48:58

Dostawca pizzy

Dodano: 2026-11-18 18:35:22

no

Dodano: 2026-11-18 18:34:28

naprawa pil spalinowych

Dodano: 2026-11-18 17:41:04

Renont i wykończenia

Dodano: 2026-11-18 17:20:02

BUTLE PROPAN-BUTAN 11KG-KUPIĘ

Dodano: 2026-11-18 16:24:21

Wynajmę mieszkanie

Dodano: 2026-11-18 13:31:17

naprawa pil i pilarek

Dodano: 2026-11-18 13:29:54

remonty i wykonczenia

Dodano: 2026-11-18 13:28:40

naprawa oraz remonty skutery i qlady.regulacja gaz...