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