Webhooks API SMS.online

Los webhooks permiten recibir notificaciones automáticamente cuando se recibe un SMS en un número virtual. Si la funcionalidad de webhooks está activada en la configuración de su perfil, el sistema enviará a la URL que usted indique la información sobre el 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 su script. Si el servidor no recibe una respuesta con el código 200, no se reenvía la solicitud. En ese caso, es necesario solicitar 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

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

Puede activar esta funcionalidad en la configuración de su perfil.

Webhooks de alquiler

JSON
{ 
  "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, debe 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.