API para recibir SMS: códigos de verificación en números que son tuyos

BusySMS frente a los servicios de números virtuales

Cuándo usar cada uno

Si necesitas un número desechable para una prueba puntual y nada va a depender de él, un número virtual es el camino más rápido, y BusySMS no es la herramienta adecuada. Si la cuenta importa, como el acceso de administrador de tu empresa, una cuenta de pruebas en la que tu CI inicia sesión cada noche o el número que tus clientes ya conocen, recibe en un número que sea tuyo.

BusySMS tampoco es una forma de saltarse la verificación de nadie. Lee los códigos enviados a números que controlas, para cuentas que son tuyas. No puede leer los mensajes de otras personas y no está pensado para crear cuentas de forma masiva.

Cómo funciona la recepción con BusySMS

1. 1

   Instala el receptor en el teléfono

   En Android, la app de BusySMS de Google Play. En un iPhone, una automatización de Atajos, con o sin la app de BusySMS para iPhone.

2. 2

   Verifica el número

   BusySMS envía un código por SMS al número y el teléfono lo devuelve. Eso demuestra que la SIM tiene el número; hasta entonces no se guarda ni se factura nada.

3. 3

   Recibe

   Solo se guardan los mensajes que parecen códigos de verificación. Cada uno se etiqueta con el número que lo recibe, el remitente, el servicio detectado y la hora de llegada.

4. 4

   Lee

   Tu programa llama a la API REST, un agente de IA usa MCP, y una persona ve el código en el panel o deja que la extensión para Chrome lo escriba.

En qué números puedes recibir

• Cualquier número de una SIM en un teléfono que sea tuyo: un teléfono con Android 8.0 o posterior y la app de BusySMS, o un iPhone con iOS 14 o posterior mediante Atajos.
• Cada SIM de un teléfono doble SIM es un número distinto, que se verifica y se factura por separado.
• Los números se verifican con un SMS de ida y vuelta, así que no puedes añadir un número cuya SIM no tengas.

Recibe un código por la API

Crea una clave en el panel, en API REST, y guárdala en una variable de entorno. Después, espera el siguiente código en un número concreto:

# Digits only: the receiving number +44 7700 900123
curl -s -H "Authorization: Bearer $BUSYSMS_API_KEY" \
  "https://busysms.net/api/v1/codes?phone=447700900123&timeoutMs=60000"

const params = new URLSearchParams({ phone: "447700900123", timeoutMs: "60000" });
const res = await fetch(`https://busysms.net/api/v1/codes?${params}`, {
  headers: { Authorization: `Bearer ${process.env.BUSYSMS_API_KEY}` },
});
if (!res.ok) throw new Error(`BusySMS ${res.status}`);

const { code } = await res.json(); // null if nothing new arrived
console.log(code);

import os
import requests

r = requests.get(
    "https://busysms.net/api/v1/codes",
    params={"phone": "447700900123", "timeoutMs": 60000},
    headers={"Authorization": f"Bearer {os.environ['BUSYSMS_API_KEY']}"},
    timeout=75,
)
r.raise_for_status()
print(r.json()["code"])  # None if nothing new arrived

phone coincide con el número que recibe (basta con los dígitos), así que, con varios números en la cuenta, obtienes el código del número correcto. La espera dura hasta 90 segundos y devuelve null en lugar de un código anterior si no llega nada nuevo.

Para leer el historial en vez de esperar, lista los mensajes recientes de un teléfono con GET /api/v1/devices/:id/messages; los mensajes capturados se guardan hasta 7 días. Todos los endpoints y errores están en la guía de la API de pasarela SMS.

Qué se recibe y qué no

• Al configurarlo eliges, para cada SIM Android: todos los SMS o solo los mensajes de tipo verificación. Los demás mensajes solo puedes verlos tú.
• En un iPhone la comprobación se hace en el propio teléfono: un mensaje que no parece un código nunca sale de él.
• No se captura nada mientras la pasarela está apagada.
• Un número tiene que pasar la verificación antes de que se guarde nada de lo que recibe.

Dudas

Preguntas frecuentes