Help Center Mesaje SMS

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

ParametruTipNecesarDescriere
dinșirDaID alfanumeric al expeditorului (până la 11 caractere)
lașirDaNumărul de telefon al destinatarului în format E.164
tipșirDaSetați la "sms"
textșirDaConținutul mesajului
customerMessageIdșirNuID-ul dvs. de urmărire intern
ttlîntregNuTimp 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âmpDescriere
messageIdIdentificator unic pentru urmărire
stareaStarea mesajului (acceptat, respins)
pieseNumărul de părți SMS
laNumă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

EroareCauzaSoluție
INVALID_RECIPIENTFormat de telefon greșitUtilizați formatul E.164
INVALID_SENDERID-ul expeditorului nevalidVerificați regulile de identificare a expeditorului
MESAGE_TOO_LONGDepășește lungimea maximăÎmpărțiți sau scurtați mesajul
INVALID_ENCODINGCaractere neacceptateUtilizaț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