Help Center ТурбоСМС АПИ компатибилност

ТурбоСМС АПИ компатибилност

СМСБАТ у потпуности подржава слој компатибилности са ТурбоСМС АПИ. Ово вам омогућава да мигрирате своје постојеће интеграције које су дизајниране за ТурбоСМС директно у СМСБАТ без потребе да поново пишете структуре порука или корисног оптерећења крајње тачке.

Подржавамо слање СМС и Вибер порука (укључујући напредне функције као што су вртешке и анкете), преузимање статуса и детаља о порукама користећи потпуно исте структуре тела захтева са којима сте већ упознати.

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

Једина разлика у односу на изворни ТурбоСМС АПИ је механизам аутентификације. Док ТурбоСМС користи прилагођени параметар упита „токен“ или специфично заглавље аутентификације, СМСБАТ захтева стандардни Токен носиоца.

Морате да укључите свој СМСБАТ АПИ токен у заглавље Аутхоризатион за све захтеве:

Authorization: Bearer YOUR_SMSBAT_TOKEN

Основни УРЛ

Све крајње тачке треба да буду усмерене на основну УРЛ адресу СМСБАТ АПИ-ја:

https://restapi.smsbat.com

Пошаљи једну поруку

Крајња тачка: ПОСТ /апи/тсмс/мессаге/сенд

Омогућава слање СМС и Вибер порука са подршком за хибридну испоруку (Вибер са резервним СМС-ом). Обрађује један захтев за слање и враћа резултате испоруке за сваког примаоца.

Кључне могућности

  • Флексибилни параметри: Глобални параметри се могу заменити одређеним СМС/Вибер параметрима.
  • Садржај: Подржава Вибер вртешке, анкете, прилоге датотека и интерактивна дугмад.
  • Управљање грешкама: Враћа ХТТП 200 чак и за грешке (структурирани одговори на грешке). респонсе_цоде: 999 са статусом ФАТАЛ_ЕРРОР за системске грешке.
  • Грешке примаоца: Одређене грешке примаоца се враћају у низу респонсе_ресулт. Неуспели примаоци имају мессаге_ид: нулл и специфичне кодове грешака.

Пример захтева (Хибридна порука)

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

Пример захтева (Вибер карусел)

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

Пример захтева (Вибер анкета)

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

Пошаљи више порука (група)

Крајња тачка: ПОСТ /апи/тсмс/мессаге/сендмулти

Овај метод вам омогућава да пошаљете више захтева за пошаљи у једном ХТТП захтеву, штедећи трошкове везе. Позивање сендмулти са подацима за 100 захтева биће брже од извршавања 100 појединачних сенд захтева.

Пример захтева

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

Пример одговора

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

Добијте статус поруке

Крајња тачка: ПОСТ /апи/тсмс/мессаге/статус

Преузмите статусе испоруке послатих порука тако што ћете навести њихов мессаге_ид.

Пример захтева

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

Добијте детаље о поруци

Крајња тачка: ПОСТ /апи/тсмс/мессаге/детаилс

Омогућава вам да преузмете детаљне информације о креираним порукама, укључујући пуне податке о корисном учитавању за СМС и Вибер канале, цене и тачне временске ознаке.

Пример захтева

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

Пример одговора

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