Skip to content

Messaġġi SMS

Ibgħat messaġġi standard bl-użu ta' SMSBAT API. L-SMS huwa l-aktar kanal ta' messaġġi universali bl-ogħla rati ta' konsenja fuq it-tagħmir mobbli kollu.

Ħarsa ġenerali

SMS (Short Message Service) huwa ideali għal:

  • Notifiki kritiċi fil-ħin
  • Fallback għall-messaġġi Viber/RCS
  • Jintlaħqu utenti mingħajr smartphones
  • Kompatibilità universali fin-netwerks mobbli kollha
  • Rati għolja ta' kunsinna (95%+)

Messaġġ SMS bażiku

Talba

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

Parametri

Parametru Tip Meħtieġa Deskrizzjoni
"minn" spag Iva ID alfanumeriku tal-mittent (sa 11-il karattru)
"għal" spag Iva Numru tat-telefon tar-riċevitur fil-format E.164
"tip" spag Iva Issettja għal "sms"
"test" spag Iva Kontenut tal-messaġġ
customerMessageId spag Le L-ID tat-traċċar intern tiegħek
ttl numru sħiħ Le Ħin għall-ħajja f'sekondi

Eżempji

SMS sempliċi

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 bl-ID tal-Klijent

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

SMS b'TTL

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

Kodifikazzjoni tal-Karattri

GSM 7-bit Kodifikazzjoni

Alfabett GSM standard (160 karattru għal kull SMS):

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

Karattri tal-GSM Estiżi

Dawn il-karattri jgħoddu bħala 2 karattri:

| ^ € { } [ ] ~ \

Unicode (UCS-2) Kodifikazzjoni

Messaġġi b'karattri speċjali jużaw kodifikazzjoni Unicode (70 karattru għal kull SMS):

  • Emoji: 😀 🎉 ❤️
  • Ċirilliku: А Б В Г Д Е Ж
  • Simboli speċjali: ✓ ✗ ★ ♥

Tul tal-Messaġġ

SMS Uniku

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

SMS b'ħafna partijiet

Meta l-messaġġ tiegħek jaqbeż il-limitu, huwa maqsum f'diversi partijiet:

  • GSM 7-bit: 153 karattru għal kull parti
  • Unicode: 67 karattru għal kull parti

Eżempju

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

Dan il-messaġġ (201 karattru) se jinqasam f'2 partijiet.

Rispons

Rispons ta’ Suċċess

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

Oqsma ta’ Rispons

Qasam Deskrizzjoni
MessageId Identifikatur uniku għat-traċċar
"status" L-istatus tal-messaġġ ('aċċettat', 'irrifjutat')
"partijiet" Numru ta' partijiet tal-SMS
"għal" Numru tat-telefon tar-riċevitur

ID tal-mittent

Alfanumeriku Mittenti

Uża l-isem tad-ditta tiegħek bħala mittenti (sa 11-il karattru):

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

Restrizzjonijiet:

  • Massimu 11-il karattru
  • Ittri u numri biss
  • Ebda spazji jew karattri speċjali
  • Ir-riċevitur ma jistax iwieġeb lill-mittenti alfanumeriki

Numeriku Mittenti

Uża numru tat-telefon bħala mittenti (għal SMS b'żewġ direzzjonijiet):

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

Każijiet ta' Użu

Verifika OTP

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

Notifiki tal-Ordni

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

Tfakkiriet tal-Ħatriet

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

Konferma tal-Ħlas

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

L-Aħjar Prattiċi

Kontenut tal-Messaġġ

  • ✅ Żomm messaġġi konċiżi u ċari
  • ✅ Inkludi l-identifikazzjoni tal-mittent
  • ✅ Żid sejħa għall-azzjoni jekk meħtieġ
  • ✅ Uża grammatika u ortografija xierqa
  • ❌ Evita punteġġjatura eċċessiva!!!
  • ❌ Tużax il- CAPS kollha
  • ❌ Evita li jqassar l-URL li jidhru suspettużi

Użu tal-Karattri

  • Iċċekkja l-għadd tal-karattri qabel ma tibgħat
  • Kun konxju tal-karattri GSM estiżi (jgħoddu bħala 2)
  • Ittestja b'karattri speċjali qabel ma jintbagħat bl-ingrossa
  • Ikkunsidra li tuża kodifikazzjoni GSM għal messaġġi itwal

Numri tat-Telefon

  • Dejjem uża l-format E.164: +380XXXXXXXXX
  • Ivvalida n-numri tat-telefon qabel ma tibgħat
  • Neħħi numri invalidi mil-lista tiegħek
  • Żomm il-lista ta' kuntatti tiegħek aġġornata

Iż-żmien

  • Irrispetta ż-żoni tal-ħin lokali
  • Evita li tibgħat bil-lejl (10:00 - 8:00)
  • Ikkunsidra l-ħinijiet tan-negozju għal messaġġi kummerċjali
  • Issettja TTL xierqa għal messaġġi sensittivi għall-ħin

Konformità

  • Ikseb il-kunsens qabel ma tibgħat messaġġi ta' kummerċjalizzazzjoni
  • Inkludi struzzjonijiet ta' opt-out għal SMS promozzjonali
  • Segwi r-regolamenti lokali (GDPR, eċċ.)
  • Irrispetta l-listi "Tfixkilx".

Immaniġġjar ta' Żbalji

Żbalji Komuni

Żball Kawża Soluzzjoni
INVALID_RECIPIENT Format tat-telefon ħażin Uża l-format E.164
INVALID_SENDER ID tal-mittent mhux validu Iċċekkja r-regoli tal-ID tal-mittent
MESSAGE_TOO_LONG Jeċċedi t-tul massimu Qassam jew iqassar il-messaġġ
INVALID_ENCODING Karattri mhux appoġġjati Uża GSM jew Unicode

Ottimizzazzjoni tal-Ispejjeż

Naqqas il-Partijiet tal-Messaġġ

  • Żomm messaġġi taħt 160 karattru (GSM) jew 70 (Unicode)
  • Evita karattri speċjali li jikkawżaw Unicode
  • Uża abbrevjazzjonijiet meta xieraq
  • Neħħi l-ispazji mhux meħtieġa

Eżempju Ottimizzazzjoni

❌ Qabel (171 karattru, 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.

✅ Wara (156 karattru, SMS 1): 

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

Mittenti bl-ingrossa

Ibgħat messaġġi multipli f'talba waħda:

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

Il-passi li jmiss