Help Center SMS správ

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

Viber Messages - Multimediálne správy
Správy RCS - Rozšírené komunikačné služby
Skontrolovať stav - Sledujte stav doručenia
Záložné stratégie - Nakonfigurujte zálohy

Search Results