Přeskočit obsah

SMS zpráv

Odesílejte standardní textové zprávy pomocí SMSBAT API. SMS je nejuniverzálnějším kanálem pro zasílání zpráv s nejvyšší rychlostí doručení na všech mobilních zařízeních.

Přehled

SMS (Short Message Service) je ideální pro:

  • Časově kritická oznámení
  • Záloha pro zprávy Viber/RCS
  • Oslovení uživatelů bez chytrých telefonů
  • Univerzální kompatibilita napříč všemi mobilními sítěmi
  • Vysoké sazby za doručení (95 %+)

Základní SMS zpráva

Žádost

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

Parametry

Parametr Typ Povinné Popis
"od" řetězec Ano Alfanumerické ID odesílatele (až 11 znaků)
do řetězec Ano Telefonní číslo příjemce ve formátu E.164
"typ" řetězec Ano Nastavit na "sms"
"text" řetězec Ano Obsah zprávy
customerMessageId řetězec Ne Vaše interní ID sledování
ttl celé číslo Ne Doba žití v sekundách

Pří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ódování znaků

GSM 7bitové kódování

Standardní GSM abeceda (160 znaků na SMS):

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

Rozšířené znaky GSM

Tyto znaky se počítají jako 2 znaky:

| ^ € { } [ ] ~ \

Kódování Unicode (UCS-2).

Zprávy se speciálními znaky používají kódování Unicode (70 znaků na SMS):

  • Emoji: 😀 🎉 ❤️
  • Cyrilice: А Б В Г Д Е Ж
  • Speciální symboly: ✓ ✗ ★ ♥

Délka zprávy

Jedna SMS

  • GSM 7-bit: 160 znaků
  • Unicode: 70 znaků

Vícedílná SMS

Když vaše zpráva překročí limit, je rozdělena do několika částí:

  • GSM 7-bit: 153 znaků na část
  • Unicode: 67 znaků na část

Pří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."
  }]
}

Tato zpráva (201 znaků) bude rozdělena na 2 části.

Odpověď

Úspěšná odpověď

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

Pole odpovědí

Pole Popis
ID zprávy Jedinečný identifikátor pro sledování
"stav" Stav zprávy ("přijato", "odmítnuto")
"díly" Počet částí SMS
do Telefonní číslo příjemce

ID odesílatele

Alfanumerický odesílatel

Jako odesílatele použijte název své značky (až 11 znaků):

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

Omezení:

  • Maximálně 11 znaků
  • Pouze písmena a číslice
  • Žádné mezery nebo speciální znaky
  • Příjemce nemůže odpovědět alfanumerickým odesílatelům

Číselný odesílatel

Jako odesílatele použijte telefonní číslo (pro obousměrné SMS):

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

Případy použití

OTP ověření

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

Oznámení o objednávce

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

Připomenutí schůzek

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

Potvrzení platby

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

Nejlepší postupy

Obsah zprávy

  • ✅ Udržujte zprávy stručné a jasné
  • ✅ Zahrňte identifikaci odesílatele
  • ✅ V případě potřeby přidejte výzvu k akci
  • ✅ Používejte správnou gramatiku a pravopis
  • ❌ Vyhněte se nadměrné interpunkci!!!
  • ❌ Nepoužívejte všechna velká písmena
  • ❌ Vyhněte se zkracovačům URL, které vypadají podezřele

Použití znaků

  • Před odesláním zkontrolujte počet znaků
  • Dávejte pozor na rozšířené znaky GSM (počítejte jako 2)
  • Před hromadným odesláním otestujte speciální znaky
  • Zvažte použití GSM kódování pro delší zprávy

Telefonní čísla

  • Vždy používejte formát E.164: +380XXXXXXXXX
  • Před odesláním ověřte telefonní čísla
  • Odstraňte neplatná čísla ze svého seznamu
  • Udržujte svůj seznam kontaktů aktualizovaný

Načasování

  • Respektujte místní časová pásma
  • Vyhněte se odesílání v noci (22:00 – 8:00)
  • Vezměte v úvahu pracovní dobu pro obchodní sdělení
  • Nastavte vhodné TTL pro časově citlivé zprávy

Soulad

  • Před zasíláním marketingových sdělení získat souhlas
  • Zahrňte pokyny pro odhlášení pro propagační SMS
  • Dodržujte místní předpisy (GDPR atd.)
  • Respektujte seznamy „Nerušit“.

Zpracování chyb

Běžné chyby

Chyba Příčina Řešení
INVALID_RECIPIENT Špatný formát telefonu Použijte formát E.164
INVALID_SENDER Neplatné ID odesílatele Zkontrolujte pravidla ID odesílatele
MESSAGE_TOO_LONG Překračuje maximální délku Rozdělit nebo zkrátit zprávu
INVALID_ENCODING Nepodporované znaky Použijte GSM nebo Unicode

Optimalizace nákladů

Snižte počet částí zprávy

  • Udržujte zprávy kratší než 160 znaků (GSM) nebo 70 (Unicode)
  • Vyhněte se speciálním znakům, které spouštějí Unicode
  • V případě potřeby používejte zkratky
  • Odstraňte zbytečné mezery

Příklad optimalizace

❌ Před (171 znaků, 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 znaků, 1 SMS): 

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

Hromadné odesílání

Odeslat více zpráv v jedné žádosti:

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

Další kroky