Kalo te përmbajtja

Dërgo mesazh

Dërgoni mesazhe përmes SMSBAT API duke përdorur pikën përfundimtare /bat/messagelist.

Pika përfundimtare

POST /bat/messagelist

Struktura e kërkesës

Trupi i kërkesës është një grup JSON i objekteve të mesazhit:

KODI_BLOCK_1

Parametrat

Parametrat e kërkuar

Parametri Lloji Përshkrimi
"nga" varg ID-ja e dërguesit alfanumerik
për varg Numri i telefonit të marrësit në formatin E.164 (p.sh., +380XXXXXXXXX)
'lloj' varg Lloji i mesazhit: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
tekst varg Përmbajtja e mesazhit (kërkohet për shumicën e llojeve, opsionale për disa)

Parametrat opsionalë

Parametri Lloji Përshkrimi
Id i mesazhit të klientit varg Identifikuesi juaj i brendshëm për gjurmim
ttl numër i plotë Koha për të jetuar në sekonda
Të dhënat e mesazhit objekt Konfigurimi specifik i tipit (ndryshon sipas llojit të mesazhit)

Autentifikimi

Zgjidhni një nga tre metodat e vërtetimit:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

KODI_BLOCK_3

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

Përgjigje

Përgjigja e suksesit

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 1,
      "customerMessageId": "your-internal-id",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Fushat e përgjigjes

Fusha Lloji Përshkrimi
messagelistId numër i plotë Identifikues unik për listën e mesazheve
Id mesazhi varg Identifikues unik për çdo mesazh
"statusi" varg Statusi i mesazhit: "pranuar", "refuzuar", "dështuar"
pjesë numër i plotë Numri i pjesëve të mesazhit (për SMS)
Id i mesazhit të klientit varg Identifikuesi juaj i brendshëm (nëse ofrohet)
për varg Numri i telefonit të marrësit

Llojet e mesazheve

SMS

Mesazhe të thjeshta me tekst:

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

Promo Viber

Mesazhe promovuese me media të pasura:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Check out our new product!",
  "messageData": {
    "image": "https://example.com/image.jpg",
    "button": {
      "text": "View Product",
      "url": "https://example.com/product"
    }
  }
}

Viber Transactional

Njoftimet e transaksionit:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed"
}

Viber OTP

Njoftimet një herë për fjalëkalimin:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "code": "123456",
    "validity": 300
  }
}

Trajtimi i gabimeve

Kodet e statusit HTTP

Kodi Përshkrimi
200 Kërkesa me sukses
400 Kërkesë e keqe - parametra të pavlefshëm
401 I paautorizuar - vërtetimi dështoi
429 Shumë kërkesa - kufiri i tarifës është tejkaluar
500 Gabim i brendshëm i serverit

Përgjigja e gabimit

{
  "error": {
    "code": "INVALID_RECIPIENT",
    "message": "Invalid phone number format"
  }
}

Praktikat më të mira

Formati i numrit të telefonit

Përdorni gjithmonë formatin E.164 për numrat e telefonit:

  • ✅ E saktë: +380XXXXXXXXX
  • ❌ E pasaktë: 380XXXXXXXXX, 0XXXXXXXXX

Teksti i mesazhit

  • Mbani SMS nën 160 karaktere për të shmangur disa pjesë
  • Përdorni kodimin UTF-8 për karakteret ndërkombëtare
  • Testoni karaktere speciale përpara dërgimit me shumicë

TTL (Koha për të jetuar)

  • Vendosni TTL të përshtatshme për mesazhet e ndjeshme ndaj kohës
  • Mesazhe OTP: 300-600 sekonda (5-10 minuta)
  • Mesazhe promocionale: 3600-86400 sekonda (1-24 orë)

ID e mesazhit të klientit

  • Përdorni identifikues unikë për çdo mesazh
  • Ndihmon me gjurmimin dhe korrigjimin e gabimeve
  • E dobishme për lidhjen me të dhënat e sistemit tuaj

Kufijtë e tarifave

Kontaktoni menaxherin e llogarisë tuaj për informacione rreth:

  • Mesazhe për sekondë
  • Mesazhe në ditë
  • Lidhjet e njëkohshme

Hapat e ardhshëm