Help Center Пошаљи поруку

Пошаљи поруку

Шаљите поруке преко СМСБАТ АПИ-ја користећи крајњу тачку /бат/мессагелист.

Крајња тачка

POST /bat/messagelist

Структура захтева

Тело захтева је ЈСОН низ објеката поруке:

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

Параметерс

Обавезни параметри

Параметар	Тип	Опис
`од`	стринг	Алфанумерички ИД пошиљаоца
`то`	стринг	Број телефона примаоца у формату Е.164 (нпр. +380КСКСКСКСКСКСКСКСКС)
`тип`	стринг	Тип поруке: `смс`, `вибер_промо`, `вибер_транс`, `вибер_цароусел`, `вибер_сурвеи`, `вибер_отп`, `рцс`, `фласхцалл`
`текст`	стринг	Садржај поруке (обавезно за већину типова, опционо за неке)

Опциони параметри

Параметар	Тип	Опис
`цустомерМессагеИд`	стринг	Ваш интерни идентификатор за праћење
`ттл`	цео број	Време за живот у секундама
`мессагеДата`	објекат	Конфигурација специфична за тип (зависи од типа поруке)

Аутентификација

Изаберите један од три метода аутентификације:

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

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

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

Одговор

Успешан одговор

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

Поља одговора

Поље	Тип	Опис
`мессагелистИд`	цео број	Јединствени идентификатор за листу порука
`мессагеИд`	стринг	Јединствени идентификатор за сваку поруку
`статус`	стринг	Статус поруке: `прихваћено`, `одбијено`, `неуспело`
`делови`	цео број	Број делова поруке (за СМС)
`цустомерМессагеИд`	стринг	Ваш интерни идентификатор (ако је наведен)
`то`	стринг	Број телефона примаоца

Типови порука

СМС

Једноставне текстуалне поруке:

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

Вибер Промо

Промотивне поруке са богатим медијима:

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

Вибер Трансацтионал

Обавештења о трансакцијама:

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

Вибер ОТП

Једнократна обавештења о лозинки:

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

Обрада грешака

ХТТП статусни кодови

Код	Опис
200	Захтев успешан
400	Лош захтев - неважећи параметри
401	Неовлашћено - аутентификација није успела
429	Превише захтева - ограничење брзине је премашено
500	Интерна грешка сервера

Одговор на грешку

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

Најбоље праксе

Формат телефонског броја

Увек користите формат Е.164 за бројеве телефона:

✅ Тачно: +380КСКСКСКСКСКСКСКСКС
❌ Нетачно: 380КСКСКСКСКСКСКСКСКС, 0КСКСКСКСКСКСКСКСКС

Текст поруке

Задржите СМС испод 160 карактера да бисте избегли више делова
Користите УТФ-8 кодирање за међународне знакове
Тестирајте специјалне знакове пре масовног слања

ТТЛ (време за живот)

Подесите одговарајући ТТЛ за поруке осетљиве на време
ОТП поруке: 300-600 секунди (5-10 минута)
Промотивне поруке: 3600-86400 секунди (1-24 сата)

ИД поруке клијента

Користите јединствене идентификаторе за сваку поруку
Помаже у праћењу и отклањању грешака
Корисно за повезивање са записима вашег система

Ограничења стопе

Контактирајте свог менаџера налога за информације о:

Поруке у секунди
Поруке по дану
Истовремене везе

Следећи кораци

Вибер поруке - Истражите типове Вибер порука
СМС поруке - Сазнајте више о СМС-у
Провери статус - Пратите испоруку поруке

Search Results