Help Center Wiadomości SMS

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

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

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

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS z identyfikatorem klienta

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS-y z TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Kodowanie znaków

7-bitowe kodowanie GSM

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

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Rozszerzone znaki GSM

Te znaki liczą się jako 2 znaki:

| ^ € { } [ ] ~ \

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

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

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

Odpowiedź

Odpowiedź pomyślna

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

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):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

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):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Przypadki użycia

Weryfikacja OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Powiadomienia o zamówieniach

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Przypomnienia o spotkaniach

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Potwierdzenia płatności

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

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
- 8
)
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):

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

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

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Wysyłanie zbiorcze

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

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

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

Search Results