FAQAPI

Вебхуки API SMS.online

Вебхуки (Webhooks) позволяют автоматически получать уведомления при поступлении SMS на виртуальный номер. Если функционал Webhooks включён в настройках профиля, система отправит на указанный вами URL информацию о полученном SMS с помощью POST-запроса.

После отправки вебхука сервер SMS.online ожидает ответ с HTTP-статусом 200 от вашего скрипта. Если сервер не получает ответ с кодом 200, повторная отправка запроса не выполняется. В таком случае необходимо вручную запросить статус активации номера.

Вебхуки обеспечивают автоматическую доставку данных в режиме реального времени и подходят для интеграции с внешними системами мониторинга сообщений.

Вебхуки активации

JSON
{
	"activationId": 123456,
	"service": "go",
	"text": "Sms text",
	"code": "12345",
	"country": 0,
	"receivedAt": "2025-01-01 12:00:00"
}

Вы можете включить данный функционал в настройках профиля.

Вебхуки аренды

JSON
{ 
  "rentId": 123456, 
  "sms" : { 
    "phoneFrom" => 79999999999
    "text" => "Sms text",
    "date" => "2025-01-01 12:00:00"
  } 
}

Важно: вебхук, указанный в настройках профиля, не используется при аренде номеров. Для аренды необходимо указывать ссылку на вебхук в качестве параметра uri при создании запроса. Это позволяет гибко управлять адресами получения уведомлений для каждого арендованного номера.