TurboSMS API kompatibilnost

SMSBAT u potpunosti podržava sloj kompatibilnosti s TurboSMS API. To vam omogućuje da migrirate svoje postojeće integracije koje su dizajnirane za TurboSMS izravno na SMSBAT bez potrebe za prepisivanjem struktura poruka ili sadržaja krajnjih točaka.

Podržavamo slanje SMS i Viber poruka (uključujući napredne značajke kao što su vrtuljci i ankete), dohvaćanje statusa i dohvaćanje pojedinosti o poruci koristeći potpuno iste strukture tijela zahtjeva s kojima ste već upoznati.

Autentifikacija

Jedina razlika u odnosu na izvorni TurboSMS API je mehanizam provjere autentičnosti. Dok TurboSMS koristi prilagođeni token parametar upita ili specifično zaglavlje autentifikacije, SMSBAT zahtijeva standardni Bearer Token.

Morate uključiti svoj SMSBAT API token u zaglavlje Autorizacija za sve zahtjeve:

Authorization: Bearer YOUR_SMSBAT_TOKEN

Osnovni URL

Sve krajnje točke trebaju biti usmjerene na SMSBAT API osnovni URL:

https://restapi.smsbat.com

---

Pošalji jednu poruku

Krajnja točka: POST /api/tsms/message/send

Omogućuje slanje SMS i Viber poruka uz podršku za hibridnu isporuku (Viber s rezervnim SMS-om). Obrađuje jedan zahtjev za slanje i vraća rezultate isporuke za svakog primatelja.

Ključne mogućnosti

• Fleksibilni parametri: Globalni parametri mogu biti nadjačani određenim SMS/Viber parametrima.
• Sadržaj: Podržava Viber vrtuljke, ankete, privitke datoteka i interaktivne gumbe.
• Rješavanje pogrešaka: Vraća HTTP 200 čak i za pogreške (strukturirani odgovori na pogreške). response_code: 999 sa statusom FATAL_ERROR za sistemske pogreške.
• Pogreške primatelja: Specifične pogreške primatelja vraćaju se u polje response_result. Neuspjeli primatelji imaju message_id: null i specifične kodove grešaka.

Primjer zahtjeva (hibridna poruka)

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

Primjer zahtjeva (Viber vrtuljak)

{
  "sender": "GlobalSender",
  "text": "Check out our products",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Check out our products",
    "is_transactional": false,
    "carousel": [
      {
        "title": "Product 1",
        "image_url": "https://example.com/product1.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product1",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product1"
      },
      {
        "title": "Product 2",
        "image_url": "https://example.com/product2.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product2",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product2"
      }
    ]
  }
}

Primjer zahtjeva (Viber anketa)

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

---

Slanje više poruka (grupa)

Krajnja točka: POST /api/tsms/message/sendmulti

Ova metoda vam omogućuje slanje više zahtjeva za pošalji u jednom HTTP zahtjevu, štedeći troškove veze. Pozivanje sendmulti s podacima za 100 zahtjeva bit će brže od izvršavanja 100 pojedinačnih send zahtjeva.

Primjer zahtjeva

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

Primjer odgovora

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

---

Dobijte status poruke

Krajnja točka: POST /api/tsms/message/status

Dohvatite statuse isporuke poslanih poruka tako da navedete njihov message_id.

Primjer zahtjeva

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

---

Dobijte pojedinosti o poruci

Krajnja točka: POST /api/tsms/message/details

Omogućuje vam dohvaćanje detaljnih informacija o kreiranim porukama, uključujući potpune podatke o sadržaju za SMS i Viber kanale, cijene i točne vremenske oznake.

Primjer zahtjeva

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

Primjer odgovora

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