Mesaje SMS

Trimiteți mesaje text standard folosind API-ul SMSBAT. SMS-ul este cel mai universal canal de mesagerie cu cele mai mari rate de livrare pe toate dispozitivele mobile.

Prezentare generală

SMS (Short Message Service) este ideal pentru:

Notificări critice de timp
Rezervă pentru mesajele Viber/RCS
Ajungerea la utilizatori fără smartphone-uri
Compatibilitate universală în toate rețelele mobile
Rate mari de livrare (95%+)

Mesaj SMS de bază

Solicitare

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

Parametri

Parametru	Tip	Necesar	Descriere
`din`	șir	Da	ID alfanumeric al expeditorului (până la 11 caractere)
`la`	șir	Da	Numărul de telefon al destinatarului în format E.164
`tip`	șir	Da	Setați la `"sms"`
`text`	șir	Da	Conținutul mesajului
`customerMessageId`	șir	Nu	ID-ul dvs. de urmărire intern
`ttl`	întreg	Nu	Timp de viață în secunde

Exemple

SMS simplu

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 cu ID de client

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

SMS cu TTL

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

Codificarea caracterelor

Codificare GSM pe 7 biți

Alfabetul GSM standard (160 de caractere per SMS):

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

Caractere GSM extinse

Aceste caractere contează ca 2 caractere:

| ^ € { } [ ] ~ \

Codificare Unicode (UCS-2).

Mesajele cu caractere speciale folosesc codificarea Unicode (70 de caractere per SMS):

Emoji: 😀 🎉 ❤️
chirilic: А Б В Г Д Е Ж
Simboluri speciale: ✓ ✗ ★ ♥

Lungimea mesajului

Un singur SMS

GSM pe 7 biți: 160 de caractere
Unicode: 70 de caractere

SMS cu mai multe părți

Când mesajul dvs. depășește limita, acesta este împărțit în mai multe părți:

GSM pe 7 biți: 153 de caractere per parte
Unicode: 67 de caractere per parte

Exemplu

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

Acest mesaj (201 caractere) va fi împărțit în 2 părți.

Răspuns

Răspuns de succes

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

Câmpuri de răspuns

Câmp	Descriere
`messageId`	Identificator unic pentru urmărire
`starea`	Starea mesajului (`acceptat`, `respins`)
`piese`	Numărul de părți SMS
`la`	Numărul de telefon al destinatarului

ID expeditor

Expeditor alfanumeric

Utilizați numele mărcii dvs. ca expeditor (până la 11 caractere):

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

Restrictii:

Maxim 11 caractere
Numai litere și cifre
Fără spații sau caractere speciale
Destinatarul nu poate răspunde expeditorilor alfanumerici

Expeditor numeric

Utilizați un număr de telefon ca expeditor (pentru SMS-uri bidirecționale):

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

Cazuri de utilizare

Verificare OTP

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

Notificări de comandă

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

Mementouri pentru întâlniri

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

Confirmări de plată

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

Cele mai bune practici

Conținutul mesajului

✅ Păstrați mesajele concise și clare
✅ Includeți identificarea expeditorului
✅ Adăugați un îndemn dacă este necesar
✅ Folosiți gramatica și ortografia adecvate
❌ Evitați punctuația excesivă!!!
❌ Nu folosiți toate majusculele
❌ Evitați scurtatoarele URL care par suspecte

Utilizarea caracterelor

Verificați numărul de caractere înainte de a trimite
Fiți conștienți de caracterele GSM extinse (numărați ca 2)
Testați cu caractere speciale înainte de trimiterea în bloc
Luați în considerare utilizarea codării GSM pentru mesaje mai lungi

Numere de telefon

Folosiți întotdeauna formatul E.164: +380XXXXXXXXX
Validați numerele de telefon înainte de a trimite
Eliminați numerele nevalide din lista dvs
Păstrați lista de contacte actualizată

Timpul

Respectați fusurile orare locale
Evitați trimiterea pe timp de noapte (22:00 - 8:00)
Luați în considerare programul de lucru pentru mesajele comerciale
Setați TTL adecvat pentru mesajele sensibile la timp

Conformitate

Obțineți consimțământul înainte de a trimite mesaje de marketing
Includeți instrucțiuni de renunțare pentru SMS-urile promoționale
Respectați reglementările locale (GDPR, etc.)
Respectați listele „Nu deranjați”.

Gestionarea erorilor

Erori frecvente

Eroare	Cauza	Soluție
`INVALID_RECIPIENT`	Format de telefon greșit	Utilizați formatul E.164
`INVALID_SENDER`	ID-ul expeditorului nevalid	Verificați regulile de identificare a expeditorului
`MESAGE_TOO_LONG`	Depășește lungimea maximă	Împărțiți sau scurtați mesajul
`INVALID_ENCODING`	Caractere neacceptate	Utilizați GSM sau Unicode

Optimizarea costurilor

Reduceți părțile mesajului

Păstrați mesajele sub 160 de caractere (GSM) sau 70 (Unicode)
Evitați caracterele speciale care declanșează Unicode
Folosiți abrevieri atunci când este cazul
Eliminați spațiile inutile

Exemplu de optimizare

❌ Înainte (171 de caractere, 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.

✅ După (156 de caractere, 1 SMS):

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

Trimitere în vrac

Trimiteți mai multe mesaje într-o singură solicitare:

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

Următorii pași

Mesaje Viber - Mesaje media îmbogățite
RCS Messages - Servicii de comunicare bogate
Verificați starea - Urmăriți starea livrării
Fallback Strategies - Configurați alternative