SMS sporočila

Pošiljajte standardna besedilna sporočila z uporabo API-ja SMSBAT. SMS je najbolj univerzalen kanal za sporočanje z najvišjimi stopnjami dostave v vseh mobilnih napravah.

Pregled

SMS (Storitev kratkih sporočil) je idealna za:

Časovno kritična obvestila
Nadomestna za sporočila Viber/RCS
Doseganje uporabnikov brez pametnih telefonov
Univerzalna združljivost v vseh mobilnih omrežjih
Visoke stopnje dostave (95 %+)

Osnovno SMS sporočilo

Zahteva

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

Parametri

Parameter	Vrsta	Zahtevano	Opis
`od`	niz	Da	Alfanumerični ID pošiljatelja (do 11 znakov)
`do`	niz	Da	Telefonska številka prejemnika v formatu E.164
`tip`	niz	Da	Nastavite na `"sms"`
`besedilo`	niz	Da	Vsebina sporočila
`customerMessageId`	niz	Ne	Vaš interni ID za sledenje
`ttl`	celo število	Ne	Življenjski čas v sekundah

Primeri

Preprost 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 z ID-jem stranke

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

Kodiranje znakov

GSM 7-bitno kodiranje

Standardna GSM abeceda (160 znakov na SMS):

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

Razširjeni znaki GSM

Ti znaki štejejo kot 2 znaka:

| ^ € { } [ ] ~ \

Kodiranje Unicode (UCS-2).

Sporočila s posebnimi znaki uporabljajo kodiranje Unicode (70 znakov na SMS):

Emoji: 😀 🎉 ❤️
Cirilica: А Б В Г Д Е Ж
Posebni simboli: ✓ ✗ ★ ♥

Dolžina sporočila

Posamezen SMS

GSM 7-bit: 160 znakov
Unicode: 70 znakov

SMS iz več delov

Ko vaše sporočilo preseže omejitev, se razdeli na več delov:

GSM 7-bit: 153 znakov na del
Unicode: 67 znakov na del

Primer

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

To sporočilo (201 znak) bo razdeljeno na 2 dela.

Odgovor

Uspešen odziv

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

Polja odgovora

Polje	Opis
`id sporočila`	Enolični identifikator za sledenje
`stanje`	Status sporočila (`sprejeto`, `zavrnjeno`)
`deli`	Število delov SMS
`do`	Telefonska številka prejemnika

ID pošiljatelja

Alfanumerični pošiljatelj

Kot pošiljatelja uporabite ime svoje blagovne znamke (do 11 znakov):

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

Omejitve:

Največ 11 znakov
Samo črke in številke
Brez presledkov ali posebnih znakov
Prejemnik ne more odgovoriti alfanumeričnim pošiljateljem

Numerični pošiljatelj

Uporabite telefonsko številko kot pošiljatelja (za dvosmerna sporočila SMS):

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

Primeri uporabe

OTP preverjanje

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

Obvestila o naročilu

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

Opomniki za sestanke

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

Potrdila plačila

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

Najboljše prakse

Vsebina sporočila

✅ Sporočila naj bodo jedrnata in jasna
✅ Vključite identifikacijo pošiljatelja
✅ Po potrebi dodajte poziv k dejanju
✅ Uporabljajte pravilno slovnico in črkovanje
❌ Izogibajte se pretiranim ločilom!!!
❌ Ne uporabljajte samo VELIKIH črk
❌ Izogibajte se skrajšalcem URL-jev, ki so videti sumljivi

Uporaba znakov

Pred pošiljanjem preverite število znakov
Bodite pozorni na razširjene znake GSM (štejte kot 2)
Preizkusite s posebnimi znaki pred množičnim pošiljanjem
Razmislite o uporabi kodiranja GSM za daljša sporočila

Telefonske številke

Vedno uporabite format E.164: +380XXXXXXXXX
Pred pošiljanjem potrdite telefonske številke
Odstranite neveljavne številke s seznama
Posodabljajte svoj seznam stikov

Čas

Spoštujte lokalne časovne pasove
Izogibajte se pošiljanju ponoči (22.00 - 8.00)
Upoštevajte delovni čas za komercialna sporočila
Nastavite ustrezen TTL za časovno občutljiva sporočila

Skladnost

Pridobite soglasje pred pošiljanjem marketinških sporočil
Vključite navodila za zavrnitev promocijskih sporočil SMS
Upoštevajte lokalne predpise (GDPR itd.)
Spoštujte sezname »Ne moti«.

Obravnava napak

Pogoste napake

Napaka	Vzrok	Rešitev
`NEVELJAVNI_PREJEMNIK`	Napačen format telefona	Uporabi format E.164
`NEVALID_SENDER`	Neveljaven ID pošiljatelja	Preverite pravila ID pošiljatelja
`MESSAGE_TOO_LONG`	Presega največjo dolžino	Razdeli ali skrajšaj sporočilo
`NEVELJAVNO_KODIRANJE`	Nepodprti znaki	Uporabi GSM ali Unicode

Optimizacija stroškov

Zmanjšaj dele sporočila

Naj bodo sporočila krajša od 160 znakov (GSM) ali 70 (Unicode)
Izogibajte se posebnim znakom, ki sprožijo Unicode
Po potrebi uporabite okrajšave
Odstranite nepotrebne prostore

Primer optimizacije

❌ Pred (171 znakov, 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.

✅ 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.

Množično pošiljanje

Pošlji več sporočil v eni zahtevi:

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

Naslednji koraki

– Sporočila Viber – Obogatena predstavnostna sporočila - RCS sporočila - Bogate komunikacijske storitve - Preveri stanje - Sledite stanju dostave - Nadomestne strategije - Konfigurirajte nadomestne možnosti