Turbosms

Përputhshmëria # TurboSMS API

SMSBAT mbështet plotësisht një shtresë përputhshmërie me TurboSMS API. Kjo ju lejon të migroni integrimet tuaja ekzistuese që janë krijuar për TurboSMS direkt në SMSBAT pa pasur nevojë të rishkruani strukturat e mesazheve ose ngarkesat e pikës fundore.

Ne mbështesim dërgimin e mesazheve SMS dhe Viber (duke përfshirë veçori të avancuara si karuselet dhe sondazhet), marrjen e statuseve dhe marrjen e detajeve të mesazheve duke përdorur saktësisht të njëjtat struktura të trupit të kërkesës me të cilat jeni njohur tashmë.

Autentifikimi

I vetmi ndryshim nga API-ja vendase TurboSMS është mekanizmi i Autentifikimit. Ndërsa TurboSMS përdor një parametër të personalizuar të kërkesës “token” ose një kokë specifike të vërtetimit, SMSBAT kërkon një Token standard të bartës.

Duhet të përfshini kodin tuaj SMSBAT API në kokën e “Autorizimit” për të gjitha kërkesat:

Authorization: Bearer YOUR_SMSBAT_TOKEN

URL bazë

Të gjitha pikat fundore duhet të drejtohen në URL-në bazë të SMSBAT API:

KODI_BLOCK_1

---

Dërgo një mesazh të vetëm

Pika e fundit: POST /api/tsms/message/send

Lejon dërgimin e mesazheve SMS dhe Viber me mbështetje për dërgimin hibrid (Viber me kthim SMS). Ai përpunon një kërkesë të vetme dërgimi dhe kthen rezultatet e dorëzimit për çdo marrës.

Aftësitë kryesore

• Parametrat fleksibël: Parametrat globalë mund të anashkalohen nga parametra specifikë SMS/Viber.
• Përmbajtja: Mbështet karuselet Viber, sondazhet, bashkëngjitjet e skedarëve dhe butonat ndërveprues.
• Trajtimi i gabimeve: Kthen HTTP 200 edhe për gabime (përgjigjet e gabimeve të strukturuara). kodi_përgjigje: 999 me statusin “FATAL_ERROR” për gabimet e sistemit.
• Gabimet e marrësit: Gabimet specifike të marrësve kthehen në grupin response_result. Marrësit e dështuar kanë “id_mesazhi: null” dhe kode specifike gabimi.

Shembull i kërkesës ### (Mesazhi Hibrid)

{
  "sender": "GlobalSender",
  "text": "Test message",
  "recipients": ["380951111111", "380952222222"],
  "start_time": "2025-09-29T10:00:00Z",
  "sequence_id": "seq_12345",
  "sms": {
    "sender": "SMSSender",
    "text": "SMS version of message",
    "is_flash": false
  },
  "viber": {
    "sender": "ViberSender",
    "text": "Viber version of message",
    "ttl": 3600,
    "image_url": "https://example.com/image.png",
    "caption": "Button text",
    "action": "https://google.com",
    "count_clicks": true,
    "is_transactional": false
  }
}

Shembull i kërkesës ### (Viber Carousel)

KODI_BLOCK_3

Shembull i kërkesës ### (Anketa Viber)

{
  "sender": "GlobalSender",
  "text": "Please rate our service",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Please rate our service",
    "is_transactional": true,
    "survey": [
      "Excellent",
      "Good",
      "Average",
      "Poor"
    ]
  }
}

---

Dërgo mesazhe të shumta (Batch)

Pika e fundit: POST /api/tsms/message/sendmulti

Kjo metodë ju lejon të dërgoni kërkesa të shumta ‘dërgoni’ në një kërkesë të vetme HTTP, duke kursyer koston e lidhjes. Thirrja ‘sendmulti’ me të dhëna për 100 kërkesa do të jetë më e shpejtë se ekzekutimi i 100 kërkesave individuale ‘send’.

Shembull i kërkesës

{
  "batch_1": {
    "sender": "GlobalSender",
    "text": "Test message",
    "recipients": ["380982462128", "380501111111"],    
    "sms": {
        "sender": "SMSSender",
        "text": "SMS version of message"
    }
  },
  "batch_2": {
    "sender": "GlobalSender",
    "text": "Second message",
    "recipients": ["380501111111"],
    "viber": {
      "sender": "ViberSender",
      "text": "Viber message",
      "is_transactional": true
    }
  }
}

Shembull i përgjigjes

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": {
        "batch_1": {
            "response_code": 800,
            "response_status": "SUCCESS_MESSAGE_ACCEPTED",
            "response_result": [
                {
                    "phone": "380982462128",
                    "response_code": 0,
                    "message_id": "f1640579-ea75-4bc1-b708-1c3858bf222d",
                    "response_status": "OK"
                }
            ]
        },
        "batch_2": { ... }
    }
}

---

Merrni statusin e mesazhit

Pika e fundit: POST /api/tsms/message/status

Merr statuset e dorëzimit të mesazheve të dërguara duke ofruar ‘id_mesazhit’ të tyre.

Shembull i kërkesës

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "6b7f9ff5-28c8-4f38-913b-31af6021fbea"
  ]
}

---

Merrni detajet e mesazhit

Pika e fundit: POST /api/tsms/message/details

Ju lejon të merrni informacion të detajuar në lidhje me mesazhet e krijuara, duke përfshirë detajet e ngarkesës së plotë për kanalet SMS dhe Viber, çmimet dhe vulat e sakta kohore.

Shembull i kërkesës

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "f1640579-ea75-4bc1-b708-1c3858bf222d"
  ]
}

Shembull i përgjigjes

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": [
        {
            "message_id": "573dcb46-7851-4e16-bb1f-721c13ef5f38",
            "sms": null,
            "viber": {
                "added": "2025-09-29T14:17:02.577Z",
                "start": "2025-09-29T10:00:00Z",
                "sent": "2025-09-29T14:17:02.577Z",
                "updated": "2025-09-29T14:17:02.577Z",
                "sender": "ViberSender",
                "text": "Viber version of message",
                "recipient": "380982462128",
                "message_type": "promotional",
                "status": "Queued",
                "price": 0,
                "ttl": 3600,
                "caption": "Button text",
                "action": "https://google.com"
            },
            "response_code": 0,
            "response_status": "OK"
        }
    ]
}