Help Center SMS Повідомлення

SMS Повідомлення

Надсилайте звичайні текстові повідомлення за допомогою SMSBAT API. SMS — це найуніверсальніший канал зв’язку з найвищим показником доставки (Delivery Rate) на всі мобільні пристрої.

Огляд

Служба коротких повідомлень (SMS) ідеально підходить для:

Термінових сповіщень.
Як резервний маршрут доставки (Fallback) для Viber чи RCS.
Зв’язку з клієнтами без смартфонів (чи без інтернету).
Універсальної сумісності через усі мобільні мережі.
Високого рівня доставки (95%+).

Базове SMS Повідомлення

Запит (Request)

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Текст вашого SMS повідомлення"
}

Параметри

Параметр	Тип	Обов’язково	Опис
`from`	string	Так	Альфа-ім’я відправника (Альфанумерик, до 11 символів)
`to`	string	Так	Телефон отримувача у форматі E.164
`type`	string	Так	Завжди передавайте значення `"sms"`
`text`	string	Так	Зміст повідомлення
`customerMessageId`	string	Ні	Ваш внутрішній ідентифікатор трекінгу
`ttl`	integer	Ні	Час життя (Time-to-Live) у секундах

Приклади

Звичайне SMS

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: ваш-api-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Привіт! Це тестове SMS повідомлення."
    }]
  }'

SMS з вашим Customer ID

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Замовлення #12345 відправлено.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS з часом життя (TTL)

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Ваш код підтвердження: 123456",
    "ttl": 300
  }]
}

Кодування (Encoding) та Обмеження

GSM 7-bit Кодування

Стандартний алфавіт GSM (дозволяє створювати SMS на 160 символів):

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

Примітка: Деякі розширені символи, такі як | ^ € { } [ ] ~ \ зараховуються за два.

UTF-16 (Unicode) Кодування

Обов’язкове кодування для локалізованих текстів і спецсимволів (обмеження 70 символів):

Емодзі: 😀 🎉 ❤️
Кирилиця (Українська, та інші мови): А Б В Г Д Е Ж Ї Є І Ґ
Спеціальні символи: ✓ ✗ ★ ♥

Довжина повідомлення та Склеювання (Multi-part)

Коли довжина вашого тексту перевищує ліміт однієї SMS, вона ділиться на сегменти (parts). Оператор об’єднує (склеює) їх, щоб абонент прочитав повідомлення як одне ціле, однак тарифікація відбувається за кількома сегментами.

GSM 7-bit: 153 символи на кожну частину (після 160).
Unicode: 67 символів на кожну частину (після 70).

Приклад

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Це повідомлення достатньо довге, щоб бути розділеним на декілька сегментів. Ваш додаток на телефоні абонента автоматично зклеїть його до купи. Коротше кажучи, ви не побачите швів, але ми затафікуємо це як кілька СМС."
  }]
}

Цей текст українською (213 символів) буде розбитий на 4 частини (бо 213 / 67 ≈ 3.2 → 4 сегменти).

Відповідь від API

Успішна Відповідь

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

Поля Відповіді

Поле	Опис
`messageId`	Внутрішній ідентифікатор для перевірки статусу
`status`	Статус (`accepted` або `rejected`)
`parts`	Зі скількох SMS частин складалася розсилка
`to`	Телефон отримувача

Альфа-імена (Sender IDs)

Система вимагає використовувати зареєстровані та схвалені оператором Альфа-імена (до 11 символів, лише літери та цифри, без спецсимволів). Абонент не може дати відповідь на таке повідомлення.

Випадки використання

Авторизація за OTP кодом

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Код авторизації: 123456. Діє 5 хвилин.",
  "ttl": 300
}

Сповіщення про статус замовлення

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Замовлення #12345 прибуло у відділення доставки. Дякуємо за покупку!"
}

Найкращі Практики

✅ Оптимізуйте текст, робіть його лаконічним.
✅ Уникайте зайвих пробілів чи переносів рядків.
✅ Завжди додайте відписку (інструкцію opt-out) для маркетингових розсилок.
❌ Уникайте підозрілих скорочень URL (типу bit.ly), оскільки оператори можуть заблокувати трафік.

Наступні Кроки

Повідомлення Viber - Дізнатися про повідомлення з багатими мультимедіа та кнопками.
Отримання статусів доставки - Як відстежувати доставку вашої розсилки.

Search Results