SMS poruke

Šaljite standardne tekstualne poruke koristeći SMSBAT API. SMS je najuniverzalniji kanal za razmjenu poruka s najvišim stopama isporuke na svim mobilnim uređajima.

Pregled

SMS (Short Message Service) je idealan za:

Vremenski kritična obaveštenja
Zamjena za Viber/RCS poruke
Dopiranje do korisnika bez pametnih telefona
Univerzalna kompatibilnost na svim mobilnim mrežama
Visoke stope isporuke (95%+)

Osnovna SMS poruka

Zahtjev

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

Parametri

Parametar	Vrsta	Obavezno	Opis
`od`	string	Da	Alfanumerički ID pošiljaoca (do 11 znakova)
`to`	string	Da	Telefonski broj primaoca u formatu E.164
`tip`	string	Da	Postavite na `"sms"`
`tekst`	string	Da	Sadržaj poruke
`customerMessageId`	string	Ne	Vaš interni ID za praćenje
`ttl`	cijeli broj	Ne	Vrijeme života u sekundama

Primjeri

Jednostavan 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 sa ID-om korisnika

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

SMS sa TTL

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

Kodiranje znakova

GSM 7-bitno kodiranje

Standardna GSM abeceda (160 znakova po SMS):

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

Prošireni GSM znakovi

Ovi znakovi se računaju kao 2 znaka:

| ^ € { } [ ] ~ \

Unicode (UCS-2) kodiranje

Poruke sa posebnim znakovima koriste Unicode kodiranje (70 znakova po SMS-u):

Emoji: 😀 🎉 ❤️
Ćirilica: A B V G D E Ž
Posebni simboli: ✓ ✗ ★ ♥

Dužina poruke

Jedan SMS

GSM 7-bit: 160 znakova
Unicode: 70 znakova

Višedijelni SMS

Kada vaša poruka premaši ograničenje, ona se dijeli na više dijelova:

GSM 7-bit: 153 karaktera po dijelu
Unicode: 67 znakova po dijelu

Primjer

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

Ova poruka (201 karakter) će biti podijeljena na 2 dijela.

Odgovor

Uspješan odgovor

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

Polja odgovora

Polje	Opis
`messageId`	Jedinstveni identifikator za praćenje
`status`	Status poruke (`prihvaćeno`, `odbijeno`)
`dijelovi`	Broj SMS dijelova
`to`	Broj telefona primaoca

ID pošiljaoca

Alfanumerički pošiljalac

Koristite naziv svoje robne marke kao pošiljaoca (do 11 znakova):

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

Ograničenja:

Najviše 11 znakova
Samo slova i brojevi
Bez razmaka ili posebnih znakova
Primalac ne može odgovoriti alfanumeričkim pošiljaocima

Numerički pošiljalac

Koristite broj telefona kao pošiljaoca (za dvosmjerni SMS):

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

Slučajevi upotrebe

OTP verifikacija

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

Obavještenja o narudžbi

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

Podsjetnici za sastanke

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

Potvrde plaćanja

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

Najbolje prakse

Sadržaj poruke

✅ Neka poruke budu sažete i jasne
✅ Uključuje identifikaciju pošiljaoca
✅ Dodajte poziv na akciju ako je potrebno
✅ Koristite pravilnu gramatiku i pravopis
❌ Izbegavajte preteranu interpunkciju!!!
❌ Nemojte koristiti sva VELIKA MATERIJALA
❌ Izbjegavajte skraćivače URL-ova koji izgledaju sumnjivo

Upotreba znakova

Provjerite broj znakova prije slanja
Budite svjesni proširenih GSM znakova (računajte kao 2)
Testirajte sa posebnim znakovima prije masovnog slanja
Razmislite o korištenju GSM kodiranja za duže poruke

Brojevi telefona

Uvijek koristite format E.164: +380XXXXXXXXX
Potvrdite brojeve telefona prije slanja
Uklonite nevažeće brojeve sa svoje liste
Održavajte svoju listu kontakata ažuriranom

Tajming

Poštujte lokalne vremenske zone
Izbjegavajte slanje noću (22 h - 8 h)
Uzmite u obzir radno vrijeme za komercijalne poruke
Postavite odgovarajući TTL za vremenski osjetljive poruke

Usklađenost

Pribavite pristanak prije slanja marketinških poruka
Uključuje upute za odustajanje od promotivnih SMS-ova
Pridržavajte se lokalnih propisa (GDPR, itd.)
Poštujte liste "Ne uznemiravaj".

Rukovanje greškama

Uobičajene greške

Greška	Uzrok	Rješenje
`INVALID_RECIPIENT`	Pogrešan format telefona	Koristite format E.164
`INVALID_SENDER`	Nevažeći ID pošiljaoca	Provjerite pravila za ID pošiljaoca
`MESSAGE_TOO_LONG`	Premašuje maksimalnu dužinu	Podijelite ili skratite poruku
`INVALID_ENCODING`	Nepodržani znakovi	Koristite GSM ili Unicode

Optimizacija troškova

Smanjite dijelove poruke

Čuvajte poruke ispod 160 karaktera (GSM) ili 70 (Unicode)
Izbjegavajte posebne znakove koji aktiviraju Unicode
Koristite skraćenice kada je to prikladno
Uklonite nepotrebne prostore

Primjer optimizacije

❌ Pre (171 karakter, 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.

✅ Nakon (156 karaktera, 1 SMS):

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

Bulk Slanje

Pošaljite više poruka u jednom zahtjevu:

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

Sljedeći koraci

Viber poruke - Razmjena bogatih medijskih poruka
RCS poruke - Bogate komunikacijske usluge
Provjeri status - Pratite status isporuke
Fallback Strategies - Konfigurirajte rezervne