SMS API интерфейс
SMS API для сайтов, CMS и CRM систем.
Какие возможности вы получаете?
С помощью одной интеграции вы можете обрабатывать подтверждение регистрации, транзакционные сообщения, OTP коды, отложенную отправку и статусы доставки через callback.
Сценарии использования
Чаще всего SMS API интеграция используется в следующих случаях:
- Подтверждение регистрации пользователя, привязанного к конкретному мобильному номеру, через SMS
- Уведомления о транзакциях по банковскому счёту
- Отправка обновлений статуса заказа, акций, уведомлений о новых товарах и любых видов SMS рекламы
Как начать
Войти
Пополнить баланс
Активировать API сервис
Отправить сообщение
Отправка сообщения
Обязательные параметры
| Параметр | Описание |
|---|---|
key |
Секретный API ключ для подключения к системе. Ключ можно просматривать и управлять им в настройках компании. |
brandID |
Уникальный ID бренда отправителя в системе. |
numbers |
Мобильные номера, разделённые запятыми. Номера должны быть в международном формате, без 00 и +. |
text |
Текст сообщения. Допускаются любые Unicode символы. |
Необязательные параметры
| Параметр | Описание |
|---|---|
stopList |
stopList=false - отключает проверку stop-list. Сообщение будет отправлено, даже если номер получателя находится в стоп-листе. |
otp |
otp=true - SMS предназначено для одноразовых кодов авторизации (OTP / verification code).Отправляется с наивысшим приоритетом. Используйте только в процессах аутентификации. Нельзя использовать для других типов сообщений. |
sendTime |
Время отложенной отправки сообщения. Формат: Y-m-d H:i (например: 2026-02-01 23:30) Указанное время должно быть позже текущего времени. Если этот параметр не передан, сообщение отправляется немедленно. |
Автоматическое получение статусов сообщений (Callback)
SMS API позволяет автоматически получать обновления статусов доставки отправленных сообщений на ваш сервер через механизм Callback.
Когда статус сообщения меняется (отправлено, доставлено, ошибка и т.д.), система отправляет GET запрос на указанный вами HTTPS endpoint.
Требования к Callback URL
- URL должен начинаться с https://
- Метод: GET
- Callback URL настраивается в настройках компании
Пример GET запроса
Возвращаемые параметры
| Параметр | Описание |
|---|---|
key |
Ключ валидации callback для вашего сервера. |
smsID |
Уникальный идентификатор сообщения. |
number |
Мобильный номер получателя в международном формате. |
statusID |
Текущий код статуса сообщения. |
date |
Дата и время обновления статуса (Y-m-d H:i:s). |
Значения статусов
| statusID | Описание |
|---|---|
0 |
Отправлено |
1 |
Доставлено |
2 |
Не доставлено |
3 |
В ожидании |
4 |
Ошибка |
Пример обработки Callback (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';
?>Callback считается успешным, если ваш сервер возвращает HTTP статус-код 200–299.
Готовы к интеграции?
Используйте SMS API, чтобы быстро отправлять сообщения из своей системы, управлять статусами доставки и автоматизировать коммуникацию с пользователями.
