Webhooks API SMS.online

Los webhooks permiten recibir notificaciones automáticamente cuando llega un SMS a un número virtual. Si la funcionalidad de webhooks está habilitada en la configuración de tu perfil, el sistema enviará a la URL que indiques la información del SMS recibido mediante una solicitud POST.

Después de enviar el webhook, el servidor de SMS.online espera una respuesta con el estado HTTP 200 de tu script. Si el servidor no recibe una respuesta con el código 200, no se volverá a enviar la solicitud. En ese caso, deberás consultar manualmente el estado de activación del número.

Los webhooks garantizan la entrega automática de datos en tiempo real y son ideales para integrarse con sistemas externos de monitoreo de mensajes.

Webhooks de activación

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

Puedes habilitar esta funcionalidad en la configuración de tu perfil.

Webhooks de alquiler

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

Importante: el webhook indicado en la configuración del perfil no se utiliza al alquilar números. Para el alquiler, debes especificar el enlace del webhook como parámetro uri al crear la solicitud. Esto permite gestionar de manera flexible las direcciones de recepción de notificaciones para cada número alquilado.