SMS žinutės

Siųskite standartinius tekstinius pranešimus naudodami SMSBAT API. SMS yra universaliausias pranešimų kanalas, kurio pristatymo rodikliai yra didžiausi visuose mobiliuosiuose įrenginiuose.

Apžvalga

SMS (trumpųjų žinučių paslauga) idealiai tinka:

Svarbūs laiko pranešimai
Viber / RCS pranešimų atsarginė dalis
Pasiekti vartotojus be išmaniųjų telefonų
Universalus suderinamumas visuose mobiliojo ryšio tinkluose
Aukšti pristatymo rodikliai (95%+)

Pagrindinė SMS žinutė

Prašymas

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

Parametrai

Parametras	Tipas	Reikalingas	Aprašymas
"nuo"	styga	Taip	Raidinis ir skaitmeninis siuntėjo ID (iki 11 simbolių)
"į"	styga	Taip	Gavėjo telefono numeris E.164 formatu
"tipas"	styga	Taip	Nustatyti į `"sms"`
"tekstas"	styga	Taip	Pranešimo turinys
„customerMessageId“	styga	Ne	Jūsų vidinis stebėjimo ID
`ttl`	sveikasis skaičius	Ne	Laikas gyventi sekundėmis

Pavyzdžiai

Paprasta 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 su kliento ID

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

SMS su TTL

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

Simbolių kodavimas

GSM 7 bitų kodavimas

Standartinė GSM abėcėlė (160 simbolių vienoje SMS):

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

Išplėstiniai GSM simboliai

Šie simboliai skaičiuojami kaip 2 simboliai:

| ^ € { } [ ] ~ \

Unikodo (UCS-2) kodavimas

Žinutės su specialiais simboliais naudoja Unicode kodavimą (70 simbolių vienoje SMS):

Jaustukai: 😀 🎉 ❤️
Kirilica: А Б В Г Д Е Ж
Specialūs simboliai: ✓ ✗ ★ ♥

Pranešimo ilgis

Viena SMS

GSM 7 bitų: 160 simbolių
Unikodas: 70 simbolių

Kelių dalių SMS

Kai jūsų pranešimas viršija limitą, jis padalijamas į kelias dalis:

GSM 7 bitai: 153 simboliai vienoje dalyje
Unikodas: 67 simboliai vienoje dalyje

Pavyzdys

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

Šis pranešimas (201 simbolis) bus padalintas į 2 dalis.

Atsakymas

Sėkmės atsakas

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

Atsakymo laukai

Laukas	Aprašymas
`messageId`	Unikalus stebėjimo identifikatorius
"būsena"	Pranešimo būsena („priimta“, „atmesta“)
"detalės"	SMS dalių skaičius
"į"	Gavėjo telefono numeris

Siuntėjo ID

Raidinis ir skaitmeninis siuntėjas

Naudokite savo prekės pavadinimą kaip siuntėją (iki 11 simbolių):

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

Apribojimai:

Daugiausia 11 simbolių
Tik raidės ir skaičiai
Jokių tarpų ar specialiųjų simbolių
Gavėjas negali atsakyti raidiniams ir skaitiniams siuntėjams

Skaitmeninis siuntėjas

Naudokite telefono numerį kaip siuntėją (dvipusėms SMS žinutėms):

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

Naudojimo atvejai

OTP patvirtinimas

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

Užsakymo pranešimai

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

Susitikimo priminimai

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

Mokėjimo patvirtinimai

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

Geriausia praktika

Pranešimo turinys

✅ Laikykite pranešimus glaustus ir aiškius
✅ Įtraukite siuntėjo identifikaciją
✅ Jei reikia, pridėkite raginimą veikti
✅ Naudokite tinkamą gramatiką ir rašybą
❌ Venkite perteklinių skyrybos ženklų!!!
❌ Nenaudokite visų didžiųjų raidžių
❌ Venkite įtartinai atrodančių URL sutrumpinimo priemonių

Simbolių naudojimas

Prieš siųsdami patikrinkite simbolių skaičių
Atkreipkite dėmesį į išplėstinius GSM simbolius (skaičiuokite kaip 2)
Prieš masinį siuntimą išbandykite naudodami specialiuosius simbolius
Apsvarstykite galimybę naudoti GSM kodavimą ilgesniems pranešimams

Telefono numeriai

– Visada naudokite E.164 formatą: „+380XXXXXXXXX“. - Prieš siųsdami patvirtinkite telefono numerius - Pašalinkite neteisingus numerius iš sąrašo - Atnaujinkite savo kontaktų sąrašą

Laikas

Gerbkite vietines laiko juostas
Venkite siųsti naktį (22:00–8:00) – Apsvarstykite komercinių pranešimų darbo valandas
Nustatykite atitinkamą TTL laiko jautriems pranešimams

Atitiktis

Prieš siųsdami rinkodaros pranešimus, gaukite sutikimą – Įtraukite reklaminių SMS atsisakymo instrukcijas
Laikykitės vietinių taisyklių (BDAR ir kt.) – Gerbkite „Netrukdymo režimo“ sąrašus

Klaidų tvarkymas

Dažnos klaidos

Klaida	Priežastis	Sprendimas
„INVALID_RECIPIENT“	Netinkamas telefono formatas	Naudokite E.164 formatą
„INVALID_SENDER“	Neteisingas siuntėjo ID	Patikrinkite siuntėjo ID taisykles
`MESSAGE_TOO_LONG`	Viršija maksimalų ilgį	Padalinkite arba sutrumpinkite pranešimą
"INVALID_ENCODING"	Nepalaikomi simboliai	Naudokite GSM arba Unicode

Išlaidų optimizavimas

Sumažinkite pranešimų dalis

Laikykite pranešimus iki 160 simbolių (GSM) arba 70 (Unicode)
Venkite specialių simbolių, kurie suaktyvina Unicode
Jei reikia, naudokite santrumpas
Pašalinkite nereikalingas vietas

Optimizavimo pavyzdys

❌ Prieš (171 simbolis, 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 simboliai, 1 SMS):

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

Masinis siuntimas

Siųsti kelis pranešimus vienu prašymu:

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

Kiti žingsniai

– Viber Messages – Raiškiosios medijos pranešimai – RCS pranešimai – turtingos komunikacijos paslaugos – Patikrinti būseną – Stebėti pristatymo būseną – Atsarginės strategijos – Konfigūruokite atsargines strategijas