profile

Получить SMS через webhook

Onlinesim отправит запрос на ваш URL

↓ POSThttps:///newSms

Укажите URL в настройках профиля (или через webhook_url в profile.php), и каждое SMS, полученное Вашими номерами, будет отправлено на него JSON-запросом POST.

Работает как для приёма SMS, так и для аренды.

Вебхук

Входящий payload

Обязательный

Тело запроса с SMS, которое Onlinesim отправляет на ваш webhook URL

Content-Typeapplication/json
Схема
schemaobjectТело вебхука newSms (тот же объект — params в webhook-logs). Все поля присутствуют всегда.
webhook_typestringОбязательный
receiving_sms — приём SMS для одного сервиса, rent_sms — арендаПеречисление:receiving_smsrent_sms
operation_idintegerОбязательный
ID операции (tzid)Пример:91763432
user_idintegerОбязательный
ID Вашего профиляПример:100001
country_codeintegerОбязательный
Телефонный код страны номера, см. столбец Код списка стран. Для приёма SMS это может быть внутренний код специального пула номеров (например, 1000).Пример:7
numberstringОбязательный
Приём SMS: + и полный номер или hidden, если номер не показывается. Аренда: полный номер цифрами, без +.Пример:+79001234567
senderstringОбязательный
Имя или номер отправителя. Для приёма SMS вместо него может прийти код сервиса (например, vkcom).Пример:VK
messagestringОбязательный
Текст SMS. В аренде SMS от отправителя, которого сервис не принимает, заменяется текстом уведомления.Пример:VK: 195895 is your code
codestringОбязательный
Код подтверждения, найденный в тексте SMS; пустая строка, если код не найденПример:195895
time_startstringОбязательный
Приём SMS: время заказа операции. Аренда: время получения SMS. Формат YYYY-MM-DD HH:MM:SS.Пример:2026-04-26 12:37:55
time_leftintegerОбязательный
Оставшееся время операции: в секундах для приёма SMS, в минутах для арендыПример:880

Примеры

Incoming SMS

SMS операции приёма

{
  "user_id": 100001,
  "country_code": 7,
  "number": "+79001234567",
  "sender": "VK",
  "message": "VK: 195895 is your code",
  "time_start": "2026-04-26 12:37:55",
  "time_left": 880,
  "operation_id": 91763432,
  "webhook_type": "receiving_sms",
  "code": "195895"
}

Ответ вашего сервера

200Ответьте HTTP 200, чтобы подтвердить получение