SMS-ACTIVATE
Browser
- Cómo funciona Webhook
- Cómo empezar a utilizar Webhook
Hemos mejorado Webhook, así que es el momento perfecto para recordar que, al usar la API, Webhook te ayudará a acelerar mucho tu trabajo. Esto se aplica tanto a las activaciones como a los alquileres.
Webhook es un mecanismo de integración moderno y cómodo que optimiza el uso de nuestra API. En el contexto de la activación por SMS, Webhook se utiliza para transferir automáticamente el contenido de los SMS entrantes a la dirección URL que usted indique. En pocas palabras, permite transferir información desde nuestro servidor al suyo mediante una solicitud POST.
¿Cómo se realiza una solicitud de SMSsin Webhook en el caso de la activación?：
- En su lado se genera una solicitud para recibir un SMS;
- La solicitud se envía constantemente hasta que se recibe el SMS. La frecuencia de las solicitudes la configura el usuario, pero en cualquier caso, usted consume el límite de RPS o pierde tiempo innecesariamente. Al alcanzar el límite, los registros se detienen (= inactividad).
Cómo funciona Webhook
Activación:
- El usuario configura la dirección a la que se enviarán los webhooks;
- Se realiza la compra del número;
- Tras recibir un SMS en el número, el usuario recibe un código en su dirección — sin necesidad de realizar ninguna acción adicional por su parte;
- Su servidor debe responder con el código HTTP 200 para confirmar que se han recibido los datos correctamente.
Alquiler:
El mismo algoritmo, con una pequeña diferencia: el cliente transmite explícitamente la dirección cada vez que compra un número.
Respuesta:
{
"rentId": "26251422",
"sms": {
"phoneFrom": "SPORTMASTER",
"text": "Код для регистрации в Спортмастер 2792",
"date": "2025-06-17 16:01:10"
}
}
¿Cuál es la ventaja?
Usted no envía una solicitud, sino que recibe una solicitud POST. De este modo, no se consumen RPS.
Cómo empezar a utilizar Webhook
Si utiliza un software propio para el registro o un bot:
- Obtenga las direcciones URL para el webhook: cree un servidor que reciba solicitudes HTTP. Puede ser su propio servidor o un servicio que ofrezca la posibilidad de recibir webhooks.
-
Active los webhooks en su cuenta de SMS-Activate: en la esquina
superior derecha del sitio web, haga clic en «Perfil»,
desplácese hasta «Direcciones de webhook de activación» y haga
clic en «Direcciones de webhook de activación». Introduzca la
dirección.
Su servidor debe estar configurado para procesar solicitudes POST entrantes. Un ejemplo de los datos que recibirá podría ser el siguiente:
{
"activationId": 123456,
"service": "go",
"text": "Sms text",
"code": "12345",
"country": 0,
"receivedAt": "2023-01-01 12:00:00"
}
Presta atención a los campos:
- activationId: identificador de activación al que llegó el SMS.
- text: texto del SMS recibido.
- receivedAt: hora de recepción del SMS en formato YYYY-MM-DD HH:mm:ss
- code: código del SMS.
- service: servicio de activación.
- country: país de activación.
Si utiliza software de terceros, solicite la adición del webhook SMS-Activate. El trabajo será más rápido.
Cualquier pregunta relacionada con la integración a través de la API será respondida por un empleado de nuestro servicio de asistencia técnica especialmente capacitado.
