Перейти до змісту

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), оскільки оператори можуть заблокувати трафік.

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