Preskoči na sadržaj

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) idealan je za:

  • Vremenski kritične obavijesti
  • 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 Upišite Obavezno Opis
od niz Da Alfanumerički ID pošiljatelja (do 11 znakova)
za niz Da Telefonski broj primatelja u formatu E.164
tip niz Da Postavite na "sms"
tekst niz Da Sadržaj poruke
customerMessageId niz Ne Vaš interni ID praćenja
ttl cijeli broj Ne Vrijeme do ž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 s korisničkim ID-om

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

SMS s TTL-om

{
  "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-u):

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

Prošireni GSM znakovi

Ovi se znakovi računaju kao 2 znaka:

| ^ € { } [ ] ~ \

Unicode (UCS-2) kodiranje

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

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

Duljina poruke

Jedan SMS

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

Višedijelni SMS

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

  • GSM 7-bit: 153 znaka 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 znak) bit će podijeljena u 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
id poruke Jedinstveni identifikator za praćenje
status Status poruke (prihvaćeno, odbijeno)
dijelovi Broj dijelova SMS-a
za Broj telefona primatelja

ID pošiljatelja

Alfanumerički pošiljatelj

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

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

Ograničenja:

  • Najviše 11 znakova
  • Samo slova i brojke
  • Bez razmaka ili posebnih znakova
  • Primatelj ne može odgovoriti alfanumeričkim pošiljateljima

Numerički pošiljatelj

Koristite telefonski broj kao pošiljatelja (za dvosmjerni SMS):

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

Slučajevi upotrebe

OTP potvrda

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

Obavijesti o narudžbi

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

Podsjetnici za termine

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

Najbolji primjeri iz prakse

Sadržaj poruke

  • ✅ Neka poruke budu sažete i jasne
  • ✅ Uključi identifikaciju pošiljatelja
  • ✅ Dodajte poziv na radnju ako je potrebno
  • ✅ Koristite odgovarajuću gramatiku i pravopis
  • ❌ Izbjegavajte pretjeranu interpunkciju!!!
  • ❌ Nemojte koristiti samo VELIKA SLOVA
  • ❌ Izbjegavajte skraćivače URL-ova koji izgledaju sumnjivo

Upotreba znakova

  • Provjerite broj znakova prije slanja
  • Imajte na umu proširene GSM znakove (brojite kao 2)
  • Testirajte posebnim znakovima prije skupnog slanja
  • Razmislite o korištenju GSM kodiranja za duže poruke

Brojevi telefona

  • Uvijek koristite format E.164: +380XXXXXXXXX
  • Provjerite telefonske brojeve prije slanja
  • Uklonite nevažeće brojeve sa svog popisa
  • Redovno ažurirajte svoj popis kontakata

Vrijeme

  • Poštujte lokalne vremenske zone
  • Izbjegavajte slanje noću (22:00 - 08:00)
  • Razmotrite radno vrijeme za komercijalne poruke
  • Postavite odgovarajući TTL za vremenski osjetljive poruke

Sukladnost

  • Dobiti privolu prije slanja marketinških poruka
  • Uključite upute za isključivanje promotivnih SMS-ova
  • Slijedite lokalne propise (GDPR, itd.)
  • Poštujte popise "Ne uznemiravaj".

Rješavanje grešaka

Uobičajene pogreške

Greška Uzrok Rješenje
INVALID_RECIPIENT Pogrešan format telefona Koristite format E.164
INVALID_SENDER Nevažeći ID pošiljatelja Provjerite pravila ID pošiljatelja
MESSAGE_TOO_LONG Premašuje maksimalnu duljinu Podijeli ili skrati poruku
INVALID_ENCODING Nepodržani znakovi Koristite GSM ili Unicode

Optimizacija troškova

Smanjite dijelove poruke

  • Držite poruke ispod 160 znakova (GSM) ili 70 (Unicode)
  • Izbjegavajte posebne znakove koji pokreću Unicode
  • Koristite kratice kada je to prikladno
  • Uklonite nepotrebne razmake

Primjer optimizacije

❌ Prije (171 znak, 2 SMS-a): 

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

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

Skupno slanje

Pošalji 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