Webhooki: przekazuj przychodzące wiadomości SMS do swojego systemu

Dzięki webhookom SureSMS może automatycznie przekazywać przychodzące wiadomości SMS do innego systemu. Jest to przydatne, gdy odpowiedzi od klientów należy zapisać lub gdy trzeba zainicjować działanie bez konieczności ręcznej interwencji.

1. Czym jest webhook?

Webhook to automatyczna wiadomość wysyłana z jednego systemu do drugiego. Gdy klient odpowie na Twoją wiadomość SMS, SureSMS automatycznie przekazuje tę wiadomość do Twojego systemu, bez konieczności logowania się i pobierania jej.

Przepływ: Klient wysyła SMS-a → SureSMS go odbiera → Twój system otrzymuje powiadomienie.

Możesz na przykład wykorzystać webhooki do:

• zapisać odpowiedź w systemie CRM
• uruchomić przepływ w Zapier lub Make
• rejestrować zgłoszenia do konkursu
• utworzyć zgłoszenie do pomocy technicznej

2. Najpierw musisz to załatwić

1. Konto SureSMS z numerem, na który można odbierać SMS-y. Może to być Twój własny numer wirtualny, karta SIM w chmurze lub kod na numer skrócony, np. TAXA w 1414 roku.
2. Adres internetowy, czyli URL, który może odebrać wiadomość. Zazwyczaj pochodzi on z systemu, do którego chcesz wysłać wiadomość, np. Zapier, Make, HubSpot lub waszego systemu CRM. Może również pochodzić od waszego programisty.
3. Adres musi być dostępny w Internecie i najlepiej, aby zaczynał się od https://.

3. Jak skonfigurować webhook

1. Zaloguj się do portalu SureSMS i przejdź do Integracje → Webhooki.
2. Kliknij Utwórz nowy webhook.
3. Wybierz typ w polu Opis:
   • POWIADOMIENIE o otrzymanych SMS-ach (zalecane), jeśli chcesz otrzymywać dane w formacie JSON. Jest to kompatybilne z większością systemów.
   • GET dla otrzymanych wiadomości (zalecane), jeśli Twój system może odbierać dane wyłącznie z samego adresu internetowego.
4. Wpisz adres swojej strony internetowej w URI. Portal podaje przykład, który należy zastąpić własnym adresem.
5. Wybierz w Wszystkie numery, czy webhook ma dotyczyć wszystkich Twoich numerów, czy tylko jednego konkretnego numeru lub hasła. Hasło zostanie uznane za pasujące tylko wtedy, gdy będzie pierwszym słowem w wiadomości SMS.
6. Jeśli wybrałeś opcję POST, musisz wypełnić Wartość pocztowa. To jest plik JSON, który SureSMS wysyła na Twój adres URL. Użyj przycisku Wstaw pole scalania w celu wprowadzenia wartości dynamicznych. Pole może zawierać maksymalnie 1000 znaków.
7. Kliknij Klejnot.

4. Pola scalania

Pola scalające zostaną zastąpione właściwymi wartościami po otrzymaniu wiadomości SMS. Oto najczęściej używane z nich:

Pole warkocza	Treść
<%bodyjson%>	Treść wiadomości SMS, gotowa do użycia w formacie JSON. Użyj jej w formacie JSON.
<%body%>	Treść wiadomości SMS
<%fromphonenumber%>	Numer nadawcy
<%receivedbyphonenumber%>	Twój numer, na który wysłano SMS-a
<%countrycode%>	Kod kraju nadawcy
<%receivedutcdatetime%>	Czas otrzymania (UTC)

Aby wyświetlić pełną listę, skorzystaj z menu rozwijanego w portalu.

Przykład: GET

https://ditdomæne.dk/sms?fra=<%fromphonenumber%>&til=<%receivedbyphonenumber%>&tekst=<%body%>

Przykład: POST

{
  "time": "",
  "sender": "",
  "receiver": "",
  "message": ""
}

Jeśli wyniki testów wskazują na nadawcę +4512345678, otrzymuje +4587654321 oraz tekst Test SureSMS, przykład POST wygląda następująco:

{
  "time": "2026-10-23T07:54:00Z",
  "sender": "+4512345678",
  "receiver": "+4587654321",
  "message": "Test SureSMS"
}

5. Jak przeprowadzić test

a) Naciśnij przycisk „Test”

W oknie konfiguracji możesz kliknąć Test, przed zapisaniem. SureSMS wyśle na Twój adres przykładowe żądanie z powyższymi wartościami testowymi. Otrzymasz informację, czy operacja się powiodła oraz jaki kod statusu HTTP zwrócił Twój system. Każdy kod z serii 200 oznacza, że wszystko działa poprawnie.

b) Przeprowadź prawdziwy test

Wyślij SMS-a ze swojego telefonu komórkowego na ten numer. Pamiętaj o haśle, jeśli z niego korzystasz. Następnie otwórz zakładkę Zaloguj się na stronie Webhooks i kliknij Zaktualizuj. Tutaj możesz sprawdzić, co dokładnie zostało wysłane, jaka była odpowiedź Twojego systemu i kiedy to miało miejsce.

c) Czy nie masz jeszcze gotowego systemu?

Możesz skorzystać z bezpłatnej usługi testowej, takiej jak webhook.site. Usługa ta zapewnia tymczasowy adres. Wprowadź ten adres jako URI, wyślij testową wiadomość SMS i zobacz ją na żywo na stronie webhook.site.

6. Jeśli to nie zadziała

• Test kończy się niepowodzeniem z kodem błędu 400 Bad Request: Czy korzystasz z <%bodyjson%> w formacie JSON? Czy ten plik JSON jest poprawny, z właściwymi cudzysłowami i przecinkami?
• Test działa, ale w prawdziwym SMS-ie nic się nie pojawia: Czy to właściwy numer? Czy wiadomość SMS zaczyna się od hasła? Czy webhook został usunięty?
• Limit czasu: Twój system powinien odpowiedzieć w ciągu kilku sekund. Wykonaj wymagające operacje później, a nie w trakcie, gdy SureSMS czeka na odpowiedź.
• Nieprawidłowy adres: Adres musi zaczynać się od http:// lub https://.
• Twój system jest chwilowo niedostępny: SureSMS próbuje 3 razy w odstępach co 1 minutę.
• Zapora sieciowa: Jeśli chcesz zezwolić na stałe adresy IP, możesz je uzyskać, kontaktując się z SureSMS.

Webhook jest wysyłany natychmiast po otrzymaniu wiadomości SMS. Webhooki nie wymagają specjalnej subskrypcji, ale konieczne jest posiadanie funkcji odbierania wiadomości SMS.