SMS API, SMS-застосунок, SMS-сервіс, надсилання SMS

Інтерфейс SMS API

SMS API для сайтів, CMS і CRM.

Документація API Розпочати

REST API

Які можливості ви отримуєте?

Одна інтеграція забезпечує підтвердження реєстрації, транзакційні повідомлення, OTP, відкладене надсилання та отримання статусів через зворотні виклики.

Інтеграція Сайт / CMS / CRM

Метод REST API

Надсилання OTP / Масове / Відкладене

Статуси Зворотний виклик

Інтеграція SMS API, SMS API, розробники SMS

Сценарії використання

Найчастіше інтеграцію SMS API використовують у таких випадках:

Підтвердження реєстрації користувача, прив’язаної до мобільного номера, через SMS
Сповіщення про операції на банківському рахунку
Надсилання статусів замовлень, акцій, новинок і будь-якої SMS-реклами

Як розпочати

Увійти

Поповнити баланс

Активувати API

Надіслати повідомлення

https://api.ubill.dev/v1/sms/send?key=0123456789&brandID=1&numbers=995511194242,995511194242&text=message

Обов’язкові параметри

Параметр	Опис
`key`	Секретний ключ API для підключення до системи. Переглянути й налаштувати його можна в параметрах компанії.
`brandID`	Унікальний ідентифікатор бренду відправника в системі.
`numbers`	Мобільні номери через кому. Номери мають бути в міжнародному форматі без 00 та +.
`text`	Текст повідомлення. Дозволено будь-які символи Unicode.

Необов’язкові параметри

Параметр	Опис
`stopList`	`stopList=false` — вимикає перевірку стоп-списку. Повідомлення надсилатиметься, навіть якщо номер одержувача є в ньому.
`otp`	`otp=true` — SMS для одноразових кодів авторизації (OTP / код перевірки). Надсилається з найвищим пріоритетом. Використовуйте лише під час автентифікації. Застосовувати для інших повідомлень заборонено.
`sendTime`	Запланований час надсилання повідомлення. Формат: Y-m-d H:i (наприклад: 2026-02-01 23:30) Зазначений час має бути пізнішим за поточний. Якщо параметр не вказано, повідомлення надсилається негайно.
`callbackUrl`	Окрема URL-адреса зворотного виклику для цього SMS-запиту. Працює лише за наявності глобальної типової URL-адреси в налаштуваннях API-застосунку.

Автоматичне отримання статусів повідомлень (зворотний виклик)

SMS API дає змогу автоматично отримувати на сервері статуси доставки надісланих повідомлень за допомогою Зворотний виклик механізму.

Коли статус повідомлення змінюється (надіслано, доставлено, помилка тощо), система надсилає GET запит до вказаного вами HTTPS кінцевої точки.

Вимоги до URL-адреси зворотного виклику

URL-адреса має починатися з https://
Метод: GET
URL-адреса зворотного виклику задається в налаштуваннях компанії

Приклад GET-запиту

https://example.com/callback?key=YourCallbackKey&smsID=12345678&number=995511194242&statusID=1&date=2026-02-01 12:02:02

Параметри відповіді

Параметр	Опис
`key`	Ключ перевірки зворотного виклику на вашому сервері.
`smsID`	Унікальний ідентифікатор повідомлення.
`number`	Мобільний номер одержувача в міжнародному форматі.
`statusID`	Код поточного статусу повідомлення.
`date`	Час оновлення статусу ( Y-m-d H:i:s).

Значення статусів

statusID	Опис
`0`	Надіслано
`1`	Доставлено
`2`	Не доставлено
`3`	Очікується
`4`	Помилка

Приклад обробки зворотного виклику (PHP)

<?php
$key      = $_GET['key'] ?? null;
$smsID    = $_GET['smsID'] ?? null;
$number   = $_GET['number'] ?? null;
$statusID = $_GET['statusID'] ?? null;
$date     = $_GET['date'] ?? null;

// Validation: make sure key matches your callback key
if ($key !== 'YourCallbackKey') {
    http_response_code(403);
    echo 'Forbidden';
    exit;
}

// Process the received status in your system here

http_response_code(200);
echo 'OK';
?>

Зворотний виклик вважається успішним, якщо сервер повертає HTTP-код 200–299.