Wiadomości SMS

Wysyłaj standardowe wiadomości tekstowe za pomocą SMSBAT API. SMS to najbardziej uniwersalny kanał przesyłania wiadomości z najwyższym współczynnikiem dostawy na wszystkich urządzeniach mobilnych.

Przegląd

Usługa SMS (Short Message Service) jest idealna do:

Powiadomienia krytyczne czasowo
Awaria dla wiadomości Viber/RCS
Dotarcie do użytkowników bez smartfonów
Uniwersalna kompatybilność we wszystkich sieciach komórkowych
Wysokie wskaźniki dostaw (95% +)

Podstawowa wiadomość SMS

Żądanie

KOD_BLOKU_0

Parametry

Parametr	Wpisz	Wymagane	Opis
`od`	ciąg	Tak	Alfanumeryczny identyfikator nadawcy (do 11 znaków)
`do`	ciąg	Tak	Numer telefonu odbiorcy w formacie E.164
`typ`	ciąg	Tak	Ustaw na `"sms"`
`tekst`	ciąg	Tak	Treść wiadomości
`Identyfikator wiadomości klienta`	ciąg	Nie	Twój wewnętrzny identyfikator śledzenia
`ttl`	liczba całkowita	Nie	Czas życia w sekundach

Przykłady

Prosty SMS

KOD_BLOKU_1

SMS z identyfikatorem klienta

KOD_BLOKU_2

SMS-y z TTL

KOD_BLOKU_3

Kodowanie znaków

7-bitowe kodowanie GSM

Standardowy alfabet GSM (160 znaków na SMS):

KOD_BLOKU_4

Rozszerzone znaki GSM

Te znaki liczą się jako 2 znaki:

KOD_BLOKU_5

Kodowanie Unicode (UCS-2).

Wiadomości zawierające znaki specjalne korzystają z kodowania Unicode (70 znaków na SMS):

Emoji: 😀 🎉 ❤️
Cyrylica: А Б В Д Е Ж
Symbole specjalne: ✓ ✗ ★ ♥

Długość wiadomości

Pojedynczy SMS

GSM 7-bit: 160 znaków
Unicode: 70 znaków

Wieloczęściowy SMS

Gdy wiadomość przekracza limit, jest dzielona na wiele części:

GSM 7-bit: 153 znaki na część
Unicode: 67 znaków na część

Przykład

KOD_BLOKU_6

Ta wiadomość (201 znaków) zostanie podzielona na 2 części.

Odpowiedź

Odpowiedź pomyślna

KOD_BLOKU_7

Pola odpowiedzi

Pole	Opis
`Identyfikator wiadomości`	Unikalny identyfikator śledzenia
`stan`	Status wiadomości („zaakceptowana”, „odrzucona”)
`części`	Liczba części SMS
`do`	Numer telefonu odbiorcy

Identyfikator nadawcy

Alfanumeryczny nadawca

Użyj nazwy swojej marki jako nadawcy (do 11 znaków):

KOD_BLOKU_8

Ograniczenia:

Maksymalnie 11 znaków
Tylko litery i cyfry
Żadnych spacji i znaków specjalnych
Odbiorca nie może odpowiadać nadawcom alfanumerycznym

Numeryczny nadawca

Użyj numeru telefonu jako nadawcy (w przypadku wiadomości SMS dwukierunkowych):

KOD_BLOKU_9

Przypadki użycia

Weryfikacja OTP

KOD_BLOKU_10

Powiadomienia o zamówieniach

KOD_BLOKU_11

Przypomnienia o spotkaniach

KOD_BLOKU_12

Potwierdzenia płatności

KOD_BLOKU_13

Najlepsze praktyki

Treść wiadomości

✅ Staraj się, aby wiadomości były zwięzłe i jasne
✅ Dołącz identyfikację nadawcy
✅ W razie potrzeby dodaj wezwanie do działania
✅ Stosuj poprawną gramatykę i ortografię
❌ Unikaj nadmiernej interpunkcji!!!
❌ Nie używaj wielkich liter
❌ Unikaj skracaczy adresów URL, które wyglądają podejrzanie

Użycie znaków

Sprawdź liczbę znaków przed wysłaniem
Uważaj na rozszerzone znaki GSM (licz jako 2)
Przed wysłaniem zbiorczym przetestuj znaki specjalne
Rozważ użycie kodowania GSM w przypadku dłuższych wiadomości

Numery telefonów

Zawsze używaj formatu E.164: +380XXXXXXXXX
Przed wysłaniem sprawdź numery telefonów
Usuń nieprawidłowe numery ze swojej listy
Aktualizuj swoją listę kontaktów

Czas

Przestrzegaj lokalnych stref czasowych
Unikaj wysyłania w nocy (22:00 - 8:00)
Weź pod uwagę godziny pracy w przypadku wiadomości handlowych
Ustaw odpowiedni TTL dla wiadomości wrażliwych na upływ czasu

Zgodność

Uzyskaj zgodę przed wysłaniem wiadomości marketingowych
Dołącz instrukcje dotyczące rezygnacji z promocyjnych SMS-ów
Przestrzegaj lokalnych przepisów (RODO itp.)
Przestrzegaj list „Nie przeszkadzać”.

Obsługa błędów

Typowe błędy

Błąd	Przyczyna	Rozwiązanie
`NIEWAŻNY_ODBIORCA`	Zły format telefonu	Użyj formatu E.164
`INVALID_SENDER`	Nieprawidłowy identyfikator nadawcy	Sprawdź reguły dotyczące identyfikatora nadawcy
`WIADOMOŚĆ_TOO_DŁUGA`	Przekracza maksymalną długość	Podziel lub skróć wiadomość
`NIEWAŻNE_KODOWANIE`	Nieobsługiwane znaki	Użyj GSM lub Unicode

Optymalizacja kosztów

Zmniejsz liczbę części wiadomości

Przechowuj wiadomości o długości poniżej 160 znaków (GSM) lub 70 (Unicode)
Unikaj znaków specjalnych uruchamiających Unicode
W stosownych przypadkach używaj skrótów
Usuń niepotrzebne spacje

Przykładowa optymalizacja

❌ Przed (171 znaków, 2 SMS-y): KOD_BLOKU_14

✅ Po (156 znaków, 1 SMS): KOD_BLOKU_15

Wysyłanie zbiorcze

Wyślij wiele wiadomości w jednym żądaniu:

KOD_BLOKU_16

Następne kroki

– Wiadomości Viber – Wiadomości multimedialne - Wiadomości RCS - Bogate usługi komunikacyjne - Sprawdź stan - Śledź stan dostawy - Strategie awaryjne - Skonfiguruj strategie awaryjne