Help Center Pošalji poruku

Pošalji poruku

Šaljite poruke preko SMSBAT API-ja koristeći krajnju tačku /bat/messagelist.

Krajnja tačka

POST /bat/messagelist

Struktura zahtjeva

Tijelo zahtjeva je JSON niz objekata poruke:

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Your message text",
      "customerMessageId": "your-internal-id",
      "ttl": 3600
    }
  ]
}

Parametri

Obavezni parametri

Parametar	Vrsta	Opis
`od`	string	Alfanumerički ID pošiljaoca
`to`	string	Telefonski broj primaoca u formatu E.164 (npr. +380XXXXXXXXX)
`tip`	string	Tip poruke: `sms`, `viber_promo`, `viber_trans`, `viber_carousel`, `viber_survey`, `viber_otp`, `rcs`, `flashcall`
`tekst`	string	Sadržaj poruke (obavezno za većinu tipova, opciono za neke)

Opcioni parametri

Parametar	Vrsta	Opis
`customerMessageId`	string	Vaš interni identifikator za praćenje
`ttl`	cijeli broj	Vrijeme života u sekundama
`messageData`	objekt	Konfiguracija specifična za tip (zavisi od tipa poruke)

Autentifikacija

Odaberite jedan od tri načina provjere autentičnosti:

=== “Zaglavlje API ključa”

```bash
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!"
    }]
  }'
```

=== “HTTP Basic Auth”

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

=== “API ključ kao lozinka”

```bash
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!"
    }]
  }'
```

Odgovor

Uspješan odgovor

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

Polja odgovora

Polje	Vrsta	Opis
`messagelistId`	cijeli broj	Jedinstveni identifikator za listu poruka
`messageId`	string	Jedinstveni identifikator za svaku poruku
`status`	string	Status poruke: `prihvaćeno`, `odbijeno`, `neuspješno`
`dijelovi`	cijeli broj	Broj dijelova poruke (za SMS)
`customerMessageId`	string	Vaš interni identifikator (ako je naveden)
`to`	string	Broj telefona primaoca

Vrste poruka

SMS

Jednostavne tekstualne poruke:

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

Promotivne poruke sa bogatim medijima:

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

Obavještenja o transakcijama:

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

Viber OTP

Jednokratna obavještenja o lozinki:

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

Rukovanje greškama

HTTP statusni kodovi

Šifra	Opis
200	Zahtjev uspješan
400	Loš zahtjev - nevažeći parametri
401	Neovlašteno - autentifikacija nije uspjela
429	Previše zahtjeva - ograničenje brzine je premašeno
500	Interna greška servera

Odgovor na grešku

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

Najbolje prakse

Format telefonskog broja

Uvijek koristite format E.164 za telefonske brojeve:

✅ Tačno: +380XXXXXXXXX
❌ Netačno: 380XXXXXXXXX, 0XXXXXXXXX

Tekst poruke

Zadržite SMS ispod 160 karaktera kako biste izbjegli više dijelova
Koristite UTF-8 kodiranje za međunarodne znakove
Testirajte posebne znakove prije masovnog slanja

TTL (vrijeme za život)

Postavite odgovarajući TTL za vremenski osjetljive poruke
OTP poruke: 300-600 sekundi (5-10 minuta)
Promotivne poruke: 3600-86400 sekundi (1-24 sata)

ID poruke korisnika

Koristite jedinstvene identifikatore za svaku poruku
Pomaže u praćenju i otklanjanju grešaka
Korisno za povezivanje sa zapisima vašeg sistema

Ograničenja stope

Kontaktirajte svog upravitelja računa za informacije o:

Poruke u sekundi
Poruke po danu
Istovremene veze

Sljedeći koraci

Viber poruke - Istražite tipove Viber poruka
SMS poruke - Saznajte više o SMS-u
Provjeri status - Pratite isporuku poruke

Search Results