Preskočiť na obsah

SMS správ

Posielajte štandardné textové správy pomocou SMSBAT API. SMS je najuniverzálnejší kanál na odosielanie správ s najvyššími rýchlosťami doručenia na všetkých mobilných zariadeniach.

Prehľad

Služba SMS (Short Message Service) je ideálna pre:

  • Časovo kritické upozornenia
  • Záloha pre správy Viber/RCS
  • Oslovenie používateľov bez smartfónov
  • Univerzálna kompatibilita vo všetkých mobilných sieťach
  • Vysoké sadzby za doručenie (95 %+)

Základná SMS správa

Žiadosť

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

Parametre

Parameter Typ povinné Popis
"od" reťazec áno Alfanumerické ID odosielateľa (až 11 znakov)
"do" reťazec áno Telefónne číslo príjemcu vo formáte E.164
"typ" reťazec áno Nastaviť na "sms"
"text" reťazec áno Obsah správy
customerMessageId reťazec Nie Vaše interné ID sledovania
ttl celé číslo Nie Čas do života v sekundách

Príklady

Jednoduchá 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 s ID zákazníka

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

SMS s TTL

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

Kódovanie znakov

GSM 7-bitové kódovanie

Štandardná GSM abeceda (160 znakov na SMS):

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

Rozšírené znaky GSM

Tieto znaky sa počítajú ako 2 znaky:

| ^ € { } [ ] ~ \

Kódovanie Unicode (UCS-2).

Správy so špeciálnymi znakmi používajú kódovanie Unicode (70 znakov na SMS):

  • Emoji: 😀 🎉 ❤️
  • Cyrilika: А Б В Г Д Е Ж
  • Špeciálne symboly: ✓ ✗ ★ ♥

Dĺžka správy

Jedna SMS

  • GSM 7-bit: 160 znakov
  • Unicode: 70 znakov

Viacdielna SMS

Keď vaša správa prekročí limit, rozdelí sa na viacero častí:

  • GSM 7-bit: 153 znakov na časť
  • Unicode: 67 znakov na časť

Príklad

{
  "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."
  }]
}

Táto správa (201 znakov) bude rozdelená na 2 časti.

Odpoveď

Úspešná odpoveď

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

Polia odpovedí

Pole Popis
messageId Jedinečný identifikátor pre sledovanie
"stav" Stav správy ("prijaté", "odmietnuté")
"časti" Počet častí SMS
"do" Telefónne číslo príjemcu

ID odosielateľa

Alfanumerický odosielateľ

Ako odosielateľa použite názov svojej značky (až 11 znakov):

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

Obmedzenia:

  • Maximálne 11 znakov
  • Iba písmená a čísla
  • Žiadne medzery alebo špeciálne znaky
  • Príjemca nemôže odpovedať alfanumerickým odosielateľom

Číselný odosielateľ

Ako odosielateľa použiť telefónne číslo (pre obojsmerné SMS):

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

Prípady použitia

Overenie jednorazového hesla

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

Upozornenia na objednávku

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

Pripomenutia schôdzok

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

Potvrdenia platieb

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

Osvedčené postupy

Obsah správy

  • ✅ Udržujte správy stručné a jasné
  • ✅ Zahrňte identifikáciu odosielateľa
  • ✅ V prípade potreby pridajte výzvu na akciu
  • ✅ Používajte správnu gramatiku a pravopis
  • ❌ Vyhnite sa nadmernej interpunkcii!!!
  • ❌ Nepoužívajte všetky veľké písmená
  • ❌ Vyhnite sa skracovačom adries URL, ktoré vyzerajú podozrivo

Používanie znakov

  • Pred odoslaním skontrolujte počet znakov
  • Dávajte pozor na rozšírené znaky GSM (počítajte ako 2)
  • Pred hromadným odoslaním otestujte špeciálnymi znakmi
  • Zvážte použitie kódovania GSM pre dlhšie správy

Telefónne čísla

  • Vždy používajte formát E.164: +380XXXXXXXXX
  • Pred odoslaním overte telefónne čísla
  • Odstráňte neplatné čísla zo svojho zoznamu
  • Udržujte svoj zoznam kontaktov aktualizovaný

Načasovanie

  • Rešpektujte miestne časové pásma
  • Neposielajte v noci (22:00 – 8:00)
  • Berte do úvahy pracovnú dobu pre komerčné správy
  • Nastavte vhodné TTL pre časovo citlivé správy

Súlad

  • Pred odoslaním marketingových správ získajte súhlas
  • Zahrňte pokyny na odhlásenie pre propagačné SMS
  • Dodržiavajte miestne predpisy (GDPR atď.)
  • Rešpektujte zoznamy „Nerušiť“.

Spracovanie chýb

Bežné chyby

Chyba Príčina Riešenie
INVALID_RECIPIENT Nesprávny formát telefónu Použite formát E.164
INVALID_SENDER Neplatné ID odosielateľa Skontrolujte pravidlá ID odosielateľa
MESSAGE_TOO_LONG Presahuje maximálnu dĺžku Rozdeliť alebo skrátiť správu
INVALID_ENCODING Nepodporované znaky Použite GSM alebo Unicode

Optimalizácia nákladov

Znížte počet častí správy

  • Udržujte správy do 160 znakov (GSM) alebo 70 (Unicode)
  • Vyhnite sa špeciálnym znakom, ktoré spúšťajú Unicode
  • V prípade potreby používajte skratky
  • Odstráňte nepotrebné miesta

Príklad optimalizácie

❌ Pred (171 znakov, 2 SMS): 

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 znakov, 1 SMS): 

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

Hromadné odosielanie

Odoslanie viacerých správ v jednej žiadosti:

{
  "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"
    }
  ]
}

Ďalšie kroky