Webhooki SMS — to my dzwonimy do Państwa, nie odwrotnie
Dzięki webhookowi Państwa oprogramowanie nie musi nas ciągle pytać, czy jest coś nowego. Gdy tylko przyjdzie SMS albo zmieni się status dostarczenia, od razu wykonujemy żądanie HTTP POST pod adres, który Państwo podadzą. Zawsze przez HTTPS, ustawiane osobno dla każdego kanału — a kto nie ma serwera, każe po prostu przesyłać wszystko na skrzynkę pocztową.
Dwa rodzaje webhooków
Często są mylone, ale są od siebie niezależne i ustawia się je osobno: jeden dotyczy wiadomości, które przychodzą, drugi tego, co dzieje się z wiadomościami, które Państwo wysyłają.
| Przychodzący SMS | Status dostarczenia (DLR) | |
|---|---|---|
| Kiedy | Ktoś wysyła wiadomość na Państwa numer albo numer skrócony | Zmienia się status wiadomości, którą Państwo wysłali |
| Gdzie ustawiane | Dla każdego kanału, w Channels & Webhooks w Państwa koncie | Dla każdej wiadomości, jako adres URL powiadomienia w wywołaniu API |
| Payload | msgid timestamp sender message keyword | msgid status |
| Alternatywa bez serwera | Przesyłanie na adres e-mail | Sprawdzanie statusu w panelu |
Co wysyłamy na Państwa endpoint
Przy wiadomości przychodzącej wykonujemy HTTP POST pod Państwa adres z następującymi polami. Państwa endpoint musi je jedynie przyjąć i przetworzyć.
| Pole | Znaczenie |
|---|---|
msgid | Unikalny identyfikator wiadomości — prosimy go użyć, aby uniknąć podwójnego przetwarzania |
timestamp | Moment, w którym wiadomość do nas dotarła |
sender | Numer komórkowy nadawcy |
message | Pełna treść wiadomości |
keyword | Kanał albo słowo kluczowe, na które przyszła wiadomość |
Przy statusie dostarczenia payload jest krótszy: identyfikator wiadomości i kod statusu. Znaczenie każdego kodu opisujemy na stronie o raportach dostarczenia.
POST https://uw-server.be/sms/inkomend msgid=8471203×tamp=2026-05-12+14%3A31%3A08 &sender=32496123456&message=JA&keyword=afspraak Ustawienie webhooka w 4 krokach
Przygotowanie endpointu
Prosimy zapewnić publicznie dostępny adres HTTPS z ważnym certyfikatem, który przyjmuje żądania HTTP POST.
Wybór kanału
W swoim koncie prosimy przejść do Channels & Webhooks i wybrać kanał albo słowo kluczowe, którego ma dotyczyć powiadomienie.
Wpisanie adresu
Prosimy wpisać adres bez schematu; my zawsze wysyłamy przez HTTPS. Jeśli Państwa port różni się od 443, prosimy go podać.
Testowanie
Prosimy wysłać SMS na swój numer wirtualny albo numer skrócony i sprawdzić, czy endpoint odbiera żądanie POST.
Co musi spełniać Państwa endpoint
Jeśli na Państwa endpoint nic nie przychodzi, prosimy sprawdzić w tej kolejności: czy adres jest osiągalny z zewnątrz, czy certyfikat jest ważny i czy Państwa zapora przepuszcza nasze wywołanie. W dzienniku trace w Państwa koncie widać, co dokładnie zostało wysłane.
Brak serwera? Prosimy wysyłać to na skrzynkę
Webhook zakłada, że mają Państwo czym go odebrać. Jeśli tak nie jest, dla każdego kanału wybierają Państwo po prostu przesyłanie na adres e-mail: każda przychodząca wiadomość dociera wtedy jako e-mail, do Państwa albo do współpracownika, który ma się nią zająć.
Powiadomienie mogą też Państwo całkiem wyłączyć i przeglądać wiadomości wyłącznie w panelu — w widoku rozmowy stoją od razu obok tego, co sami Państwo wysłali.
