Вебхуки API SMS.online

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

Після відправки вебхука сервер SMS.online очікує відповідь з HTTP-статусом 200 від вашого скрипта. Якщо сервер не отримує відповідь з кодом 200, повторна відправка запиту не виконується. У такому випадку потрібно вручну запитати статус активації номера.

Вебхуки забезпечують автоматичну доставку даних у реальному часі та підходять для інтеграції з зовнішніми системами моніторингу повідомлень.

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

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

Ви можете увімкнути цю функцію в налаштуваннях профілю.

Вебхуки оренди

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

Важливо: вебхук, вказаний у налаштуваннях профілю, не використовується при оренді номерів. Для оренди потрібно вказувати посилання на вебхук як параметр uri під час створення запиту. Це дозволяє гнучко керувати адресами отримання сповіщень для кожного орендованого номера.