Webhooks API SMS.online

Webhooks permitem receber notificações automaticamente quando uma SMS chega a um número virtual. Se a funcionalidade de Webhooks estiver ativada nas configurações do perfil, o sistema enviará para a URL que você especificou as informações sobre a SMS recebida através de uma requisição POST.

Após o envio do webhook, o servidor SMS.online aguarda uma resposta com o status HTTP 200 do seu script. Se o servidor não receber uma resposta com o código 200, a requisição não será reenviada. Nesse caso, é necessário solicitar manualmente o status de ativação do número.

Webhooks garantem a entrega automática de dados em tempo real e são adequados para integração com sistemas externos de monitoramento de mensagens.

Webhooks de ativação

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

Você pode ativar essa funcionalidade nas configurações do perfil.

Webhooks de aluguel

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

Importante: o webhook especificado nas configurações do perfil não é utilizado ao alugar números. Para aluguel, é necessário indicar o link do webhook como parâmetro uri ao criar a requisição. Isso permite gerenciar flexivelmente os endereços de recebimento de notificações para cada número alugado.