Cómo recibir SMS por API y webhooks
Activa el acceso a la API en tu perfil, genera un token y llama a la API con él. Para que los SMS entrantes se envíen a tu servidor, añade una URL de webhook en la misma pestaña.
Puedes leer tus mensajes y gestionar números desde tu propio código. Hay dos formas de recibir SMS nuevos: pedírselos a la API, o dejar que un webhook envíe cada uno a tu servidor en cuanto llega.
Obtener un token de API
Paso 2. Activa el acceso a la API
Cambia API access a Enabled. El mismo interruptor corta todo el acceso a la API si alguna vez lo necesitas.
Paso 3. Genera el token
Pulsa Generate token en Personal access token. El token se muestra una sola vez, así que cópialo y guárdalo en un lugar seguro. Regenerate token emite uno nuevo y revoca el anterior.
Paso 4. Llama a la API
Envía el token como Bearer token en la cabecera Authorization. La URL base y un ejemplo de curl listo para usar están en la misma pestaña.
Todas las llamadas, parámetros y respuestas están en la documentación de la API.
Recibir SMS con un webhook
Con un webhook enviamos una solicitud POST a tu servidor cuando ocurre algo, así no tienes que consultar la API continuamente. Cuando el acceso a la API está activado, debajo aparece una sección Webhooks en la misma pestaña.
Paso 1. Introduce tu URL
Rellena Webhook URL, una dirección de tu servidor que responda con un estado 2xx en menos de 10 segundos. Es mejor usar https, porque con http simple el texto de los SMS y los códigos viajan sin cifrar.
Paso 2. Elige los eventos
Escoge entre New SMS received, Number is online after wake-up, Rent renewed, Rent not renewed: not enough balance y Rent ended.
Paso 3. Crea y prueba
Pulsa Create webhook, comprueba que Send events esté activado y pulsa Send test event. El resultado y las últimas entregas aparecen en la página.
Cada solicitud va firmada con tu Signing secret, así que comprueba la firma por tu parte. Las entregas fallidas se reintentan durante varias horas.
Preguntas sobre el tema
En Profile, en la pestaña API. Después de generar el token se muestra una sola vez. Si la perdiste, pulsa Regenerate token.
No. Puedes consultar la API en su lugar. Los webhooks solo te ahorran esas consultas.
Si tu servidor no responde repetidamente, las entregas se desactivan. Arregla el endpoint, activa Send events y guarda.
No. Lee mensajes y gestiona números. El envío no se ofrece.