Kalo te përmbajtja

Mesazhe SMS

Dërgoni mesazhe standarde me tekst duke përdorur SMSBAT API. SMS është kanali më universal i mesazheve me tarifat më të larta të dërgesave në të gjitha pajisjet celulare.

Përmbledhje

SMS (Shërbimi i mesazheve të shkurtra) është ideal për:

  • Njoftimet kritike për kohën
  • Rikthim për mesazhet Viber/RCS
  • Arritja e përdoruesve pa telefona inteligjentë
  • Përputhshmëri universale në të gjitha rrjetet celulare
  • Norma të larta dërgese (95%+)

Mesazh bazë SMS

Kërkesë

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

Parametrat

Parametri Lloji Kërkohet Përshkrimi
"nga" varg Po ID-ja e dërguesit alfanumerik (deri në 11 karaktere)
për varg Po Numri i telefonit të marrësit në formatin E.164
'lloj' varg Po Cakto në "sms"
tekst varg Po Përmbajtja e mesazhit
Id i mesazhit të klientit varg Jo ID-ja juaj e brendshme e gjurmimit
ttl numër i plotë Jo Koha për të jetuar në sekonda

Shembuj

SMS e thjeshtë

KODI_BLOCK_1

SMS me ID të klientit

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

SMS me TTL

KODI_BLOCK_3

Kodimi i karaktereve

Kodimi 7-bit GSM

Alfabeti standard GSM (160 karaktere për SMS):

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

Karaktere të zgjeruara GSM

Këto karaktere numërohen si 2 karaktere:

| ^ € { } [ ] ~ \

Kodimi i Unicode (UCS-2).

Mesazhet me karaktere speciale përdorin kodimin Unicode (70 karaktere për SMS):

  • Emoji: 😀 🎉 ❤️
  • cirilik: А Б В Г Д Е Ж
  • Simbolet speciale: ✓ ✗ ★ ♥

Gjatësia e mesazhit

SMS e vetme

  • GSM 7-bit : 160 karaktere
  • Unicode: 70 karaktere

SMS me shumë pjesë

Kur mesazhi juaj tejkalon kufirin, ai ndahet në disa pjesë:

  • GSM 7-bit : 153 karaktere për pjesë
  • Unicode: 67 karaktere për pjesë

Shembull

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

Ky mesazh (201 karaktere) do të ndahet në 2 pjesë.

Përgjigje

Përgjigja e suksesit

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

Fushat e përgjigjes

Fusha Përshkrimi
Id mesazhi Identifikues unik për gjurmimin
"statusi" Statusi i mesazhit ('pranuar', 'refuzuar')
pjesë Numri i pjesëve të SMS
për Numri i telefonit të marrësit

ID e dërguesit

Dërgues alfanumerik

Përdorni emrin e markës tuaj si dërgues (deri në 11 karaktere):

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

Kufizimet:

  • Maksimumi 11 karaktere
  • Vetëm shkronja dhe numra
  • Nuk ka hapësira ose karaktere të veçanta
  • Marrësi nuk mund t'u përgjigjet dërguesve alfanumerik

Dërgues numerik

Përdorni një numër telefoni si dërgues (për SMS me dy drejtime):

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

Rastet e përdorimit

Verifikimi OTP

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

Njoftimet e porosive

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

Kujtesa për takime

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

Konfirmimet e pagesës

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

Praktikat më të mira

Përmbajtja e mesazhit

  • ✅ Mbani mesazhet koncize dhe të qarta
  • ✅ Përfshi identifikimin e dërguesit
  • ✅ Shto thirrje për veprim nëse është e nevojshme
  • ✅ Përdorni gramatikën dhe drejtshkrimin e duhur
  • ❌ Shmangni shenjat e tepruara të pikësimit!!!
  • ❌ Mos përdorni të gjitha CAPS
  • ❌ Shmangni shkurtuesit e URL-ve që duken të dyshimtë

Përdorimi i karakterit

  • Kontrolloni numrin e karaktereve përpara se të dërgoni
  • Jini të vetëdijshëm për karakteret e zgjeruara GSM (numëroni si 2)
  • Provoni me karaktere speciale përpara dërgimit me shumicë
  • Konsideroni përdorimin e kodimit GSM për mesazhe më të gjata

Numrat e telefonit

  • Përdor gjithmonë formatin E.164: +380XXXXXXXXX
  • Verifikoni numrat e telefonit përpara se të dërgoni
  • Hiqni numrat e pavlefshëm nga lista juaj
  • Mbani të përditësuar listën tuaj të kontakteve

Koha

  • Respektoni zonat kohore lokale
  • Shmangni dërgimin gjatë natës (10 PM - 8 AM)
  • Merrni parasysh orët e punës për mesazhet komerciale
  • Vendosni TTL të përshtatshme për mesazhet e ndjeshme ndaj kohës

Pajtueshmëria

  • Merrni pëlqimin përpara se të dërgoni mesazhe marketingu
  • Përfshi udhëzime për të hequr dorë nga SMS promocionale
  • Ndiqni rregulloret lokale (GDPR, etj.)
  • Respektoni listat "Mos shqetëso".

Trajtimi i gabimeve

Gabime të zakonshme

Gabim Shkaku Zgjidhje
RECIPIENT_INVALID Formati i gabuar i telefonit Përdorni formatin E.164
INVALID_DËRGUES ID e pavlefshme e dërguesit Kontrolloni rregullat e ID-së së dërguesit
MESAGE_TOO_LONG Tejkalon gjatësinë maksimale Ndani ose shkurtoni mesazhin
INVALID_ENCODING Karaktere të pambështetura Përdorni GSM ose Unicode

Optimizimi i kostos

Redukto pjesët e mesazheve

  • Mbani mesazhet nën 160 karaktere (GSM) ose 70 (Unicode)
  • Shmangni karakteret speciale që aktivizojnë Unicode
  • Përdorni shkurtesat kur është e përshtatshme
  • Hiqni hapësirat e panevojshme

Shembull i optimizimit

❌ Përpara (171 karaktere, 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.

✅ Pas (156 karaktere, 1 SMS): 

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

Dërgim me shumicë

Dërgoni mesazhe të shumta në një kërkesë:

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

Hapat e ardhshëm