Help Center SMS-sõnumid

SMS-sõnumid

Saatke standardseid tekstsõnumeid SMSBAT API abil. SMS on kõige universaalsem sõnumsidekanal, millel on kõrgeim kohaletoimetamismäär kõigis mobiilseadmetes.

Ülevaade

SMS (lühisõnumiteenus) sobib ideaalselt:

Ajakriitilised teatised
Viberi/RCS-sõnumite tagavara
Nutitelefonideta kasutajateni jõudmine
Universaalne ühilduvus kõigis mobiilsidevõrkudes
Kõrged tarnemäärad (95%+)

Põhiline SMS-sõnum

Taotlus

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

Parameetrid

Parameeter	Tüüp	Nõutav	Kirjeldus
”alates”	string	Jah	Tähtnumbriline saatja ID (kuni 11 tähemärki)
`kuni`	string	Jah	Saaja telefoninumber vormingus E.164
”tüüp”	string	Jah	Määrake ‘“sms“‘
`tekst`	string	Jah	Sõnumi sisu
`customerMessageId`	string	Ei	Teie sisemine jälgimise ID
`ttl`	täisarv	Ei	Eluaeg sekundites

Näited

Lihtne 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 kliendi ID-ga

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

SMS TTL-iga

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

Tähemärgi kodeering

GSM 7-bitine kodeering

Standardne GSM-tähestik (160 tähemärki SMS-i kohta):

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

Laiendatud GSM-märgid

Need märgid loetakse kaheks märgiks:

| ^ € { } [ ] ~ \

Unicode (UCS-2) kodeering

Erimärkidega sõnumid kasutavad Unicode’i kodeeringut (70 tähemärki SMS-i kohta):

Emotikonid: 😀 🎉 ❤️
Kirillitsa: А Б В Г Д Е Ж
Erisümbolid: ✓ ✗ ★ ♥

Sõnumi pikkus

Üks SMS

GSM 7-bitine: 160 tähemärki
Unicode: 70 tähemärki

Mitmeosaline SMS

Kui teie sõnum ületab limiiti, jagatakse see mitmeks osaks.

GSM 7-bitine: 153 tähemärki osa kohta
Unicode: 67 tähemärki osa kohta

Näide

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

See sõnum (201 tähemärki) jagatakse kaheks osaks.

Vastus

Edukas vastus

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

Vastuseväljad

Väli	Kirjeldus
`messageId`	Unikaalne identifikaator jälgimiseks
`olek`	Sõnumi olek (vastuvõetud, tagasi lükatud)
`osad`	SMS-i osade arv
`kuni`	Saaja telefoninumber

Saatja ID

Tähtnumbriline saatja

Kasutage saatjana oma brändinime (kuni 11 tähemärki):

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

Piirangud:

Maksimaalselt 11 tähemärki
Ainult tähed ja numbrid
Ei mingeid tühikuid ega erimärke
Saaja ei saa vastata tähtnumbrilistele saatjatele

Numbriline saatja

Kasutage saatjana telefoninumbrit (kahesuunalise SMS-i jaoks):

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

Kasutusjuhtumid

OTP kinnitus

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

Tellimuse teatised

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

Kohtumise meeldetuletused

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

Maksekinnitused

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

Parimad tavad

Sõnumi sisu

✅ Hoidke sõnumid lühikesed ja selged
✅ Kaasake saatja tunnus
✅ Vajadusel lisa üleskutse tegevusele
✅ Kasutage õiget grammatikat ja õigekirja
❌ Väldi liigseid kirjavahemärke!!!
❌ Ärge kasutage suuri suurtähti
❌ Vältige kahtlasena tunduvaid URL-i lühendajaid

Tähemärgi kasutamine

Enne saatmist kontrollige tähemärkide arvu
Olge teadlik laiendatud GSM-märkidest (loetage 2-ks)
Enne hulgi saatmist testige erimärkidega
Pikemate sõnumite jaoks kaaluge GSM-kodeeringu kasutamist

Telefoninumbrid

Kasutage alati vormingut E.164: „+380XXXXXXXXX”.
Enne saatmist kinnitage telefoninumbrid
Eemaldage oma loendist kehtetud numbrid
Hoidke oma kontaktide loendit ajakohasena

Ajastus

Austage kohalikke ajavööndeid
Vältige saatmist öösel (22.00–8.00)
Kaaluge äriteadete tööaegu
Määrake ajatundlike sõnumite jaoks sobiv TTL

Vastavus

Enne turundussõnumite saatmist hankige nõusolek
Kaasake reklaam-SMS-idest loobumisjuhised
Järgige kohalikke eeskirju (GDPR jne)
Austage “Ära sega” loendeid

Vigade käsitlemine

Levinud vead

Viga	Põhjus	Lahendus
”INVALID_RECIPIENT”	Vale telefoni vorming	Kasutage vormingut E.164
”INVALID_SENDER”	Vale saatja ID	Kontrollige saatja ID reegleid
`MESSAGE_TOO_LONG`	Ületab maksimaalse pikkuse	Sõnumi poolitamine või lühendamine
”INVALID_ENCODING”	Toetamata märgid	Kasutage GSM-i või Unicode’i

Kulude optimeerimine

Sõnumi osade vähendamine

Hoidke sõnumeid alla 160 tähemärgi (GSM) või 70 (Unicode)
Vältige Unicode’i käivitavaid erimärke
Kasutage vajadusel lühendeid
Eemaldage mittevajalikud ruumid

Optimeerimise näide

❌ Enne (171 tähemärki, 2 SMS-i):

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.

✅ Pärast (156 tähemärki, 1 SMS):

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

Hulgisaatmine

Saada mitu sõnumit ühe taotlusega:

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

Järgmised sammud

Viber Messages - Rikasmeedia sõnumside
RCS-sõnumid - rikkalikud sideteenused
Kontrolli olekut - Jälgige kohaletoimetamise olekut
Varustrateegiad - Varude seadistamine

Search Results