Help Center СМС поруке

СМС поруке

Шаљите стандардне текстуалне поруке користећи СМСБАТ АПИ. СМС је најуниверзалнији канал за размену порука са највишим стопама испоруке на свим мобилним уређајима.

Преглед

СМС (Схорт Мессаге Сервице) је идеалан за:

Временски критична обавештења
Замена за Вибер/РЦС поруке
Допирање до корисника без паметних телефона
Универзална компатибилност на свим мобилним мрежама
Високе стопе испоруке (95%+)

Основна СМС порука

Захтев

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

Параметерс

Параметар	Тип	Обавезно	Опис
`од`	стринг	Да	Алфанумерички ИД пошиљаоца (до 11 знакова)
`то`	стринг	Да	Број телефона примаоца у формату Е.164
`тип`	стринг	Да	Подесите на `"смс"`
`текст`	стринг	Да	Садржај поруке
`цустомерМессагеИд`	стринг	Не	Ваш интерни ИД за праћење
`ттл`	цео број	Не	Време за живот у секундама

Примери

Једноставан СМС

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

СМС са ИД-ом корисника

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

СМС са ТТЛ

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Кодирање знакова

ГСМ 7-битно кодирање

Стандардна ГСМ абецеда (160 знакова по СМС):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Проширени ГСМ знакови

Ови знакови се рачунају као 2 знака:

| ^ € { } [ ] ~ \

Уницоде (УЦС-2) кодирање

Поруке са специјалним знаковима користе Уницоде кодирање (70 знакова по СМС-у):

Емоџи: 😀 🎉 ❤
Ћирилица: А Б В Г Д Е Ж
Специјални симболи: ✓ ✗ ★ ♥

Дужина поруке

Један СМС

ГСМ 7-бит: 160 знакова
Уницоде: 70 знакова

Вишеделни СМС

Када ваша порука премаши ограничење, она се дели на више делова:

ГСМ 7-бит: 153 знака по делу
Уницоде: 67 знакова по делу

Пример

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Ова порука (201 карактер) ће бити подељена на 2 дела.

Одговор

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

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

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

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

ИД пошиљаоца

Алфанумерички пошиљалац

Користите име свог бренда као пошиљаоца (до 11 знакова):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Ограничења:

Највише 11 знакова
Само слова и бројеви
Без размака или посебних знакова
Прималац не може да одговори алфанумеричким пошиљаоцима

Нумерички пошиљалац

Користите број телефона као пошиљаоца (за двосмерни СМС):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Случајеви употребе

ОТП верификација

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Обавештења о поруџбини

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Подсетници за састанке

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Потврде плаћања

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

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

Садржај поруке

✅ Нека поруке буду сажете и јасне
✅ Укључује идентификацију пошиљаоца
✅ Додајте позив на акцију ако је потребно
✅ Користите правилну граматику и правопис
❌ Избегавајте претерану интерпункцију!!!
❌ Не користите сва ВЕЛИКА ПИТАЊА
❌ Избегавајте скраћиваче УРЛ-ова који изгледају сумњиво

Употреба знакова

Проверите број знакова пре слања
Имајте на уму проширене ГСМ знакове (бројите као 2)
Тестирајте са посебним знаковима пре масовног слања
Размислите о коришћењу ГСМ кодирања за дуже поруке

Бројеви телефона

Увек користите формат Е.164: +380КСКСКСКСКСКСКСКСКС
Потврдите бројеве телефона пре слања
Уклоните неважеће бројеве са своје листе
Одржавајте своју листу контаката ажурираном

Тајминг

Поштујте локалне временске зоне
Избегавајте слање ноћу (22
- 8
)
Узмите у обзир радно време за комерцијалне поруке
Подесите одговарајући ТТЛ за поруке осетљиве на време

Усклађеност

Прибавите сагласност пре слања маркетиншких порука – Укључује упутства за одустајање за промотивни СМС
Придржавајте се локалних прописа (ГДПР, итд.)
Поштујте листе „Не узнемиравај“.

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

Уобичајене грешке

Грешка	Узрок	Решење
`ИНВАЛИД_РЕЦИПИЕНТ`	Погрешан формат телефона	Користите формат Е.164
`ИНВАЛИД_СЕНДЕР`	Неважећи ИД пошиљаоца	Проверите правила за ИД пошиљаоца
`МЕССАГЕ_ТОО_ЛОНГ`	Прекорачује максималну дужину	Подели или скрати поруку
`ИНВАЛИД_ЕНЦОДИНГ`	Неподржани знакови	Користите ГСМ или Уницоде

Оптимизација трошкова

Смањите делове поруке

Чувајте поруке испод 160 знакова (ГСМ) или 70 (Уницоде)
Избегавајте посебне знакове који активирају Уницоде
Користите скраћенице када је прикладно
Уклоните непотребне просторе

Пример оптимизације

❌ Пре (171 карактер, 2 СМС):

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ После (156 карактера, 1 СМС):

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Масовно слање

Пошаљите више порука у једном захтеву:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

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

Вибер поруке - Размена богатих медијских порука
РЦС поруке - Богате комуникационе услуге
Провери статус - Пратите статус испоруке
Резервне стратегије - Конфигуришите резервне

Search Results