Keri sisuni

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